Dwarf Fortress Wiki - User contributions [en]

Modding

2026-01-27T11:05:05Z

Putnam3145: /* Basics of DF modding */

{{Quality|Fine}}
{{av}}
{{For/see|a list of Dwarf Fortress mods|[[List of mods]]}}
{{Modding}}
'''Modding''', or creating [[mod]]s, refers to modifying the behavior of the base game (vanilla). ''Dwarf Fortress'' is remarkably moddable.

== Resource Overview==
[[File:modding_icon.png|120px|right]]This section serves as a portal to all modding-related pages on the wiki.

; Using Mods:
* [[Mod#Downloading mods|Downloading mods]]
* [[Mod#Enabling/installing mods|Enabling mods in-game]]

; Guides and references:
* [[Modding guide|DF RAWs modding guide]]
* [[Modding pitfalls]] for troubleshooting

* [[Mod#Mod format|Mod format]] and [[Game folders and files]]
* [https://github.com/Putnam3145/DF-Raws/tree/master Official DFRaws repository] and [https://github.com/DF-Wiki/DFRawFunctions Wiki mirror]
* [[Mod#Publishing on Steam Workshop|Publish on Steam Workshop]]
* [[Character table]]
* [[String dump]]

* [https://github.com/Putnam3145/Dwarf-Fortress--libgraphics-- Source code for Dwarf Fortress's graphics/input/sound]
* [https://docs.dfhack.org/en/latest/docs/guides/modding-guide.html#dfhack-modding-guide DFHack modding guide]
* [[Memory hacking]], [[Main:Offset Finding Methods|Offset Finding Methods]]

; Where to get help?
* The official [http://www.bay12forums.com/smf/index.php?board=13.0 modding subforum] on the [[Bay 12 Forums]].
* [https://discord.com/channels/329272032778780672/629902895138996264 #modding-discussion] and [https://discord.com/channels/329272032778780672/1069640085718450218 #modding-technical] channels on [[Kitfox Games]]' Discord.
* [https://docs.dfhack.org/en/stable/docs/Introduction.html#getting-help DFHack questions]

; Modding tools
* There are several specialized [[Utilities#Modding tools|utilities]] that assist in modding efforts. There is [http://www.bay12forums.com/smf/index.php?topic=28829.0 a longer list of them] on the [[Bay 12 Forums]].
:*[https://putnam3145.github.io/helper Material Helper] by [[User:Putnam3145]], for calculating [[Material definition token|material properties]].
:*[https://jose96xd.github.io/DF_Tools/index.html DF Tools] by [[User:Jose96xd]], a collection of web tools.
:*[https://dffd.bay12games.com/file.php?id=1738 DFLang] (by Igfig) and [https://dffd.bay12games.com/file.php?id=7174 LangCreate] (by Talvieno) for generating [[Language token|translations]].
:*[http://www.bay12forums.com/smf/index.php?topic=158930.0 Dwarf Portrait] by Rose, for visualizing unit [[Body token|bodies]].
* Text editors are used in all areas of modding. Use a good text editor to edit files and search into multiple files (like the free [https://notepad-plus-plus.org/ Notepad++] for example) or more advanced editors capable of highlighting and formatting the displayed text (like [[Utilities#DF RAW Language server|DF RAW Language server]])
* Image editors are needed for doing custom graphics. [https://www.getpaint.net/ Paint.NET], Photoshop and GIMP are the most used, but whatever supports the .png format will work.

=== Documentation===
; [[Raw file]]s

These object files, stored in <code>/data/vanilla/*/objects/</code>, define various specifics of game items, materials, and creatures, and can be changed using mods to alter how the game behaves. These are text based and can be edited with any text editor, however, editing the vanilla raw files is now discouraged.

See [[Token|Token reference]] - It's always good to refer to tokens on the wiki. Even experienced modders have to look up tokens! A list of articles about tokens can be found here.

; [[Graphics|Graphics files]]:

The `/data/art/` subfolder of Dwarf Fortress is used to store user-customizable [[tileset]]s while mods can include their own [[Graphics#Premium Graphics|graphics files]].

; [[Reaction]]s:

; [[Language token|Language]] and [[Speech file]]:

; [[Audio|Sound and Music files]]:

All sound and music files used by ''Dwarf Fortress'' are stored in the [https://en.wikipedia.org/wiki/Ogg .ogg] format within the <code>/data/sound/</code> subfolders. Mods can load new audio files. You can also change some of the definitions of when certain musical cues are played, using available [[music token]]s and [[sound token]]s in the raw files.

An example mod by [[User:Putnam3145]] is available on [https://github.com/Putnam3145/dwarf-fortress-example-sound-mod Github].

; [[Lua scripting]]:

An experimental feature used for procedural generation.

=== Best practice ===
The current best practice is to not modify the original raw files, since most modifications can be made via mods. Mods can add new objects, add tokens to existing objects, and cut objects entirely. You should prefer ``SELECT`` over ``CUT``, and prefer ``CUT`` over unloading ([[Mod info token|conflicting with]]) vanilla raws.

== Guide ==
This is intended to be a guide to inform those new to ''Dwarf Fortress'' modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of editing creatures, entities, materials ''et al'', and creating their own.

Generally, breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on [[40d:Modding guide|Teldin's guide]], originally created for version 0.27.176.39c. Per wiki tradition, it has been updated through all the major releases since then; hopefully it reflects current knowledge.

=== Token reference ===
It's always good to refer to tokens on the wiki. Even experienced modders have to look up tokens! A list of articles about tokens can be found [[Token|here]].

=== Basics of DF modding ===
To make a mod, one must put a folder into the <code>/mods/</code> directory in the game's AppData [[File|folder]] or the portable directory. When a mod is first installed, it is copied to <code>/data/installed_mods/</code> and the game loads all data from the installed copy. Changes are NOT immediately propagated from <code>/mods/</code> to <code>/data/installed_mods/</code>. You can create a new installed copy by deleting the old copy or by incrementing the [[Mod info token|version info]] - see [[modding pitfalls]] for more information. The vast majority of modifications to the game can be done via this method.

Your mod folder must contain a file named "info.txt" and subfolders depending on what your mod includes. The majority of mods will want to have an ``objects/`` folder, which can define most kinds of [[Raw file|game content]], and a ``graphics/`` folder, to add [[graphics]].

[[File:Folder-orange.svg|20px|link=]] Mod Name
├ [[File:Folder.svg|20px|link=]] [[Graphics|graphics]]
├ [[File:Folder.svg|20px|link=]] [[Raw file|objects]]
├ [[File:Folder.svg|20px|link=]] [[Lua scripting|scripts]]
├ &emsp;[[File:Lua-Logo.svg|20px|link=]] init.lua
├ [[File:Folder.svg|20px|link=]] [[Audio|sound]]
├ [[File:Text-x-generic.svg|20px|link=]] [[info.txt]]
└ [[File:Picture icon.png|20px|link=]] preview.png

The [[info.txt]] is formatted like so:

{{code|
[ID:my_first_mod]
[NUMERIC_VERSION:1]
[DISPLAYED_VERSION:1.0.0]
[EARLIEST_COMPATIBLE_NUMERIC_VERSION:1]
[EARLIEST_COMPATIBLE_DISPLAYED_VERSION:1.0.0]
[AUTHOR:Your Name Here]
[NAME:My First Mod]
[DESCRIPTION:A cool mod I made!]
}}

A mod should have all of these. There are a [[mod info token|few more tokens]], but the above are the important ones.

Most of the game's vanilla content is in the same format as mods. Many text files can be found in the subfolders of the <code>/data/vanilla</code> folder - these are the [[raw file|raw files]], and using them as a basis for modification is quite easy. For now, we will take a look at one of the existing files. For example, if you open <code>/data/vanilla/vanilla_creatures/objects/creature_standard.txt</code>, it should look something like this:

{{code|
creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...
}}

As you can see, each file comprises a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file will be ignored by the game.

'''In other words, to be recognized by the game, a raw file must have all of the following:'''

# A filename that refers to the type of objects contained therein. '''Creature files must start with creature_, entity files must start with entity_, and so on.'''
# The filename on the first line of the file.
# ``[OBJECT:type]``, where "type" is replaced with the relevant object type.

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, ``[CREATURE:DWARF]``), again stating the type of object, and then the object's unique identifier - if an identifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. ([[Duplicated raws|For example...]]) Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the {{token|CARNIVOROUS}} token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Try to avoid modifying the existing raw files when possible. You should make a mod instead!
* When adding files, token identifiers are all you need to include to ensure proper references are maintained. The game searches through all loaded raw files by tokens.
** For example, you can add a new pair of leather boots and not even have to add it to a file named ``item_shoes.txt``, but rather your own file, say ``item_shoes_new.txt``.
** All objects must have a unique token identifier. Adding a consistent prefix or suffix to your mod's objects (ie: ``[ITEM_SHOES:ITEM_SHOES_BOOTS_NEW]``) greatly reduces the chance that another mod uses the same token. If two mods define objects with the same token without cutting the other, then they will be incompatible due to [[duplicated raws]].
* When a new world is generated, the mods included are "baked in" and cannot be modified except to be updated—for this, the game checks that the mod used by the save is of a compatible {{token|NUMERIC_VERSION|modinfo}}.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities.
* '''Check the errorlog.txt in the game's base folder whenever you load the mod'''. Many problems show up in there, and it's bad form to publish a mod with errors.

=== Modifying the vanilla objects ===

You should not modify the vanilla raws where they originally are if you can help it. Instead, patch them using the patching functions provided with ''Dwarf Fortress'' since v50.01.

There are two patching functions: ``SELECT`` and ``CUT``. When ``SELECT`` is used, it lets you make changes to an object without needing the entire entry to be present in your mod file. When ``CUT`` is used, it forces the game to not use that object, even though it is still found in the vanilla raws (or in any other mods earlier in the load order). Both of these functions take the form of tokens. These functions are not universally applicable to any token found in any entry, just the following list of base objects:

* [[Creature token|CREATURE]]
* [[Entity token|ENTITY]]
* [[Interaction token|INTERACTION]]
* [[Item definition token|ITEM]]
* [[Language token|WORD, TRANSLATION, SYMBOL]]
* [[Inorganic material definition token|INORGANIC]]
* [[Plant token|PLANT]]
* [[Audio|MUSIC, SOUND]]
* [[Reaction token|REACTION]]

The syntax required for these functions is: ``[<function>_<object>:<specific object being affected>]``. For instance, ``[CUT_PLANT:MUSHROOM_HELMET_PLUMP]`` cuts the plump helmet object originally defined in the vanilla file ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/plant_standard.txt plant_standard.txt]``, so the game will not use that object at all. However, ``[SELECT_ITEM_HELM:ITEM_HELM_HELM]`` does not select the helm object from the vanilla file ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/item_helm.txt item_helm.txt]``, even though that's how the object appears in that file, because there is no ``[SELECT_ITEM_HELM]`` token. Instead, the helm would be selected with ``[SELECT_ITEM:ITEM_HELM_HELM]``.

For example, if you wanted to mod beards onto dwarven women while also removing elephants from the game:

{{code|
creature_mypatch

[OBJECT:CREATURE]

[SELECT_CREATURE:DWARF] starts editing DWARF from the end of the entry
[SELECT_CASTE:FEMALE]
[BODY_DETAIL_PLAN:FACIAL_HAIR_TISSUE_LAYERS]

[CUT_CREATURE:ELEPHANT] removes the ELEPHANT creature
}}

Or, say, add your own reaction and building to dwarves:

{{code|
entity_mypatch

[OBJECT:ENTITY]

[SELECT_ENTITY:MOUNTAIN]
[PERMITTED_REACTION:MY_REACTION]
[PERMITTED_BUILDING:MY_BUILDING]
}}

And in any of these, one can add the token ``[LOG_CURRENT_ENTRY]`` somewhere under one of the objects of the file, which logs the full contents of the object in question to ``logs\current_entry.txt``. This can be useful to make sure that the patch is doing what you think it is. For instance if ``[LOG_CURRENT_ENTRY]`` were added on the next line after ``[CREATURE:DWARF]`` in your mod file, then the dwarf object would be the object detailed in the log entry.

Note that it is not possible to remove an existing token from most objects using ``SELECT`` or ``CUT`` alone. Creatures can make use of {{token|CV_REMOVE_TAG|cv}}; for other objects, it is currently necessary to ``CUT`` the entire object and redefine it.

...Speaking of, let's move on to modifying and adding entities.

=== Modding civilizations (entities) ===

Entities - the objects that determine how civilizations work - are stored in <code>[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/entity_default.txt vanilla_entities/objects/entity_default.txt]</code> (though, like all other files, you may add more). They follow the same format as any other raw file:

{{code|
entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQUENCY]
...[OTHER TAGS]...
}}

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the ``[ENTITY:]`` identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

{{token|CREATURE|e}} links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and, therefore, the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the {{token|CREATURE|e|DWARF}} entry in ``entity_default.txt`` with {{token|CREATURE|e|ELF}} and you would be marching elves around in fortress mode, although they would still use dwarven technology, [[Dwarven language|language]] and [[name]]s and so forth. Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect; it will pick only one of the defined creatures at random to use for the civ. Later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with us until then.

{{token|TRANSLATION|e}} defines the language file that the entity will be using, which will determine what their native words are for things. This doesn't determine which words they use for naming things, only the way those words are spelled. The default language files are ``HUMAN``, ``DWARF``, ``ELF``, and ``GOBLIN``, as well as the generated ``GEN_DIVINE`` and ``GEN_IDENTITY``.{{version|51.06-Lua}}

{{token|BIOME_SUPPORT|e}} defines the [[Biome token|biomes]] that civs will attempt to settle in. The ``FREQUENCY`` value determines the likelihood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If one were to type:

{{code|
[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]
}}

This would have very much the same effect as:

{{code|
[BIOME_SUPPORT:ANY_FOREST:5]
[BIOME_SUPPORT:SAVANNA:10]
}}

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials. For more information, see [[entity token]]s.

Besides those mentioned, some fundamental ones are the {{token|SITE_CONTROLLABLE|e}} token, which lets you control the civ in fortress mode, and the {{token|ALL_MAIN_POPS_CONTROLLABLE|e}} token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are {{token|START_BIOME|e}} and the ones regarding sites, but in general, you can just run through the aforementioned list and add or remove what you want.

Also see the creature-level {{token|OUTSIDER_CONTROLLABLE}} token, which allows you to play in adventure mode as an outsider.

By default, the game chooses a {{token|SITE_CONTROLLABLE|e}} civ (and therefore a species if there is more than one) at random when starting a fortress mode game. The group selection section on the embark screen lists all available civs and their primary creature.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of [[Language#language_SYM|symbols]], collections of words centered around a specific concept. The civ will use words from whatever symbols are selected for it for various things. This association might be a little confusing at first, so, let's refer to the "MOUNTAIN" entity:

{{code|
[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]
}}

Here, we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then, after words in the "[[language_SYM.txt/Violent|VIOLENT]]" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of [[language_SYM.txt/Violent|VIOLENT]] with, say, [[language_SYM.txt/Peace|PEACE]] and end up with a battle called "The Clash of Calm" or something.

{{code|
[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]
}}

The above applies here. Dwarves are fond of naming their roads and tunnels after... roads and tunnels.

{{code|
[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]
}}

This section deals with everything else. The things that haven't already been dealt with (hence the ``REMAINING``) - such as site names, kingdom names, the names of individuals, and such - will have names from the [[language_SYM.txt/Artifice|ARTIFICE]] and [[language_SYM.txt/Peace|PEACE]] symbol groups. After that, the dwarf entity is told to cull all inappropriate symbols - this applies to everything (hence the ``ALL``) so if the game happens to choose a symbol associated with, say, [[language_SYM.txt/Evil|EVIL]] for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's perceived personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of an entity file and edit things to your liking. Remember to always change the civ's ``[ENTITY:]`` identifier! This can be anything, so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found [[position token|here]]; they don't require a great deal of explanation, but that can be found in [[Advanced Entity Position Mechanics]].

==== Trade ====
The following [[entity token]]s affect the appearance of [[trading]] [[caravan]]s:

* {{token|ACTIVE_SEASON|e}} - Defines the seasons when an entity may visit your fortress.
* ``[[Entity token#PROGRESS_TRIGGER_POPULATION|[PROGRESS_TRIGGER_*]]]`` - Defines the triggers which control when an entity will become interested in your fortress.
* {{token|COMMON_DOMESTIC_PACK|e}} - Allows the civilization to use domestic pack animals. If an entity lacks pack animals (or ability to pull wagons), it will be unable to send caravans (showing as {{DFtext|No Trade|6:1}} at the [[embark]] screen), unless it has domesticated any suitable animal species or is forced to use a non-suitable creature by the {{token|ANIMAL|e}} definition {{token|ALWAYS_WAGON_PULLER|e}} on creature, caste or class.
* {{token|COMMON_DOMESTIC_PULL|e}} - Allows the civilization to use domestic animals to pull [[wagon]]s, assuming their ``[[Ethic#KILL_PLANT|[ETHIC:KILL_PLANT]]]`` permits them to use wagons in the first place.
* {{token|MERCHANT_BODYGUARDS|e}} - Caravan will be guarded by [[soldier]]s.

=== Modding creatures ===

Creature modding is great fun – you can change nearly any aspect of a creature, or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's ``[CREATURE:]`` header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens [[creature token|here]]. But before you start creating your own creatures, you'll want to learn how the tissues system works.

==== Creature materials and tissues ====

In the most basic sense, a creature is a series of body parts. These parts are defined in their own file, and we'll talk about them later, as a specific aspect of how creatures work, which throws off a lot of prospective modders, is the relationship between body parts, tissues, and materials. We're going to show you part of the [[bronze colossus/raw|creature entry]] for a [[bronze colossus]] (bear with us):

{{code|
...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...
}}

At the top, we can see the {{token|BODY}} token, followed by a list of body parts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues, and those tissues also have to be made out of something - in this case, bronze.

Below the {{token|BODY}} token you'll see a {{token|TISSUE}} token, followed by an identifier, much like the others we've seen. The {{token|TISSUE}} block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the {{token|MUSCULAR|tissue}}, {{token|FUNCTIONAL|tissue}} and {{token|STRUCTURAL|tissue}} tokens. The tissue also references a material - ``[INORGANIC:BRONZE]`` - the properties of which are declared in the [[Inorganic material definition token|inorganic materials]] file ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/inorganic_metal.txt inorganic_metal.txt]``, and the tissue is subsequently made out of this material. With us so far?

Below the tissue definition is the {{token|TISSUE_LAYER}} line. {{token|TISSUE_LAYER}} allows you to control where each tissue is applied. Its first argument defines if it's to search by body part category (``BY_CATEGORY``), body part type (``BY_TYPE``), or look for a specific part (``BY_TOKEN``). That's followed by the parts argument itself, which is in this case ``ALL`` (so the game's looking for parts in all categories, which is to say, every body part). This is followed by the tissue to be applied, "BRONZE". So the {{token|TISSUE_LAYER}} token is telling the game to select all body parts in every category and make them out of the tissue "BRONZE". The colossus is now made of [[bronze]].

By now, you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded!" and you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

{{code|
[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
}}

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

{{code|
...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...
}}

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

{{code|
...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...
}}

This is where [[Body detail plan token|body detail plans]], which have their own file, and are designed to help automate some of the more common processes in creature creation, come in. The first entry in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/b_detail_plan_default.txt b_detail_plan_default.txt]`` does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

{{code|
...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...
}}

Much easier. But what about the {{token|TISSUE_LAYER}} tokens? Will we have to type out all of those manually? Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

{{code|
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...
}}

First, an argument is placed in the plan (``ARG1``, ``ARG2`` etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the "VERTEBRATE_TISSUE_LAYERS" plan, we'll be able to do something like this:

{{code|
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
}}

``ARG1`` in the detail plan is replaced by "SKIN", the first tissue we entered. ``ARG2`` is replaced by "FAT", ``ARG3`` by "MUSCLE", ``ARG4`` by "BONE", and ``ARG5`` by "CARTILAGE". Hence, our creature's body part designated as {{token|CATEGORY|body|BODY}} is made up of "SKIN" with thickness 1, "FAT" with thickness 5, and "MUSCLE" with thickness 50. Its nose is made up of "SKIN" (thickness 1) and "CARTILAGE" (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

{{code|
...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...
}}

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there are detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say we wanted our dwarves to be perpetually on fire (don't ask). We leave the body stuff declared normally:

{{code|
...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...
}}

We then, in our own mod, select the appropriate material:

{{code|
[SELECT_CREATURE:DWARF]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...
}}

We don't want them burning to death, so we'll need to stop that from happening:

{{code|
[SELECT_CREATURE:DWARF]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...
}}

Note that this makes use of DF's built-in temperature scale - you can read more about that [[Temperature|on this page]]. We're also referencing [[material definition token]]s, which we haven't gone over yet - we'll talk about making your own materials later.

==== Creature castes ====

Another potentially extremely powerful part of the creature raws, is the '''caste system.''' The caste system handles both true biological castes and lesser variations, such as sexes.

To understand the true potential of the caste system, we only need to take a look at the raws for antmen, found in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/creature_subterranean.txt creature_subterrenean.txt]``:

{{code|
...
[CASTE:WORKER]
[CASTE_NAME:worker ant woman:worker ant women:worker ant woman]
Female, but non-breeding.
[POP_RATIO:10000]
[CASTE:SOLDIER]
[CASTE_NAME:soldier ant woman:soldier ant women:soldier ant woman]
Female, but non-breeding.
[POP_RATIO:1000]
[CASTE:DRONE]
[MALE]
[CASTE_NAME:drone ant man:drone ant men:drone ant man]
[POP_RATIO:5]
[CASTE:QUEEN]
[FEMALE]
[CASTE_NAME:queen ant woman:queen ant women:queen ant woman]
[POP_RATIO:1]
[SELECT_CASTE:WORKER]
[SELECT_ADDITIONAL_CASTE:SOLDIER]
[SELECT_ADDITIONAL_CASTE:QUEEN]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[SELECT_CASTE:DRONE]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH:2WINGS]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[FLIER]
[SELECT_CASTE:ALL]
[BODY_DETAIL_PLAN:CHITIN_MATERIALS]
[BODY_DETAIL_PLAN:CHITIN_TISSUES]
[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:CHITIN:FAT:MUSCLE]
[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS]
[ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP]
[ATTACK_SKILL:GRASP_STRIKE]
[ATTACK_VERB:punch:punches]
...
}}

It's evident that the process of creating and editing castes is comparable to the modifications we were making to tissues and materials earlier: A caste is declared, and modifications to the base creature are made. Declared castes can be selected and subsequently modified, again, just like tissues and materials.

In this case, each caste is declared, given its own name, and a {{token|POP_RATIO}}, which determines how commonly a birth results in that caste - for every 10000 workers born, there'll be an average of 1000 soldiers, 5 drones and one queen. You've probably also noticed that the "DRONE" and "QUEEN" castes have the {{token|MALE}} and {{token|FEMALE}} tokens respectively - these tokens determine how breeding works. A creature without both a {{token|MALE}} caste and a {{token|FEMALE}} caste will be unable to breed (no asexually reproducing creatures yet, unfortunately). As they lack {{token|FEMALE}}, the workers and soldiers are unable to breed with the male drones.

After this, there are some modifications to bodyparts. In this case, the drones have wings and the {{token|FLIER}} token, which the other castes lack. It's entirely possible for creatures of different castes to have completely different body structures, even to the extent that they don't resemble each other at all. If you read the section of this guide that dealt with entities, you may remember a passing mention of multi-creature civilisations and how they don't quite work as you may think they would. The castes system is your workaround. You could create a caste that is, for all intents and purposes, a human, and another caste of the same creature that acts exactly like a giant cave spider, put the creature in a civ, and get a human-spider civ. The only flaw in this approach is that the castes will interbreed and produce offspring of either caste.

That's the most complex components of creature creation out of the way. You should find the rest trivial by comparison.

=== Modding items ===

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, [[Item definition token]]s don't seem to be especially well-documented (at least not as well as the other object types), but you should be able to figure out most things by way of our explanations and your assumptions.

Let's look at the entry for, of course, the thong:

{{code|
[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]
}}

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add {{token|METAL|armor}} to it somewhere. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

{{code|
[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]
[ATTACK_PREPARE_AND_RECOVER:3:3]
}}

{{token|SIZE|wp}} determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. {{token|SKILL|wp}} determines which skill is used in using the weapon; a list of skills can be found [[skill token|on this page]]. {{token|MINIMUM_SIZE|wp}} determines the minimum size a creature must be before the weapon can be wielded, while {{token|TWO_HANDED|wp}} determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explanation. The first value determines the contact area of the weapon's attack; this should be high for slashing weapons and low for bludgeoning, piercing and poking ones. The second value determines how deep the weapon penetrates - for ``BLUNT`` attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of ``EDGE`` attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the nouns and verb used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat. But more accurate it describe distribution of momentum across length of weapon. So "STAB" perfomed with only muscular power and modifier is x1 (1000). "SLASH" performed with some rotating momentum of cutting edge, but sword is pretty balanced thru it's length and modifier is just x1.25 (1250). Axes, hammers and maces have more unbalanced mass distribution and weapon mass concentrated far from grasp, so higher modifiers.

{{token|ATTACK_PREPARE_AND_RECOVER|weapon}} determines number of game frames to perform these actions. In vanilla, all attacks except [[whip|lashing]] use 3:3.

Other, more miscellaneous items are generally simple and shouldn't require any further explanation.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

=== Modding language files ===
{{main|Language token}}

Let's say you added a whole new species. Sure, you could just swipe one of the existing translation files and steal their language for your species, but that's the lazy way! If you want to create a whole new language, it is very simple.

First, you'd need a whole new "language_NAME.txt" file, such as "language_LIZARDMAN.txt", along with "language_LIZARDMAN" at the top of the file, followed by ``[OBJECT:LANGUAGE]`` and ``[TRANSLATION:LIZARDMAN]``. After that, it's just a matter of copy-pasting one of the existing language lists and editing the finished 'translated' word. That's it! Then just add the translation link to your civ in entity_default.txt and it'll be added to the game on worldgen.

All raw files use [[Character table|Code Page 437]] encoding, and you should make sure you are editing these files in that format. As many text editors default to UTF-8, some characters with diacritical marks may fail to show properly. Saving one of the default language raw files in this state will overwrite these characters with the Unicode question mark, which will corrupt the file. To fix this replace the file with a clean one downloaded from the distributed version of DF.

(Note that the name of the file doesn't actually matter; but it's typical to name the file after a creature if it's exclusive to their civilization.)

=== Modding body parts ===

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/body_default.txt body_default.txt]`` and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each body part will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a body part definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the, very simple, format:

{{code|
[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]
}}

The most important tokens are {{token|CONTYPE|body}} and {{token|CON|body}}: {{token|CONTYPE|body}} means the body part in question is connected to a certain ''type'' of body part, while {{token|CON|body}} means it's connected to a ''specific'' one. "TOKENID" is yet another identifier, which should be unique, as it's referenced every time something uses {{token|CON|body}} or ``BY_TOKEN``. {{token|DEFAULT_RELSIZE|body}} defines, of course, what the body part's size is in relation to the other parts. {{token|CATEGORY|body}} defines a category for the part, which can be unique or shared with other parts. This is referenced whenever ``BY_CATEGORY`` is used.

A list of body part tokens can be found [[body token|here]].

Let's take a simple example, a head:

{{code|
[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
}}

It connects directly to an upper body.

{{code|
[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
}}

These are a pair of eyes, connecting to the head.

{{code|
[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
}}

An entire humanoid body. The foot bone's connected to the ankle bone...

``[[Bodygloss|[BODYGLOSS]]]`` entries, which you can sometimes find applied to creature entries, are simply replacement words for specific part name strings in a creature. For example, you'll find the bodygloss definition ``[BODYGLOSS:CLAW_HAND:hand:claw]`` in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/body_default.txt body_default.txt]``; you can then use this in a creature via ``[BODYGLOSS:CLAW_HAND]`` and it'll replace all instances of "hand" with "claw" in that creature. Be warned, however—if you were to, say make a bodygloss ``[BODYGLOSS:EARSTALK:ear:stalk:ears:stalk]``, it would not only change "ear" and "ears" to "stalk" and "stalks", it would also change "h'''ear'''t" to "h'''stalk'''t"! For all intents and purposes the body part will still function as the proper part, though.

=== Modding plants ===

Plants are, again, not unlike creatures. With what you've learned so far in regard to tokens and the materials system, running through the notes included in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/plant_standard.txt plant_standard.txt]`` should explain most things. Here's the list of [[Plant token]]s.

Below is the [[plump helmet]] raw description:

{{code|
[PLANT:MUSHROOM_HELMET_PLUMP]
[NAME:plump helmet][NAME_PLURAL:plump helmets][ADJ:plump helmet]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PICKED_TILE:6][PICKED_COLOR:5:0:0]
[GROWDUR:300][VALUE:2]
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen dwarven wine]
[STATE_NAME_ADJ:LIQUID:dwarven wine]
[STATE_NAME_ADJ:GAS:boiling dwarven wine]
[STATE_COLOR:ALL:AMETHYST]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:5:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]

[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[EDIBLE_COOKED]
[SEED:plump helmet spawn:plump helmet spawn:4:0:1:LOCAL_PLANT_MAT:SEED]
[SPRING][SUMMER][AUTUMN][WINTER]
[FREQUENCY:100]
[CLUSTERSIZE:5]
[PREFSTRING:rounded tops]
[WET][DRY]
[BIOME:SUBTERRANEAN_WATER]
[UNDERGROUND_DEPTH:1:3]
[SHRUB_TILE:58]
[DEAD_SHRUB_TILE:58]
[SHRUB_COLOR:5:0:0]
[DEAD_SHRUB_COLOR:0:0:1]
}}

Let's look at this line by line: 
First, we define its file name. In this case it's "MUSHROOM_HELMET_PLUMP". Next we define its in-game name, "plump helmet" and its adjective for if you were to craft with its materials (e.g. {{DFtext|plump helmet plant earrings}}).

{{code|
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
}}

This defines the structure and material of the plant. It references "STRUCTURAL_PLANT_TEMPLATE" in the first line, so if you were to say, add wings to the template, the plump helmet plant would be winged. This is for the plant itself, not the end plump helmets.

After that we get our edible tokens. These say that [[vermin]] can eat the plant, and it can be eaten raw or cooked by your dwarves. So if you wanted a plant that vermin would leave alone, you'd remove the {{token|EDIBLE_VERMIN|md}} token.

{{code|
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
}}

Next, {{token|PICKED_TILE|p|6}} is the character (6, or ♠) shown when the crop is harvested. See [[Main:Character table|character table]] for a table of usable tiles. {{token|PICKED_COLOR|p|5:0:0}} is the [[color]] used for the crop's tile when harvested. It's in a ``<foreground>:<background>:<brightness>`` format, resulting in a purple spade: {{Tile|♠|5:0}}

{{code|
[PICKED_TILE:6][PICKED_COLOR:5:0:0]
}}

{{token|GROWDUR|p|300}} is how long it takes for your crop to grow. There are 1008 growdur units in a [[Time|season]]. You can calculate this value [https://jose96xd.github.io/DF_Tools/Modules/TimeConverter.html here]. 
{{token|VALUE|p|2}} is the [[item value]] of the harvested plant (default 1).

{{code|
[GROWDUR:300][VALUE:2]
}}

This defines the plant's alcohol states. {{token|STATE_NAME_ADJ|ALL_SOLID|md}} is the frozen name, followed is the actual drink name, and then its boiling name. Drinks can evaporate and freeze in Scorching or Freezing [[Temperature|climates]], respectively.

{{token|DISPLAY_COLOR|md}} is ASCII color, and {{token|STATE_COLOR|md}} is a [[Color#Color tokens|named color]] linked to a graphical [[palette]].

{{token|EDIBLE_RAW|md}} and {{token|EDIBLE_COOKED|md}} are saying you can drink the alcohol raw or cooked.

{{code|
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen dwarven wine]
[STATE_NAME_ADJ:LIQUID:dwarven wine]
[STATE_NAME_ADJ:GAS:boiling dwarven wine]
[STATE_COLOR:ALL:AMETHYST]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:5:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]
}}

After that we get our seed template:

{{code|
[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[EDIBLE_COOKED]
[SEED:plump helmet spawn:plump helmet spawn:4:0:1:LOCAL_PLANT_MAT:SEED]
}}

And all this says is that the seeds may be eaten by vermin or cooked. Then it gives the name of our plant's seed, its plural name, its foreground, background, and brightness colors, followed by its seed material; said material should have {{token|SEED_MAT|p}} to permit proper stockpiling.

And finally for the last chunk we have this:

{{code|
[SPRING][SUMMER][AUTUMN][WINTER]
[FREQUENCY:100]
[CLUSTERSIZE:5]
[PREFSTRING:rounded tops]
[WET][DRY]
[BIOME:SUBTERRANEAN_WATER]
[UNDERGROUND_DEPTH:1:3]
[SHRUB_TILE:58]
[DEAD_SHRUB_TILE:58]
[SHRUB_COLOR:5:0:0]
[DEAD_SHRUB_COLOR:0:0:1]
}}

First we define what season(s) the plant may grow in, then we define how frequently this plant is generated in a particular area, followed by how many harvested crop items may come from 1 plant. {{token|PREFSTRING|p}} is what your dwarves [[Preference|like]] about the plant, which in this case is the rounded tops. {{token|WET|p}}{{token|DRY|p}} are the conditions under which the plant can grow. Wet means it can grow close to water, dry means it can grow away from water. This does not mean you can grow the plant on dry stone however. It is just for natural spawning of the plant. 
{{token|BIOME|p}} is what [[Biome token|biome]] the plant grows in. {{token|UNDERGROUND_DEPTH:Minimum:Maximum|p}} Is the highest and lowest cavern levels that the plant can appear in if its 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). 
Lastly, {{token|SHRUB_TILE|p}} is the character used for the naturally spawning [[shrub]] of this plant, {{token|DEAD_SHRUB|p}} is the dead shrub character. {{token|SHRUB_COLOR|p}} Is the shrub's color, and {{token|DEAD_SHRUB_COLOR|p}} is, of course, the dead shrub's color.

Plump helmet shrubs look like {{Tile|:|5:0}}.

While this may or may not look like a lot of tokens, it's very easy. Just copy an existing plant and edit it to your new plant. 
For the rest of the tokens, see [[plant token]].

==== Trees ====

[[Tree]]s are another kind of plant that can be modded. Being plants, they use many of the same tokens as edible crops, but differ in having a few tree-specific tokens.

Below is the [[apple|apple tree]] raw description:

{{code|
[PLANT:APPLE] malus sieversii
[NAME:apple tree][NAME_PLURAL:apple trees][ADJ:apple tree]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[USE_MATERIAL_TEMPLATE:WOOD:WOOD_TEMPLATE]
[STATE_NAME:ALL_SOLID:apple wood]
[STATE_ADJ:ALL_SOLID:apple wood]
[PREFIX:NONE]
[SOLID_DENSITY:745] *** http://www.csudh.edu/oliver/chemdata/woods.htm
[STATE_COLOR:ALL_SOLID:CHOCOLATE] *** http://www.forestryforum.com/board/index.php/topic,61009.0.html
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen apple cider]
[STATE_NAME_ADJ:LIQUID:apple cider]
[STATE_NAME_ADJ:GAS:boiling apple cider]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:6:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]
[USE_MATERIAL_TEMPLATE:LEAF:LEAF_TEMPLATE]
[STATE_COLOR:ALL:GREEN]
[DISPLAY_COLOR:2:0:0]
[USE_MATERIAL_TEMPLATE:FLOWER:FLOWER_TEMPLATE]
[STATE_COLOR:ALL:ROSE]
[DISPLAY_COLOR:5:0:1]
[USE_MATERIAL_TEMPLATE:FRUIT:FRUIT_TEMPLATE]
[STATE_COLOR:ALL:RUST]
[DISPLAY_COLOR:4:0:0]
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[STOCKPILE_PLANT_GROWTH]
[MATERIAL_REACTION_PRODUCT:DRINK_MAT:LOCAL_PLANT_MAT:DRINK]
[MATERIAL_REACTION_PRODUCT:SEED_MAT:LOCAL_PLANT_MAT:SEED]
[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[SEED:apple seed:apple seeds:0:0:1:LOCAL_PLANT_MAT:SEED]
[TREE:LOCAL_PLANT_MAT:WOOD][TREE_TILE:5]
[TRUNK_PERIOD:10]
[HEAVY_BRANCH_DENSITY:25]
[BRANCH_DENSITY:50]
[MAX_TRUNK_HEIGHT:3]
[HEAVY_BRANCH_RADIUS:1]
[BRANCH_RADIUS:2]
[TRUNK_BRANCHING:2]
[MAX_TRUNK_DIAMETER:1]
[TRUNK_WIDTH_PERIOD:200]
[ROOT_DENSITY:5]
[ROOT_RADIUS:3]
[STANDARD_TILE_NAMES]
[PREFSTRING:fruit]
[DRY]
[BIOME:ANY_TEMPERATE]
[SAPLING]
[GROWTH:LEAVES]
[GROWTH_NAME:apple leaf:apple leaves]
[GROWTH_ITEM:PLANT_GROWTH:NONE:LOCAL_PLANT_MAT:LEAF]
[GROWTH_DENSITY:1000]
[GROWTH_HOST_TILE:BRANCHES_AND_TWIGS]
[GROWTH_HOST_TILE:SAPLING]
[GROWTH_TIMING:0:300000]
[GROWTH_PRINT:0:6:2:0:0:0:209999:1]
[GROWTH_PRINT:0:6:6:0:1:210000:239999:1] autumn color
[GROWTH_PRINT:0:6:4:0:1:240000:269999:1]
[GROWTH_PRINT:0:6:4:0:0:270000:300000:1]
[GROWTH_DROPS_OFF]
[GROWTH:FLOWERS]
[GROWTH_NAME:apple flower:STP]
[GROWTH_ITEM:PLANT_GROWTH:NONE:LOCAL_PLANT_MAT:FLOWER]
[GROWTH_DENSITY:1000]
[GROWTH_HOST_TILE:BRANCHES_AND_TWIGS]
[GROWTH_TIMING:60000:119999]
[GROWTH_PRINT:5:5:5:0:1:60000:119999:2]
[GROWTH:FRUIT]
[GROWTH_NAME:apple:STP]
[GROWTH_ITEM:PLANT_GROWTH:NONE:LOCAL_PLANT_MAT:FRUIT]
[GROWTH_DENSITY:1000]
[GROWTH_HOST_TILE:BRANCHES_AND_TWIGS]
[GROWTH_TIMING:120000:200000]
[GROWTH_DROPS_OFF_NO_CLOUD]
[GROWTH_PRINT:'%':'%':4:0:0:120000:200000:3]
[GROWTH_HAS_SEED]
}}

The first lines are the same as the ones we saw being used in the plump helmets, defining the plant object, giving it a name, and setting up the basic materials.

{{code|
[PLANT:APPLE] malus sieversii
[NAME:apple tree][NAME_PLURAL:apple trees][ADJ:apple tree]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
}}

Adding the token {{token|DISPLAY_COLOR|md}} (ASCII) / {{token|STATE_COLOR|md}} ([[graphics]]) directly after {{token|USE_MATERIAL_TEMPLATE|plant}} would allow us to change the color of the tree.

{{code|
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[DISPLAY_COLOR:1:0:0]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
}}

would give us a {{DFtext|dark blue|1:0}} apple tree. This method is used by the game by [[birch|birches]] and [[spore tree|various]] [[nether-cap|underground]] [[blood thorn|trees]].

Next come the definitions of various other materials used by the tree:

{{code|
[USE_MATERIAL_TEMPLATE:WOOD:WOOD_TEMPLATE]
[STATE_NAME:ALL_SOLID:apple wood]
[STATE_ADJ:ALL_SOLID:apple wood]
[PREFIX:NONE]
[SOLID_DENSITY:745] *** http://www.csudh.edu/oliver/chemdata/woods.htm
[STATE_COLOR:ALL_SOLID:CHOCOLATE] *** http://www.forestryforum.com/board/index.php/topic,61009.0.html
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen apple cider]
[STATE_NAME_ADJ:LIQUID:apple cider]
[STATE_NAME_ADJ:GAS:boiling apple cider]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:6:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]
[USE_MATERIAL_TEMPLATE:LEAF:LEAF_TEMPLATE]
[STATE_COLOR:ALL:GREEN]
[DISPLAY_COLOR:2:0:0]
[USE_MATERIAL_TEMPLATE:FLOWER:FLOWER_TEMPLATE]
[STATE_COLOR:ALL:ROSE]
[DISPLAY_COLOR:5:0:1]
[USE_MATERIAL_TEMPLATE:FRUIT:FRUIT_TEMPLATE]
[STATE_COLOR:ALL:RUST]
[DISPLAY_COLOR:4:0:0]
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[STOCKPILE_PLANT_GROWTH]
[MATERIAL_REACTION_PRODUCT:DRINK_MAT:LOCAL_PLANT_MAT:DRINK]
[MATERIAL_REACTION_PRODUCT:SEED_MAT:LOCAL_PLANT_MAT:SEED]
[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[SEED:apple seed:apple seeds:0:0:1:LOCAL_PLANT_MAT:SEED]
}}

From them, we get to know what the parts of the tree can be used for, as well as how they will appear when separated from the tree. Any alterations that can be done to materials normally can be done here, such as changing the value or adding a [[syndrome]].

[TREE:LOCAL_PLANT_MAT:WOOD][TREE_TILE:5]

{{token|TREE|p}} is what turns your plant object into an actual tree. The following argument describes what material the harvested logs should be made of. If ``NONE``, the felled tree will give no logs. {{token|TREE_TILE|p}} is the tile the tree shows up as on the world map, in this case {{Tile|♣|2:1}}.

Note that all vanilla trees (that give logs) use the "WOOD" material defined above as the argument for {{token|TREE|p}}, as opposed to the "STRUCTURAL" material. Thus, any changes to the properties of the wood harvested should be done to the "WOOD" material.

The following tokens decide the dimensions of the tree, and how it grows.

{{code|
[TRUNK_PERIOD:10]
[HEAVY_BRANCH_DENSITY:25]
[BRANCH_DENSITY:50]
[MAX_TRUNK_HEIGHT:3]
[HEAVY_BRANCH_RADIUS:1]
[BRANCH_RADIUS:2]
[TRUNK_BRANCHING:2]
[MAX_TRUNK_DIAMETER:1]
[TRUNK_WIDTH_PERIOD:200]
[ROOT_DENSITY:5]
[ROOT_RADIUS:3]
}}

{{token|TRUNK_PERIOD|p}} and {{token|TRUNK_WIDTH_PERIOD|p}} determine how long it takes for the trunk to grow one tile taller respectively wider, in years. {{token|MAX_TRUNK_HEIGHT|p|3}} and {{token|MAX_TRUNK_DIAMETER|p|1}} determine the maximum value the above can reach. {{token|TRUNK_BRANCHING|p}} decides how "curvy" the tree is, with {{token|TRUNK_BRANCHING|p|0}} meaning the tree is entirely straight.

{{token|HEAVY_BRANCH_DENSITY|p|25}}, {{token|HEAVY_BRANCH_RADIUS|p|1}}, {{token|BRANCH_DENSITY|p|50}}, {{token|BRANCH_RADIUS|p|2}}, {{token|ROOT_DENSITY|p|5}}, and {{token|ROOT_RADIUS|p|3}} determine the density (how many are there, integer ranging 0-100) and radius (in tiles) away from the trunk, of heavy branches, normal branches and roots respectively.

{{token|STANDARD_TILE_NAMES|p}} makes the tree use standard names for the trunk, branches etc. Otherwise custom ones can be used. (see [[Plant_token|full plant token list]])

{{token|SAPLING|p}} ensures saplings of this tree are called "[tree name] sapling", instead of the standard "young [tree name]".

Lastly, we are introduced to the {{token|GROWTH|p}} token. {{token|GROWTH|p}} defines growths growing on a plant, in this case our apple tree. Apple trees have three growths: leaves, flowers and fruits.

{{code|
[GROWTH:FRUIT]
[GROWTH_NAME:apple:STP]
[GROWTH_ITEM:PLANT_GROWTH:NONE:LOCAL_PLANT_MAT:FRUIT]
[GROWTH_DENSITY:1000]
[GROWTH_HOST_TILE:BRANCHES_AND_TWIGS]
[GROWTH_TIMING:120000:200000]
[GROWTH_DROPS_OFF_NO_CLOUD]
[GROWTH_PRINT:'%':'%':4:0:0:120000:200000:3]
[GROWTH_HAS_SEED]
}}

First comes the name of the growth. Then, with {{token|GROWTH_ITEM|p}}, what kind of growth it is, in this case a {{token|PLANT_GROWTH|i}} made out of the local "FRUIT" material. {{token|GROWTH_DENSITY|p}} says how densely the growth grows, and {{token|GROWTH_HOST_TILE|p}} where on the tree it grows. {{token|GROWTH_TIMING|p}} decides when the growth appears, in [[Time|annual ticks]]. The growth then drops off, leaving no clouds (items to be picked up by your dwarves). {{token|GROWTH_PRINT|p}} sets it to look like {{Tile|%|4:0}}, and {{token|GROWTH_HAS_SEED|p}} implies that eating this growth will leave you with a seed.

=== Workshops ===

Workshops are raw-designed pretty differently from everything else in the game, being buildable structures rather than items or methods to gain items. However, they are fairly simple. For example, here's the raw for the [[soap maker's workshop]]:

{{code|code=
[BUILDING_WORKSHOP:SOAP_MAKER]
[NAME:Soap Maker's Workshop]
[NAME_COLOR:7:0:1]
[DIM:3:3]
[WORK_LOCATION:2:2]
[BUILD_LABOR:SOAP_MAKER]
[BUILD_KEY:CUSTOM_SHIFT_P]
[BLOCK:1:0:0:0] workbenches no longer block
[BLOCK:2:0:0:0]
[BLOCK:3:0:0:0]
[TILE:0:1:' ':' ':150]
[TILE:0:2:' ':' ':'/']
[TILE:0:3:'-':' ':' ']
[COLOR:0:1:0:0:0:0:0:0:6:0:0]
[COLOR:0:2:0:0:0:0:0:0:6:0:0]
[COLOR:0:3:6:0:0:0:0:0:0:0:0]
[TILE:1:1:' ':' ':'=']
[TILE:1:2:'-':' ':8]
[TILE:1:3:' ':' ':150]
[COLOR:1:1:0:0:0:0:0:0:6:0:0]
[COLOR:1:2:6:0:0:0:0:0:6:0:0]
[COLOR:1:3:0:0:0:0:0:0:6:0:0]
[TILE:2:1:'-':' ':8]
[TILE:2:2:' ':' ':8]
[TILE:2:3:' ':150:' ']
[COLOR:2:1:6:0:0:0:0:0:6:0:0]
[COLOR:2:2:0:0:0:0:0:0:6:0:0]
[COLOR:2:3:0:0:0:6:0:0:0:0:0]
[TILE:3:1:150:' ':8]
[TILE:3:2:' ':' ':8]
[TILE:3:3:' ':240:' ']
[COLOR:3:1:6:0:0:0:0:0:6:7:0]
[COLOR:3:2:0:0:0:0:0:0:6:7:0]
[COLOR:3:3:0:0:0:7:0:1:0:0:0]
[BUILD_ITEM:1:BUCKET:NONE:NONE:NONE][EMPTY][CAN_USE_ARTIFACT]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]
[TOOLTIP:Use tallow (rendered fat) or oil here with lye to make soap.]
}}

A line-by-line breakdown:

{{code|
[NAME:Soap Maker's Workshop]
[NAME_COLOR:7:0:1]
}}

These define the name of the workshop ({{DFtext|Soap Maker's Workshop|7:1}}) and [[color]] of the workshop's name when examined.

{{code|
[DIM:3:3]
[WORK_LOCATION:2:2]
}}

{{token|DIM|b}} refers to how large the workshop will be, in this case 3 wide, 3 tall. {{token|WORK_LOCATION|b}} tells where the creature using it (usually a dwarf) will work, numbered from the top right--in this case, ``2:2``, or the middle. Multiple work locations can be defined, even outside the dim.

{{code|
[BUILD_LABOR:SOAP_MAKER]
[BUILD_KEY:CUSTOM_SHIFT_S]
}}

These refer to the worker required to build it ([[Soaper|soap maker]]) and the key used to build it in the workshop menu (capital {{k|S}}).

{{code|
[BLOCK:1:0:0:0]
...
}}
This is a bit more complex, and is where we get to the meaty part of workshop making--the tiles' properties. {{token|BLOCK|b}} refers to which tiles will be untraversable--1 means blocked, 0 means unblocked. The first number refers to row, and the next 3 refer to column, so 1:0:0:0 means that, on the first row, all tiles will be unblocked. This is the case for all vanilla workshops, as of now.

{{code|
[TILE:0:1:' ':' ':150]
...
}}
The {{token|TILE|b}} token tells which tile will go where. note, however, that there are 5 entries here instead of 4. The first number, in this case, refers to build stage, numbered from 0 to 3; 3 or 1 is fully built (depending on whether there are stages), 0 is just placed, and 2 is always an intermediate stage, while 1 is usually an intermediate stage. Whether 1 is an intermediate stage or not depends on if there are a 2 and 3 stage; if 2 and 3 exist, 1 will be intermediate. The second number and beyond are similar to {{token|BLOCK|b}}; however, instead of 1s and 0s, you must input tiles. The tiles themselves can be given in quotes (as in ' ') or given as a number, which can be looked up [[Tilesets|here]]. Here, we have 150, which is û.

{{code|
[COLOR:0:1:0:0:0:0:0:0:6:0:0]
...
}}
{{token|COLOR|b}} is as {{token|TILE|b}}, but with colors instead of tiles; however, colors are made up of 3 numbers each or MAT. MAT refers to the color of the material used to make it; the 3 numbers refer to ``<foreground>:<background>:<foreground brightness>``, and can be looked up [[Color|here]]. For example, ``4:2:1`` will give you bright red with a dark green background ({{Raw tile|☻|4:2:1}}).

For the first row (``0:1``) our colors are [``0:0:0``, ``0:0:0``, ``6:0:0``]. Combining tile and color, this is our result:
{{Tile| |0:0}}{{Tile| |0:0}}{{Tile| |0:0}}{{Tile| |0:0}}{{Tile|û|6:0}}

{{code|
[BUILD_ITEM:1:BUCKET:NONE:NONE:NONE][EMPTY][CAN_USE_ARTIFACT]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]
}}
These refer to items required to build the building. These are in the same format as [[Reaction|reaction reagents and products]]:
``<quantity>:<[[Item token|item]]>:<item subtype>:<[[Material token|material]]>:<material subtype>``.

You'll learn more about those on the article about [[Reaction|reactions]], though. The second {{token|BUILD_ITEM|b}} is special— it uses modifiers exclusively to determine its requirements.

{{token|BUILDMAT|b}} refers to [[wood]] logs, wood [[block]]s, [[stone]] boulders, and stone blocks; {{token|WORTHLESS_STONE_ONLY|b}} means it can't use economic stone; {{token|CAN_USE_ARTIFACT|b}} means that it... can use artifacts. {{token|EMPTY|b}}, in the bucket's case, means that the bucket must be empty.

{{code|
[TOOLTIP:Use tallow (rendered fat) or oil here with lye to make soap.]
}}

This is the text in the tooltip shown when the building is highlighted by the mouse in the workshops list.

More can be seen at the [[Building token|building tokens]] article, including links to graphical editors for assembling workshop tile visuals.

=== Reactions ===

Reactions are the crafting recipes used in [[workshop]]s, and by the [[adventurer mode|adventurer]]. By adding new reactions you can make new items available, or enable you to get items or materials in new ways. The reactions can also be given to entities, in which case they will make use of them during both world gen and play; making a reaction that creates [[steel]] directly from [[plant fiber]]s could allow the elves to craft steel, and arrive clad in it in a [[siege]].

Not all crafting jobs are custom reactions. Reactions are explicitly defined in raws, such as those for [[ceramic industry|pottery]] and [[Metal#Alloys 2|alloy]] making.

An in-depth guide for reactions is available [[Reactions|here]].

=== Materials ===

As we've seen when talking about creatures, materials are vital. Materials can be defined in three forms: material templates, organic materials local to creatures and plants, and inorganic materials such as stone or metal.

Let's take a look at "METAL_TEMPLATE" in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/inorganic_metal.txt material_template_default.txt]``. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/inorganic_metal.txt inorganic_metal.txt]``. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/inorganic_stone_mineral.txt inorganic_stone_mineral.txt]``. Here we can see that in addition to the changes made to the template, there are also {{token|ENVIRONMENT|im}} tokens - these tell the game where to place these minerals during worldgen.

[[material definition token|Here's a list of material tokens]]. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, [[leather]] and [[iron]] - they're fundamentally the same thing regardless of the item type, just with different properties.

== Selecting and Cutting ==

[[#Modifying the vanilla objects|As explained above]], existing raws can be altered with the use of ``SELECT``, and can also be culled with ``CUT`` for more granular control, compared to simply unloading vanilla content in the mod loader. Token behavior when multiple tokens are added depends on the individual token, such as adding to or overwriting the past value. Removing tags from an object without cutting and recreating the object in question is typically impossible, except for creature object tags removed and/or replaced with the use of [[creature variation token]]s.

The syntax for selecting and cutting objects is as follows:

{{code|code=
Substitute X for the desired object. A CUT does not need a SELECT prior, this is simply a list of available options.
Functions that apply only to local sub-objects are indented. In order to edit these, the base object must be currently being defined or have been selected prior.

[SELECT_CREATURE:X]
[CUT_CREATURE:X]

[SELECT_CASTE:X]
[SELECT_ADDITIONAL_CASTE:X]

[SELECT_MATERIAL:X]
[PLUS_MATERIAL:X]
[REMOVE_MATERIAL:X]

[SELECT_TISSUE:X]
[REMOVE_TISSUE:X]

[SELECT_TISSUE_LAYER:X]
[PLUS_TISSUE_LAYER:X]

[SELECT_ENTITY:X]
[CUT_ENTITY:X]

[SELECT_INTERACTION:X]
[CUT_INTERACTION:X]

[SELECT_ITEM:X]
[CUT_ITEM:X]

[SELECT_WORD:X]
[CUT_WORD:X]

[SELECT_TRANSLATION:X]
[CUT_TRANSLATION:X]

[SELECT_SYMBOL:X]
[CUT_SYMBOL:X]

[SELECT_INORGANIC:X]
[CUT_INORGANIC:X]

[SELECT_PLANT:X]
[CUT_PLANT:X]

[SELECT_MATERIAL:X]

[SELECT_GROWTH:X]

[SELECT_REACTION:X]
[CUT_REACTION:X]

[SELECT_MUSIC:X]
[CUT_MUSIC:X]

[SELECT_SOUND:X]
[CUT_SOUND:X]

}}

Note that the {{token|SELECT_SYMBOL|e}} [[entity token]] is separate from the ``[SELECT_SYMBOL]`` [[language token]].

== Examples ==
:''Main articles: [[:Category:Modding_Examples]]''

The Hydling below was made by Mysteryguye (and annotated, updated and separated into blocks by Putnam), to act as an example creature.

{{code|code=
[CREATURE:HYDLING]
[DESCRIPTION:A seven-headed small hairy thing, about the size of a dog. It is very loyal to its masters, and will promptly disembowel any enemy straying too close.]
This is the description that shows up in-game when viewing the creature.

[NAME:hydling:hydlings:hydlish] If there were a civ made of hydlings, it would appear as "hydlings" in the neighbors screen.

[CASTE_NAME:hydling:hydlings:hydlish]

[CREATURE_TILE:'='][COLOR:2:0:1] Will appear as a light green "=".

[PETVALUE:40][NATURAL] Creature is known to be naturally occurring by the game. Will cost 40 embark points to buy.

[LARGE_ROAMING] Will spawn outdoors, wandering around.

[COMMON_DOMESTIC][TRAINABLE][PET] Can be bought on embark as a pet, war animal, or hunting animal.

[BONECARN] Can eat meat and bones only--no vegetables.

[PREFSTRING:loyalty] Dwarves will like it for its loyalty.

[LARGE_PREDATOR] Will attack rather than flee.

[BODY:BASIC_2PARTBODY:7HEADNECKS:BASIC_FRONTLEGS:BASIC_REARLEGS:TAIL:2EYES:NOSE:2LUNGS:HEART:GUTS:ORGANS:THROAT:SPINE:BRAIN:SKULL:3TOES_FQ_REG:3TOES_RQ_REG:MOUTH:TONGUE:GENERIC_TEETH_WITH_FANGS:RIBCAGE]

Has a lower body, upper body, 4 legs, a tail, fourteen eyes, fourteen ears, seven noses, two lungs, a heart, guts, a pancreas etc., and 7 heads with all that goes with those.

[BODYGLOSS:PAW] Feet will be called "paws"

[BODY_DETAIL_PLAN:STANDARD_MATERIALS] Declares the standard materials that most creatures' tissues are made of.

[BODY_DETAIL_PLAN:STANDARD_TISSUES] This declares the tissues that the creature's tissue layers are made of.

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] And this describes the tissue layers that the creature is made of.

[BODY_DETAIL_PLAN:BODY_HAIR_TISSUE_LAYERS:HAIR] Creature will be covered with a layer of fur.

[USE_MATERIAL_TEMPLATE:NAIL:NAIL_TEMPLATE] And it'll have nails.

[USE_TISSUE_TEMPLATE:NAIL:NAIL_TEMPLATE]

[TISSUE_LAYER:BY_CATEGORY:TOE:NAIL:FRONT] On the toe, specifically.

[SELECT_TISSUE_LAYER:HEART:BY_CATEGORY:HEART]
[PLUS_TISSUE_LAYER:SKIN:BY_CATEGORY:THROAT]
[TL_MAJOR_ARTERIES] Heart and throat--called above--will cause heavy bleeding if ruptured.

[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS] Places eyes, ears and what-have-you into their correct placement, so that you don't have people punching out eyes from behind.

[BODY_DETAIL_PLAN:HUMANOID_RIBCAGE_POSITIONS] Sets the ribcage as being around lungs and heart.

[USE_MATERIAL_TEMPLATE:SINEW:SINEW_TEMPLATE] Defines sinew so that...
[TENDONS:LOCAL_CREATURE_MAT:SINEW:200] Tendons...
[LIGAMENTS:LOCAL_CREATURE_MAT:SINEW:200] ...And ligaments can be defined.

[HAS_NERVES] Creature has nerves, and as such can be disabled by severing them.

[USE_MATERIAL_TEMPLATE:BLOOD:BLOOD_TEMPLATE] Defines the material BLOOD using the template BLOOD_TEMPLATE.
[BLOOD:LOCAL_CREATURE_MAT:BLOOD:LIQUID] Defines the creature's BLOOD as being made of the above-defined BLOOD material in a LIQUID state.

[CREATURE_CLASS:GENERAL_POISON] Creature can be affected by syndromes that affect GENERAL_POISON.

[GETS_WOUND_INFECTIONS] Pretty much self-explanatory. Creature can get infected from wounds.
[GETS_INFECTIONS_FROM_ROT] And from necrosis.

[USE_MATERIAL_TEMPLATE:PUS:PUS_TEMPLATE] Defines PUS using PUS_TEMPLATE.
[PUS:LOCAL_CREATURE_MAT:PUS:LIQUID] Defines PUS as being made of PUS.

[BODY_SIZE:0:0:1000] Creature will be 1000 cubic centimeters at birth...
[BODY_SIZE:1:0:12500] 12500 cubic centimeters at 1 year old...
[BODY_SIZE:2:0:30000] and 30000 cubic centimeters at 2.

[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] Creature can be anywhere from 90% to 110% as long as others.
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] As above, but with height.
[BODY_APPEARANCE_MODIFIER:BROADNESS:90:95:98:100:102:105:110] As above, but with broadness. This puts the minimum size of the creature (when fully grown) at 21870 and the maximum size at 39930.

[MAXAGE:20:30] Creature will die of old age between the ages of 20 and 30, no later than 30, no sooner than 20.

[CAN_DO_INTERACTION:MATERIAL_EMISSION] Creature can use the MATERIAL_EMISSION interaction.
[CDI:ADV_NAME:Hurl fireball] In adventurer mode, the MATERIAL_EMISSION interaction will appear as "Hurl fireball".
[CDI:USAGE_HINT:ATTACK] Creature will use MATERIAL_EMISSION when it's attacking, on creatures that it's attacking.
[CDI:BP_REQUIRED:BY_CATEGORY:HEAD] Creature must have at least one HEAD to use MATERIAL_EMISSION.
[CDI:FLOW:FIREBALL] The MATERIAL_EMISSION will shoot a fireball.
[CDI:TARGET:C:LINE_OF_SIGHT] The target for the emission--a location--must be within the line of sight of the Hydling.
[CDI:TARGET_RANGE:C:15] And must be, at most, 15 tiles away.
[CDI:MAX_TARGET_NUMBER:C:1] The hydling can only shoot at one target at a time...
[CDI:WAIT_PERIOD:30] and only every 30 ticks (3 tenths of a second at 100 FPS)

[ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH] Defines a BITE attack that uses teeth.
[ATTACK_SKILL:BITE] Attack uses the BITE skill.
[ATTACK_VERB:nom:noms] "The Hydling noms the Elf in the left first toe, tearing the muscle!"
[ATTACK_CONTACT_PERC:100] Will use all of the tooth. Note that this can be more than 100.
[ATTACK_PENETRATION_PERC:100] Will sink the tooth all the way in. This can also be more than 100.
[ATTACK_FLAG_EDGE] Attack is an EDGE attack.
[ATTACK_PRIORITY:MAIN] Attack is of priority MAIN. Other option is SECOND.
[ATTACK_FLAG_CANLATCH] Attack can latch on.
[ATTACK_PREPARE_AND_RECOVER:3:3] Takes 3 ticks to wind up attack and 3 to recover from it.
[ATTACK_FLAG_INDEPENDENT_MULTIATTACK] Can use each head independently.

[ATTACK:SCRATCH:CHILD_TISSUE_LAYER_GROUP:BY_TYPE:STANCE:BY_CATEGORY:ALL:NAIL] As above, but for nail instead of teeth.
[ATTACK_SKILL:STANCE_STRIKE] Uses the kicking skill.
[ATTACK_VERB:slice:slices] "You slice the Elf in the left foot and the severed part sails off in an arc!"
[ATTACK_CONTACT_PERC:100] Uses the whole nail.
[ATTACK_PENETRATION_PERC:100] The whole nail goes in.
[ATTACK_FLAG_EDGE] Attack is an edge attack.
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK_PRIORITY:SECOND]

[CHILD:1] Hydling will become an adult at 1 year old.

[GENERAL_CHILD_NAME:hydie:hydies] Children will appear as "hydies".

[DIURNAL] Is active during the daytime.

[HOMEOTHERM:10070] Has a body temperature of 102 Fahrenheit.

[APPLY_CREATURE_VARIATION:STANDARD_QUADRUPED_GAITS:900:730:561:351:1900:2900] Can run at 25 kph
[APPLY_CREATURE_VARIATION:STANDARD_SWIMMING_GAITS:3512:2634:1756:878:4900:6900] Can swim at 10 kph
[APPLY_CREATURE_VARIATION:STANDARD_CRAWLING_GAITS:6561:6115:5683:1755:7456:8567] Can crawl at 5 kph
[SWIMS_INNATE]Swims innately.

[CASTE:FEMALE] Defines a caste called FEMALE.
[FEMALE] FEMALE caste is female.

[CASTE:MALE] As above, but with male.
[MALE] See above.
}}

== See also ==
{{catbox|Modding}}

* [[Raw file]]
* [[Token]]
* [[Modding pitfalls]]
* [[Cheating]]
* Bay 12 Guide: https://bay12games.com/dwarves/modding_guide.html

{{Category|Modding}}
{{Category|Guides}}
[[ru:Modding]]

Modding

2026-01-27T11:03:51Z

Putnam3145: /* Resource Overview */ it's noooot quite right to call it the "SDL2 repository", since it's the entire, like, renderer and input section of the game's code, including how it actually places tiles

{{Quality|Fine}}
{{av}}
{{For/see|a list of Dwarf Fortress mods|[[List of mods]]}}
{{Modding}}
'''Modding''', or creating [[mod]]s, refers to modifying the behavior of the base game (vanilla). ''Dwarf Fortress'' is remarkably moddable.

== Resource Overview==
[[File:modding_icon.png|120px|right]]This section serves as a portal to all modding-related pages on the wiki.

; Using Mods:
* [[Mod#Downloading mods|Downloading mods]]
* [[Mod#Enabling/installing mods|Enabling mods in-game]]

; Guides and references:
* [[Modding guide|DF RAWs modding guide]]
* [[Modding pitfalls]] for troubleshooting

* [[Mod#Mod format|Mod format]] and [[Game folders and files]]
* [https://github.com/Putnam3145/DF-Raws/tree/master Official DFRaws repository] and [https://github.com/DF-Wiki/DFRawFunctions Wiki mirror]
* [[Mod#Publishing on Steam Workshop|Publish on Steam Workshop]]
* [[Character table]]
* [[String dump]]

* [https://github.com/Putnam3145/Dwarf-Fortress--libgraphics-- Source code for Dwarf Fortress's graphics/input/sound]
* [https://docs.dfhack.org/en/latest/docs/guides/modding-guide.html#dfhack-modding-guide DFHack modding guide]
* [[Memory hacking]], [[Main:Offset Finding Methods|Offset Finding Methods]]

; Where to get help?
* The official [http://www.bay12forums.com/smf/index.php?board=13.0 modding subforum] on the [[Bay 12 Forums]].
* [https://discord.com/channels/329272032778780672/629902895138996264 #modding-discussion] and [https://discord.com/channels/329272032778780672/1069640085718450218 #modding-technical] channels on [[Kitfox Games]]' Discord.
* [https://docs.dfhack.org/en/stable/docs/Introduction.html#getting-help DFHack questions]

; Modding tools
* There are several specialized [[Utilities#Modding tools|utilities]] that assist in modding efforts. There is [http://www.bay12forums.com/smf/index.php?topic=28829.0 a longer list of them] on the [[Bay 12 Forums]].
:*[https://putnam3145.github.io/helper Material Helper] by [[User:Putnam3145]], for calculating [[Material definition token|material properties]].
:*[https://jose96xd.github.io/DF_Tools/index.html DF Tools] by [[User:Jose96xd]], a collection of web tools.
:*[https://dffd.bay12games.com/file.php?id=1738 DFLang] (by Igfig) and [https://dffd.bay12games.com/file.php?id=7174 LangCreate] (by Talvieno) for generating [[Language token|translations]].
:*[http://www.bay12forums.com/smf/index.php?topic=158930.0 Dwarf Portrait] by Rose, for visualizing unit [[Body token|bodies]].
* Text editors are used in all areas of modding. Use a good text editor to edit files and search into multiple files (like the free [https://notepad-plus-plus.org/ Notepad++] for example) or more advanced editors capable of highlighting and formatting the displayed text (like [[Utilities#DF RAW Language server|DF RAW Language server]])
* Image editors are needed for doing custom graphics. [https://www.getpaint.net/ Paint.NET], Photoshop and GIMP are the most used, but whatever supports the .png format will work.

=== Documentation===
; [[Raw file]]s

These object files, stored in <code>/data/vanilla/*/objects/</code>, define various specifics of game items, materials, and creatures, and can be changed using mods to alter how the game behaves. These are text based and can be edited with any text editor, however, editing the vanilla raw files is now discouraged.

See [[Token|Token reference]] - It's always good to refer to tokens on the wiki. Even experienced modders have to look up tokens! A list of articles about tokens can be found here.

; [[Graphics|Graphics files]]:

The `/data/art/` subfolder of Dwarf Fortress is used to store user-customizable [[tileset]]s while mods can include their own [[Graphics#Premium Graphics|graphics files]].

; [[Reaction]]s:

; [[Language token|Language]] and [[Speech file]]:

; [[Audio|Sound and Music files]]:

All sound and music files used by ''Dwarf Fortress'' are stored in the [https://en.wikipedia.org/wiki/Ogg .ogg] format within the <code>/data/sound/</code> subfolders. Mods can load new audio files. You can also change some of the definitions of when certain musical cues are played, using available [[music token]]s and [[sound token]]s in the raw files.

An example mod by [[User:Putnam3145]] is available on [https://github.com/Putnam3145/dwarf-fortress-example-sound-mod Github].

; [[Lua scripting]]:

An experimental feature used for procedural generation.

=== Best practice ===
The current best practice is to not modify the original raw files, since most modifications can be made via mods. Mods can add new objects, add tokens to existing objects, and cut objects entirely. You should prefer ``SELECT`` over ``CUT``, and prefer ``CUT`` over unloading ([[Mod info token|conflicting with]]) vanilla raws.

== Guide ==
This is intended to be a guide to inform those new to ''Dwarf Fortress'' modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of editing creatures, entities, materials ''et al'', and creating their own.

Generally, breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on [[40d:Modding guide|Teldin's guide]], originally created for version 0.27.176.39c. Per wiki tradition, it has been updated through all the major releases since then; hopefully it reflects current knowledge.

=== Token reference ===
It's always good to refer to tokens on the wiki. Even experienced modders have to look up tokens! A list of articles about tokens can be found [[Token|here]].

=== Basics of DF modding ===
To make a mod, one must put a folder into the <code>/mods/</code> directory in the game's AppData [[File|folder]] or the portable directory. When a mod is first installed, it is copied to <code>/data/installed_mods/</code> and the game loads all data from the installed copy. Changes are NOT immediately propagated from <code>/mods/</code> to <code>/data/installed_mods/</code>. You can create a new installed copy by deleting the old copy or by incrementing the [[Mod info token|version info]] - see [[modding pitfalls]] for more information. The vast majority of modifications to the game can be done via this method.

Your mod folder must contain a file named "info.txt" and subfolders depending on what your mod includes. The majority of mods will want to have an ``objects/`` folder, which can define most kinds of [[Raw file|game content]], and a ``graphics/`` folder, to add [[graphics]].

[[File:Folder-orange.svg|20px|link=]] Mod Name
├ [[File:Folder.svg|20px|link=]] [[Graphics|graphics]]
├ [[File:Folder.svg|20px|link=]] [[Raw file|objects]]
├ [[File:Folder.svg|20px|link=]] [[Lua scripting|scripts]]
├ &emsp;[[File:Lua-Logo.svg|20px|link=]] init.lua
├ [[File:Folder.svg|20px|link=]] [[Audio|sound]]
├ [[File:Text-x-generic.svg|20px|link=]] [[info.txt]]
└ [[File:Picture icon.png|20px|link=]] preview.png

The [[info.txt]] is formatted like so:

{{code|
[ID:my_first_mod]
[NUMERIC_VERSION:1]
[DISPLAYED_VERSION:1.0.0]
[EARLIEST_COMPATIBLE_NUMERIC_VERSION:1]
[EARLIEST_COMPATIBLE_DISPLAYED_VERSION:1.0.0]
[AUTHOR:Your Name Here]
[NAME:My First Mod]
[DESCRIPTION:A cool mod I made!]
}}

A mod should have all of these. There are a [[mod info token|few more tokens]], but the above are the important ones.

Most of the game's vanilla content is in the same format as mods. Many text files can be found in the subfolders of the <code>/data/vanilla</code> folder - these are the [[raw file|raw files]], and using them as a basis for modification is quite easy. For now, we will take a look at one of the existing files. For example, if you open <code>/data/vanilla/vanilla_creatures/objects/creature_standard.txt</code>, it should look something like this:

{{code|
creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...
}}

As you can see, each file comprises a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file will be ignored by the game.

'''In other words, to be recognized by the game, a raw file must have all of the following:'''

# A filename that refers to the type of objects contained therein. '''Creature files must start with creature_, entity files must start with entity_, and so on.'''
# The filename on the first line of the file.
# ``[OBJECT:type]``, where "type" is replaced with the relevant object type.

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, ``[CREATURE:DWARF]``), again stating the type of object, and then the object's unique identifier - if an identifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. ([[Duplicated raws|For example...]]) Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the {{token|CARNIVOROUS}} token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Try to avoid modifying the existing raw files when possible. You should make a mod instead!
* When adding files, token identifiers are all you need to include to ensure proper references are maintained. The game searches through all loaded raw files by tokens.
** For example, you can add a new pair of leather boots and not even have to add it to a file named ``item_shoes.txt``, but rather your own file, say ``item_shoes_new.txt``.
** All objects must have a unique token identifier. Adding a consistent prefix or suffix to your mod's objects (ie: ``[ITEM_SHOES:ITEM_SHOES_BOOTS_NEW]``) greatly reduces the chance that another mod uses the same token. If two mods define objects with the same token without cutting the other, then they will be incompatible due to [[duplicated raws]].
* When a new world is generated, the mods included are "baked in" and cannot be modified except to be updated—for this, the game checks that the mod used by the save is of a compatible {{token|NUMERIC_VERSION|modinfo}}.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities.

=== Modifying the vanilla objects ===

You should not modify the vanilla raws where they originally are if you can help it. Instead, patch them using the patching functions provided with ''Dwarf Fortress'' since v50.01.

There are two patching functions: ``SELECT`` and ``CUT``. When ``SELECT`` is used, it lets you make changes to an object without needing the entire entry to be present in your mod file. When ``CUT`` is used, it forces the game to not use that object, even though it is still found in the vanilla raws (or in any other mods earlier in the load order). Both of these functions take the form of tokens. These functions are not universally applicable to any token found in any entry, just the following list of base objects:

* [[Creature token|CREATURE]]
* [[Entity token|ENTITY]]
* [[Interaction token|INTERACTION]]
* [[Item definition token|ITEM]]
* [[Language token|WORD, TRANSLATION, SYMBOL]]
* [[Inorganic material definition token|INORGANIC]]
* [[Plant token|PLANT]]
* [[Audio|MUSIC, SOUND]]
* [[Reaction token|REACTION]]

The syntax required for these functions is: ``[<function>_<object>:<specific object being affected>]``. For instance, ``[CUT_PLANT:MUSHROOM_HELMET_PLUMP]`` cuts the plump helmet object originally defined in the vanilla file ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/plant_standard.txt plant_standard.txt]``, so the game will not use that object at all. However, ``[SELECT_ITEM_HELM:ITEM_HELM_HELM]`` does not select the helm object from the vanilla file ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/item_helm.txt item_helm.txt]``, even though that's how the object appears in that file, because there is no ``[SELECT_ITEM_HELM]`` token. Instead, the helm would be selected with ``[SELECT_ITEM:ITEM_HELM_HELM]``.

For example, if you wanted to mod beards onto dwarven women while also removing elephants from the game:

{{code|
creature_mypatch

[OBJECT:CREATURE]

[SELECT_CREATURE:DWARF] starts editing DWARF from the end of the entry
[SELECT_CASTE:FEMALE]
[BODY_DETAIL_PLAN:FACIAL_HAIR_TISSUE_LAYERS]

[CUT_CREATURE:ELEPHANT] removes the ELEPHANT creature
}}

Or, say, add your own reaction and building to dwarves:

{{code|
entity_mypatch

[OBJECT:ENTITY]

[SELECT_ENTITY:MOUNTAIN]
[PERMITTED_REACTION:MY_REACTION]
[PERMITTED_BUILDING:MY_BUILDING]
}}

And in any of these, one can add the token ``[LOG_CURRENT_ENTRY]`` somewhere under one of the objects of the file, which logs the full contents of the object in question to ``logs\current_entry.txt``. This can be useful to make sure that the patch is doing what you think it is. For instance if ``[LOG_CURRENT_ENTRY]`` were added on the next line after ``[CREATURE:DWARF]`` in your mod file, then the dwarf object would be the object detailed in the log entry.

Note that it is not possible to remove an existing token from most objects using ``SELECT`` or ``CUT`` alone. Creatures can make use of {{token|CV_REMOVE_TAG|cv}}; for other objects, it is currently necessary to ``CUT`` the entire object and redefine it.

...Speaking of, let's move on to modifying and adding entities.

=== Modding civilizations (entities) ===

Entities - the objects that determine how civilizations work - are stored in <code>[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/entity_default.txt vanilla_entities/objects/entity_default.txt]</code> (though, like all other files, you may add more). They follow the same format as any other raw file:

{{code|
entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQUENCY]
...[OTHER TAGS]...
}}

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the ``[ENTITY:]`` identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

{{token|CREATURE|e}} links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and, therefore, the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the {{token|CREATURE|e|DWARF}} entry in ``entity_default.txt`` with {{token|CREATURE|e|ELF}} and you would be marching elves around in fortress mode, although they would still use dwarven technology, [[Dwarven language|language]] and [[name]]s and so forth. Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect; it will pick only one of the defined creatures at random to use for the civ. Later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with us until then.

{{token|TRANSLATION|e}} defines the language file that the entity will be using, which will determine what their native words are for things. This doesn't determine which words they use for naming things, only the way those words are spelled. The default language files are ``HUMAN``, ``DWARF``, ``ELF``, and ``GOBLIN``, as well as the generated ``GEN_DIVINE`` and ``GEN_IDENTITY``.{{version|51.06-Lua}}

{{token|BIOME_SUPPORT|e}} defines the [[Biome token|biomes]] that civs will attempt to settle in. The ``FREQUENCY`` value determines the likelihood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If one were to type:

{{code|
[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]
}}

This would have very much the same effect as:

{{code|
[BIOME_SUPPORT:ANY_FOREST:5]
[BIOME_SUPPORT:SAVANNA:10]
}}

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials. For more information, see [[entity token]]s.

Besides those mentioned, some fundamental ones are the {{token|SITE_CONTROLLABLE|e}} token, which lets you control the civ in fortress mode, and the {{token|ALL_MAIN_POPS_CONTROLLABLE|e}} token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are {{token|START_BIOME|e}} and the ones regarding sites, but in general, you can just run through the aforementioned list and add or remove what you want.

Also see the creature-level {{token|OUTSIDER_CONTROLLABLE}} token, which allows you to play in adventure mode as an outsider.

By default, the game chooses a {{token|SITE_CONTROLLABLE|e}} civ (and therefore a species if there is more than one) at random when starting a fortress mode game. The group selection section on the embark screen lists all available civs and their primary creature.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of [[Language#language_SYM|symbols]], collections of words centered around a specific concept. The civ will use words from whatever symbols are selected for it for various things. This association might be a little confusing at first, so, let's refer to the "MOUNTAIN" entity:

{{code|
[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]
}}

Here, we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then, after words in the "[[language_SYM.txt/Violent|VIOLENT]]" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of [[language_SYM.txt/Violent|VIOLENT]] with, say, [[language_SYM.txt/Peace|PEACE]] and end up with a battle called "The Clash of Calm" or something.

{{code|
[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]
}}

The above applies here. Dwarves are fond of naming their roads and tunnels after... roads and tunnels.

{{code|
[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]
}}

This section deals with everything else. The things that haven't already been dealt with (hence the ``REMAINING``) - such as site names, kingdom names, the names of individuals, and such - will have names from the [[language_SYM.txt/Artifice|ARTIFICE]] and [[language_SYM.txt/Peace|PEACE]] symbol groups. After that, the dwarf entity is told to cull all inappropriate symbols - this applies to everything (hence the ``ALL``) so if the game happens to choose a symbol associated with, say, [[language_SYM.txt/Evil|EVIL]] for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's perceived personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of an entity file and edit things to your liking. Remember to always change the civ's ``[ENTITY:]`` identifier! This can be anything, so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found [[position token|here]]; they don't require a great deal of explanation, but that can be found in [[Advanced Entity Position Mechanics]].

==== Trade ====
The following [[entity token]]s affect the appearance of [[trading]] [[caravan]]s:

* {{token|ACTIVE_SEASON|e}} - Defines the seasons when an entity may visit your fortress.
* ``[[Entity token#PROGRESS_TRIGGER_POPULATION|[PROGRESS_TRIGGER_*]]]`` - Defines the triggers which control when an entity will become interested in your fortress.
* {{token|COMMON_DOMESTIC_PACK|e}} - Allows the civilization to use domestic pack animals. If an entity lacks pack animals (or ability to pull wagons), it will be unable to send caravans (showing as {{DFtext|No Trade|6:1}} at the [[embark]] screen), unless it has domesticated any suitable animal species or is forced to use a non-suitable creature by the {{token|ANIMAL|e}} definition {{token|ALWAYS_WAGON_PULLER|e}} on creature, caste or class.
* {{token|COMMON_DOMESTIC_PULL|e}} - Allows the civilization to use domestic animals to pull [[wagon]]s, assuming their ``[[Ethic#KILL_PLANT|[ETHIC:KILL_PLANT]]]`` permits them to use wagons in the first place.
* {{token|MERCHANT_BODYGUARDS|e}} - Caravan will be guarded by [[soldier]]s.

=== Modding creatures ===

Creature modding is great fun – you can change nearly any aspect of a creature, or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's ``[CREATURE:]`` header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens [[creature token|here]]. But before you start creating your own creatures, you'll want to learn how the tissues system works.

==== Creature materials and tissues ====

In the most basic sense, a creature is a series of body parts. These parts are defined in their own file, and we'll talk about them later, as a specific aspect of how creatures work, which throws off a lot of prospective modders, is the relationship between body parts, tissues, and materials. We're going to show you part of the [[bronze colossus/raw|creature entry]] for a [[bronze colossus]] (bear with us):

{{code|
...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...
}}

At the top, we can see the {{token|BODY}} token, followed by a list of body parts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues, and those tissues also have to be made out of something - in this case, bronze.

Below the {{token|BODY}} token you'll see a {{token|TISSUE}} token, followed by an identifier, much like the others we've seen. The {{token|TISSUE}} block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the {{token|MUSCULAR|tissue}}, {{token|FUNCTIONAL|tissue}} and {{token|STRUCTURAL|tissue}} tokens. The tissue also references a material - ``[INORGANIC:BRONZE]`` - the properties of which are declared in the [[Inorganic material definition token|inorganic materials]] file ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/inorganic_metal.txt inorganic_metal.txt]``, and the tissue is subsequently made out of this material. With us so far?

Below the tissue definition is the {{token|TISSUE_LAYER}} line. {{token|TISSUE_LAYER}} allows you to control where each tissue is applied. Its first argument defines if it's to search by body part category (``BY_CATEGORY``), body part type (``BY_TYPE``), or look for a specific part (``BY_TOKEN``). That's followed by the parts argument itself, which is in this case ``ALL`` (so the game's looking for parts in all categories, which is to say, every body part). This is followed by the tissue to be applied, "BRONZE". So the {{token|TISSUE_LAYER}} token is telling the game to select all body parts in every category and make them out of the tissue "BRONZE". The colossus is now made of [[bronze]].

By now, you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded!" and you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

{{code|
[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
}}

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

{{code|
...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...
}}

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

{{code|
...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...
}}

This is where [[Body detail plan token|body detail plans]], which have their own file, and are designed to help automate some of the more common processes in creature creation, come in. The first entry in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/b_detail_plan_default.txt b_detail_plan_default.txt]`` does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

{{code|
...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...
}}

Much easier. But what about the {{token|TISSUE_LAYER}} tokens? Will we have to type out all of those manually? Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

{{code|
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...
}}

First, an argument is placed in the plan (``ARG1``, ``ARG2`` etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the "VERTEBRATE_TISSUE_LAYERS" plan, we'll be able to do something like this:

{{code|
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
}}

``ARG1`` in the detail plan is replaced by "SKIN", the first tissue we entered. ``ARG2`` is replaced by "FAT", ``ARG3`` by "MUSCLE", ``ARG4`` by "BONE", and ``ARG5`` by "CARTILAGE". Hence, our creature's body part designated as {{token|CATEGORY|body|BODY}} is made up of "SKIN" with thickness 1, "FAT" with thickness 5, and "MUSCLE" with thickness 50. Its nose is made up of "SKIN" (thickness 1) and "CARTILAGE" (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

{{code|
...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...
}}

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there are detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say we wanted our dwarves to be perpetually on fire (don't ask). We leave the body stuff declared normally:

{{code|
...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...
}}

We then, in our own mod, select the appropriate material:

{{code|
[SELECT_CREATURE:DWARF]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...
}}

We don't want them burning to death, so we'll need to stop that from happening:

{{code|
[SELECT_CREATURE:DWARF]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...
}}

Note that this makes use of DF's built-in temperature scale - you can read more about that [[Temperature|on this page]]. We're also referencing [[material definition token]]s, which we haven't gone over yet - we'll talk about making your own materials later.

==== Creature castes ====

Another potentially extremely powerful part of the creature raws, is the '''caste system.''' The caste system handles both true biological castes and lesser variations, such as sexes.

To understand the true potential of the caste system, we only need to take a look at the raws for antmen, found in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/creature_subterranean.txt creature_subterrenean.txt]``:

{{code|
...
[CASTE:WORKER]
[CASTE_NAME:worker ant woman:worker ant women:worker ant woman]
Female, but non-breeding.
[POP_RATIO:10000]
[CASTE:SOLDIER]
[CASTE_NAME:soldier ant woman:soldier ant women:soldier ant woman]
Female, but non-breeding.
[POP_RATIO:1000]
[CASTE:DRONE]
[MALE]
[CASTE_NAME:drone ant man:drone ant men:drone ant man]
[POP_RATIO:5]
[CASTE:QUEEN]
[FEMALE]
[CASTE_NAME:queen ant woman:queen ant women:queen ant woman]
[POP_RATIO:1]
[SELECT_CASTE:WORKER]
[SELECT_ADDITIONAL_CASTE:SOLDIER]
[SELECT_ADDITIONAL_CASTE:QUEEN]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[SELECT_CASTE:DRONE]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH:2WINGS]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[FLIER]
[SELECT_CASTE:ALL]
[BODY_DETAIL_PLAN:CHITIN_MATERIALS]
[BODY_DETAIL_PLAN:CHITIN_TISSUES]
[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:CHITIN:FAT:MUSCLE]
[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS]
[ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP]
[ATTACK_SKILL:GRASP_STRIKE]
[ATTACK_VERB:punch:punches]
...
}}

It's evident that the process of creating and editing castes is comparable to the modifications we were making to tissues and materials earlier: A caste is declared, and modifications to the base creature are made. Declared castes can be selected and subsequently modified, again, just like tissues and materials.

In this case, each caste is declared, given its own name, and a {{token|POP_RATIO}}, which determines how commonly a birth results in that caste - for every 10000 workers born, there'll be an average of 1000 soldiers, 5 drones and one queen. You've probably also noticed that the "DRONE" and "QUEEN" castes have the {{token|MALE}} and {{token|FEMALE}} tokens respectively - these tokens determine how breeding works. A creature without both a {{token|MALE}} caste and a {{token|FEMALE}} caste will be unable to breed (no asexually reproducing creatures yet, unfortunately). As they lack {{token|FEMALE}}, the workers and soldiers are unable to breed with the male drones.

After this, there are some modifications to bodyparts. In this case, the drones have wings and the {{token|FLIER}} token, which the other castes lack. It's entirely possible for creatures of different castes to have completely different body structures, even to the extent that they don't resemble each other at all. If you read the section of this guide that dealt with entities, you may remember a passing mention of multi-creature civilisations and how they don't quite work as you may think they would. The castes system is your workaround. You could create a caste that is, for all intents and purposes, a human, and another caste of the same creature that acts exactly like a giant cave spider, put the creature in a civ, and get a human-spider civ. The only flaw in this approach is that the castes will interbreed and produce offspring of either caste.

That's the most complex components of creature creation out of the way. You should find the rest trivial by comparison.

=== Modding items ===

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, [[Item definition token]]s don't seem to be especially well-documented (at least not as well as the other object types), but you should be able to figure out most things by way of our explanations and your assumptions.

Let's look at the entry for, of course, the thong:

{{code|
[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]
}}

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add {{token|METAL|armor}} to it somewhere. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

{{code|
[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]
[ATTACK_PREPARE_AND_RECOVER:3:3]
}}

{{token|SIZE|wp}} determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. {{token|SKILL|wp}} determines which skill is used in using the weapon; a list of skills can be found [[skill token|on this page]]. {{token|MINIMUM_SIZE|wp}} determines the minimum size a creature must be before the weapon can be wielded, while {{token|TWO_HANDED|wp}} determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explanation. The first value determines the contact area of the weapon's attack; this should be high for slashing weapons and low for bludgeoning, piercing and poking ones. The second value determines how deep the weapon penetrates - for ``BLUNT`` attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of ``EDGE`` attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the nouns and verb used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat. But more accurate it describe distribution of momentum across length of weapon. So "STAB" perfomed with only muscular power and modifier is x1 (1000). "SLASH" performed with some rotating momentum of cutting edge, but sword is pretty balanced thru it's length and modifier is just x1.25 (1250). Axes, hammers and maces have more unbalanced mass distribution and weapon mass concentrated far from grasp, so higher modifiers.

{{token|ATTACK_PREPARE_AND_RECOVER|weapon}} determines number of game frames to perform these actions. In vanilla, all attacks except [[whip|lashing]] use 3:3.

Other, more miscellaneous items are generally simple and shouldn't require any further explanation.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

=== Modding language files ===
{{main|Language token}}

Let's say you added a whole new species. Sure, you could just swipe one of the existing translation files and steal their language for your species, but that's the lazy way! If you want to create a whole new language, it is very simple.

First, you'd need a whole new "language_NAME.txt" file, such as "language_LIZARDMAN.txt", along with "language_LIZARDMAN" at the top of the file, followed by ``[OBJECT:LANGUAGE]`` and ``[TRANSLATION:LIZARDMAN]``. After that, it's just a matter of copy-pasting one of the existing language lists and editing the finished 'translated' word. That's it! Then just add the translation link to your civ in entity_default.txt and it'll be added to the game on worldgen.

All raw files use [[Character table|Code Page 437]] encoding, and you should make sure you are editing these files in that format. As many text editors default to UTF-8, some characters with diacritical marks may fail to show properly. Saving one of the default language raw files in this state will overwrite these characters with the Unicode question mark, which will corrupt the file. To fix this replace the file with a clean one downloaded from the distributed version of DF.

(Note that the name of the file doesn't actually matter; but it's typical to name the file after a creature if it's exclusive to their civilization.)

=== Modding body parts ===

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/body_default.txt body_default.txt]`` and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each body part will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a body part definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the, very simple, format:

{{code|
[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]
}}

The most important tokens are {{token|CONTYPE|body}} and {{token|CON|body}}: {{token|CONTYPE|body}} means the body part in question is connected to a certain ''type'' of body part, while {{token|CON|body}} means it's connected to a ''specific'' one. "TOKENID" is yet another identifier, which should be unique, as it's referenced every time something uses {{token|CON|body}} or ``BY_TOKEN``. {{token|DEFAULT_RELSIZE|body}} defines, of course, what the body part's size is in relation to the other parts. {{token|CATEGORY|body}} defines a category for the part, which can be unique or shared with other parts. This is referenced whenever ``BY_CATEGORY`` is used.

A list of body part tokens can be found [[body token|here]].

Let's take a simple example, a head:

{{code|
[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
}}

It connects directly to an upper body.

{{code|
[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
}}

These are a pair of eyes, connecting to the head.

{{code|
[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
}}

An entire humanoid body. The foot bone's connected to the ankle bone...

``[[Bodygloss|[BODYGLOSS]]]`` entries, which you can sometimes find applied to creature entries, are simply replacement words for specific part name strings in a creature. For example, you'll find the bodygloss definition ``[BODYGLOSS:CLAW_HAND:hand:claw]`` in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/body_default.txt body_default.txt]``; you can then use this in a creature via ``[BODYGLOSS:CLAW_HAND]`` and it'll replace all instances of "hand" with "claw" in that creature. Be warned, however—if you were to, say make a bodygloss ``[BODYGLOSS:EARSTALK:ear:stalk:ears:stalk]``, it would not only change "ear" and "ears" to "stalk" and "stalks", it would also change "h'''ear'''t" to "h'''stalk'''t"! For all intents and purposes the body part will still function as the proper part, though.

=== Modding plants ===

Plants are, again, not unlike creatures. With what you've learned so far in regard to tokens and the materials system, running through the notes included in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/plant_standard.txt plant_standard.txt]`` should explain most things. Here's the list of [[Plant token]]s.

Below is the [[plump helmet]] raw description:

{{code|
[PLANT:MUSHROOM_HELMET_PLUMP]
[NAME:plump helmet][NAME_PLURAL:plump helmets][ADJ:plump helmet]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PICKED_TILE:6][PICKED_COLOR:5:0:0]
[GROWDUR:300][VALUE:2]
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen dwarven wine]
[STATE_NAME_ADJ:LIQUID:dwarven wine]
[STATE_NAME_ADJ:GAS:boiling dwarven wine]
[STATE_COLOR:ALL:AMETHYST]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:5:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]

[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[EDIBLE_COOKED]
[SEED:plump helmet spawn:plump helmet spawn:4:0:1:LOCAL_PLANT_MAT:SEED]
[SPRING][SUMMER][AUTUMN][WINTER]
[FREQUENCY:100]
[CLUSTERSIZE:5]
[PREFSTRING:rounded tops]
[WET][DRY]
[BIOME:SUBTERRANEAN_WATER]
[UNDERGROUND_DEPTH:1:3]
[SHRUB_TILE:58]
[DEAD_SHRUB_TILE:58]
[SHRUB_COLOR:5:0:0]
[DEAD_SHRUB_COLOR:0:0:1]
}}

Let's look at this line by line: 
First, we define its file name. In this case it's "MUSHROOM_HELMET_PLUMP". Next we define its in-game name, "plump helmet" and its adjective for if you were to craft with its materials (e.g. {{DFtext|plump helmet plant earrings}}).

{{code|
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
}}

This defines the structure and material of the plant. It references "STRUCTURAL_PLANT_TEMPLATE" in the first line, so if you were to say, add wings to the template, the plump helmet plant would be winged. This is for the plant itself, not the end plump helmets.

After that we get our edible tokens. These say that [[vermin]] can eat the plant, and it can be eaten raw or cooked by your dwarves. So if you wanted a plant that vermin would leave alone, you'd remove the {{token|EDIBLE_VERMIN|md}} token.

{{code|
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
}}

Next, {{token|PICKED_TILE|p|6}} is the character (6, or ♠) shown when the crop is harvested. See [[Main:Character table|character table]] for a table of usable tiles. {{token|PICKED_COLOR|p|5:0:0}} is the [[color]] used for the crop's tile when harvested. It's in a ``<foreground>:<background>:<brightness>`` format, resulting in a purple spade: {{Tile|♠|5:0}}

{{code|
[PICKED_TILE:6][PICKED_COLOR:5:0:0]
}}

{{token|GROWDUR|p|300}} is how long it takes for your crop to grow. There are 1008 growdur units in a [[Time|season]]. You can calculate this value [https://jose96xd.github.io/DF_Tools/Modules/TimeConverter.html here]. 
{{token|VALUE|p|2}} is the [[item value]] of the harvested plant (default 1).

{{code|
[GROWDUR:300][VALUE:2]
}}

This defines the plant's alcohol states. {{token|STATE_NAME_ADJ|ALL_SOLID|md}} is the frozen name, followed is the actual drink name, and then its boiling name. Drinks can evaporate and freeze in Scorching or Freezing [[Temperature|climates]], respectively.

{{token|DISPLAY_COLOR|md}} is ASCII color, and {{token|STATE_COLOR|md}} is a [[Color#Color tokens|named color]] linked to a graphical [[palette]].

{{token|EDIBLE_RAW|md}} and {{token|EDIBLE_COOKED|md}} are saying you can drink the alcohol raw or cooked.

{{code|
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen dwarven wine]
[STATE_NAME_ADJ:LIQUID:dwarven wine]
[STATE_NAME_ADJ:GAS:boiling dwarven wine]
[STATE_COLOR:ALL:AMETHYST]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:5:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]
}}

After that we get our seed template:

{{code|
[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[EDIBLE_COOKED]
[SEED:plump helmet spawn:plump helmet spawn:4:0:1:LOCAL_PLANT_MAT:SEED]
}}

And all this says is that the seeds may be eaten by vermin or cooked. Then it gives the name of our plant's seed, its plural name, its foreground, background, and brightness colors, followed by its seed material; said material should have {{token|SEED_MAT|p}} to permit proper stockpiling.

And finally for the last chunk we have this:

{{code|
[SPRING][SUMMER][AUTUMN][WINTER]
[FREQUENCY:100]
[CLUSTERSIZE:5]
[PREFSTRING:rounded tops]
[WET][DRY]
[BIOME:SUBTERRANEAN_WATER]
[UNDERGROUND_DEPTH:1:3]
[SHRUB_TILE:58]
[DEAD_SHRUB_TILE:58]
[SHRUB_COLOR:5:0:0]
[DEAD_SHRUB_COLOR:0:0:1]
}}

First we define what season(s) the plant may grow in, then we define how frequently this plant is generated in a particular area, followed by how many harvested crop items may come from 1 plant. {{token|PREFSTRING|p}} is what your dwarves [[Preference|like]] about the plant, which in this case is the rounded tops. {{token|WET|p}}{{token|DRY|p}} are the conditions under which the plant can grow. Wet means it can grow close to water, dry means it can grow away from water. This does not mean you can grow the plant on dry stone however. It is just for natural spawning of the plant. 
{{token|BIOME|p}} is what [[Biome token|biome]] the plant grows in. {{token|UNDERGROUND_DEPTH:Minimum:Maximum|p}} Is the highest and lowest cavern levels that the plant can appear in if its 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). 
Lastly, {{token|SHRUB_TILE|p}} is the character used for the naturally spawning [[shrub]] of this plant, {{token|DEAD_SHRUB|p}} is the dead shrub character. {{token|SHRUB_COLOR|p}} Is the shrub's color, and {{token|DEAD_SHRUB_COLOR|p}} is, of course, the dead shrub's color.

Plump helmet shrubs look like {{Tile|:|5:0}}.

While this may or may not look like a lot of tokens, it's very easy. Just copy an existing plant and edit it to your new plant. 
For the rest of the tokens, see [[plant token]].

==== Trees ====

[[Tree]]s are another kind of plant that can be modded. Being plants, they use many of the same tokens as edible crops, but differ in having a few tree-specific tokens.

Below is the [[apple|apple tree]] raw description:

{{code|
[PLANT:APPLE] malus sieversii
[NAME:apple tree][NAME_PLURAL:apple trees][ADJ:apple tree]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[USE_MATERIAL_TEMPLATE:WOOD:WOOD_TEMPLATE]
[STATE_NAME:ALL_SOLID:apple wood]
[STATE_ADJ:ALL_SOLID:apple wood]
[PREFIX:NONE]
[SOLID_DENSITY:745] *** http://www.csudh.edu/oliver/chemdata/woods.htm
[STATE_COLOR:ALL_SOLID:CHOCOLATE] *** http://www.forestryforum.com/board/index.php/topic,61009.0.html
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen apple cider]
[STATE_NAME_ADJ:LIQUID:apple cider]
[STATE_NAME_ADJ:GAS:boiling apple cider]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:6:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]
[USE_MATERIAL_TEMPLATE:LEAF:LEAF_TEMPLATE]
[STATE_COLOR:ALL:GREEN]
[DISPLAY_COLOR:2:0:0]
[USE_MATERIAL_TEMPLATE:FLOWER:FLOWER_TEMPLATE]
[STATE_COLOR:ALL:ROSE]
[DISPLAY_COLOR:5:0:1]
[USE_MATERIAL_TEMPLATE:FRUIT:FRUIT_TEMPLATE]
[STATE_COLOR:ALL:RUST]
[DISPLAY_COLOR:4:0:0]
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[STOCKPILE_PLANT_GROWTH]
[MATERIAL_REACTION_PRODUCT:DRINK_MAT:LOCAL_PLANT_MAT:DRINK]
[MATERIAL_REACTION_PRODUCT:SEED_MAT:LOCAL_PLANT_MAT:SEED]
[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[SEED:apple seed:apple seeds:0:0:1:LOCAL_PLANT_MAT:SEED]
[TREE:LOCAL_PLANT_MAT:WOOD][TREE_TILE:5]
[TRUNK_PERIOD:10]
[HEAVY_BRANCH_DENSITY:25]
[BRANCH_DENSITY:50]
[MAX_TRUNK_HEIGHT:3]
[HEAVY_BRANCH_RADIUS:1]
[BRANCH_RADIUS:2]
[TRUNK_BRANCHING:2]
[MAX_TRUNK_DIAMETER:1]
[TRUNK_WIDTH_PERIOD:200]
[ROOT_DENSITY:5]
[ROOT_RADIUS:3]
[STANDARD_TILE_NAMES]
[PREFSTRING:fruit]
[DRY]
[BIOME:ANY_TEMPERATE]
[SAPLING]
[GROWTH:LEAVES]
[GROWTH_NAME:apple leaf:apple leaves]
[GROWTH_ITEM:PLANT_GROWTH:NONE:LOCAL_PLANT_MAT:LEAF]
[GROWTH_DENSITY:1000]
[GROWTH_HOST_TILE:BRANCHES_AND_TWIGS]
[GROWTH_HOST_TILE:SAPLING]
[GROWTH_TIMING:0:300000]
[GROWTH_PRINT:0:6:2:0:0:0:209999:1]
[GROWTH_PRINT:0:6:6:0:1:210000:239999:1] autumn color
[GROWTH_PRINT:0:6:4:0:1:240000:269999:1]
[GROWTH_PRINT:0:6:4:0:0:270000:300000:1]
[GROWTH_DROPS_OFF]
[GROWTH:FLOWERS]
[GROWTH_NAME:apple flower:STP]
[GROWTH_ITEM:PLANT_GROWTH:NONE:LOCAL_PLANT_MAT:FLOWER]
[GROWTH_DENSITY:1000]
[GROWTH_HOST_TILE:BRANCHES_AND_TWIGS]
[GROWTH_TIMING:60000:119999]
[GROWTH_PRINT:5:5:5:0:1:60000:119999:2]
[GROWTH:FRUIT]
[GROWTH_NAME:apple:STP]
[GROWTH_ITEM:PLANT_GROWTH:NONE:LOCAL_PLANT_MAT:FRUIT]
[GROWTH_DENSITY:1000]
[GROWTH_HOST_TILE:BRANCHES_AND_TWIGS]
[GROWTH_TIMING:120000:200000]
[GROWTH_DROPS_OFF_NO_CLOUD]
[GROWTH_PRINT:'%':'%':4:0:0:120000:200000:3]
[GROWTH_HAS_SEED]
}}

The first lines are the same as the ones we saw being used in the plump helmets, defining the plant object, giving it a name, and setting up the basic materials.

{{code|
[PLANT:APPLE] malus sieversii
[NAME:apple tree][NAME_PLURAL:apple trees][ADJ:apple tree]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
}}

Adding the token {{token|DISPLAY_COLOR|md}} (ASCII) / {{token|STATE_COLOR|md}} ([[graphics]]) directly after {{token|USE_MATERIAL_TEMPLATE|plant}} would allow us to change the color of the tree.

{{code|
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[DISPLAY_COLOR:1:0:0]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
}}

would give us a {{DFtext|dark blue|1:0}} apple tree. This method is used by the game by [[birch|birches]] and [[spore tree|various]] [[nether-cap|underground]] [[blood thorn|trees]].

Next come the definitions of various other materials used by the tree:

{{code|
[USE_MATERIAL_TEMPLATE:WOOD:WOOD_TEMPLATE]
[STATE_NAME:ALL_SOLID:apple wood]
[STATE_ADJ:ALL_SOLID:apple wood]
[PREFIX:NONE]
[SOLID_DENSITY:745] *** http://www.csudh.edu/oliver/chemdata/woods.htm
[STATE_COLOR:ALL_SOLID:CHOCOLATE] *** http://www.forestryforum.com/board/index.php/topic,61009.0.html
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen apple cider]
[STATE_NAME_ADJ:LIQUID:apple cider]
[STATE_NAME_ADJ:GAS:boiling apple cider]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:6:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]
[USE_MATERIAL_TEMPLATE:LEAF:LEAF_TEMPLATE]
[STATE_COLOR:ALL:GREEN]
[DISPLAY_COLOR:2:0:0]
[USE_MATERIAL_TEMPLATE:FLOWER:FLOWER_TEMPLATE]
[STATE_COLOR:ALL:ROSE]
[DISPLAY_COLOR:5:0:1]
[USE_MATERIAL_TEMPLATE:FRUIT:FRUIT_TEMPLATE]
[STATE_COLOR:ALL:RUST]
[DISPLAY_COLOR:4:0:0]
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[STOCKPILE_PLANT_GROWTH]
[MATERIAL_REACTION_PRODUCT:DRINK_MAT:LOCAL_PLANT_MAT:DRINK]
[MATERIAL_REACTION_PRODUCT:SEED_MAT:LOCAL_PLANT_MAT:SEED]
[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[SEED:apple seed:apple seeds:0:0:1:LOCAL_PLANT_MAT:SEED]
}}

From them, we get to know what the parts of the tree can be used for, as well as how they will appear when separated from the tree. Any alterations that can be done to materials normally can be done here, such as changing the value or adding a [[syndrome]].

[TREE:LOCAL_PLANT_MAT:WOOD][TREE_TILE:5]

{{token|TREE|p}} is what turns your plant object into an actual tree. The following argument describes what material the harvested logs should be made of. If ``NONE``, the felled tree will give no logs. {{token|TREE_TILE|p}} is the tile the tree shows up as on the world map, in this case {{Tile|♣|2:1}}.

Note that all vanilla trees (that give logs) use the "WOOD" material defined above as the argument for {{token|TREE|p}}, as opposed to the "STRUCTURAL" material. Thus, any changes to the properties of the wood harvested should be done to the "WOOD" material.

The following tokens decide the dimensions of the tree, and how it grows.

{{code|
[TRUNK_PERIOD:10]
[HEAVY_BRANCH_DENSITY:25]
[BRANCH_DENSITY:50]
[MAX_TRUNK_HEIGHT:3]
[HEAVY_BRANCH_RADIUS:1]
[BRANCH_RADIUS:2]
[TRUNK_BRANCHING:2]
[MAX_TRUNK_DIAMETER:1]
[TRUNK_WIDTH_PERIOD:200]
[ROOT_DENSITY:5]
[ROOT_RADIUS:3]
}}

{{token|TRUNK_PERIOD|p}} and {{token|TRUNK_WIDTH_PERIOD|p}} determine how long it takes for the trunk to grow one tile taller respectively wider, in years. {{token|MAX_TRUNK_HEIGHT|p|3}} and {{token|MAX_TRUNK_DIAMETER|p|1}} determine the maximum value the above can reach. {{token|TRUNK_BRANCHING|p}} decides how "curvy" the tree is, with {{token|TRUNK_BRANCHING|p|0}} meaning the tree is entirely straight.

{{token|HEAVY_BRANCH_DENSITY|p|25}}, {{token|HEAVY_BRANCH_RADIUS|p|1}}, {{token|BRANCH_DENSITY|p|50}}, {{token|BRANCH_RADIUS|p|2}}, {{token|ROOT_DENSITY|p|5}}, and {{token|ROOT_RADIUS|p|3}} determine the density (how many are there, integer ranging 0-100) and radius (in tiles) away from the trunk, of heavy branches, normal branches and roots respectively.

{{token|STANDARD_TILE_NAMES|p}} makes the tree use standard names for the trunk, branches etc. Otherwise custom ones can be used. (see [[Plant_token|full plant token list]])

{{token|SAPLING|p}} ensures saplings of this tree are called "[tree name] sapling", instead of the standard "young [tree name]".

Lastly, we are introduced to the {{token|GROWTH|p}} token. {{token|GROWTH|p}} defines growths growing on a plant, in this case our apple tree. Apple trees have three growths: leaves, flowers and fruits.

{{code|
[GROWTH:FRUIT]
[GROWTH_NAME:apple:STP]
[GROWTH_ITEM:PLANT_GROWTH:NONE:LOCAL_PLANT_MAT:FRUIT]
[GROWTH_DENSITY:1000]
[GROWTH_HOST_TILE:BRANCHES_AND_TWIGS]
[GROWTH_TIMING:120000:200000]
[GROWTH_DROPS_OFF_NO_CLOUD]
[GROWTH_PRINT:'%':'%':4:0:0:120000:200000:3]
[GROWTH_HAS_SEED]
}}

First comes the name of the growth. Then, with {{token|GROWTH_ITEM|p}}, what kind of growth it is, in this case a {{token|PLANT_GROWTH|i}} made out of the local "FRUIT" material. {{token|GROWTH_DENSITY|p}} says how densely the growth grows, and {{token|GROWTH_HOST_TILE|p}} where on the tree it grows. {{token|GROWTH_TIMING|p}} decides when the growth appears, in [[Time|annual ticks]]. The growth then drops off, leaving no clouds (items to be picked up by your dwarves). {{token|GROWTH_PRINT|p}} sets it to look like {{Tile|%|4:0}}, and {{token|GROWTH_HAS_SEED|p}} implies that eating this growth will leave you with a seed.

=== Workshops ===

Workshops are raw-designed pretty differently from everything else in the game, being buildable structures rather than items or methods to gain items. However, they are fairly simple. For example, here's the raw for the [[soap maker's workshop]]:

{{code|code=
[BUILDING_WORKSHOP:SOAP_MAKER]
[NAME:Soap Maker's Workshop]
[NAME_COLOR:7:0:1]
[DIM:3:3]
[WORK_LOCATION:2:2]
[BUILD_LABOR:SOAP_MAKER]
[BUILD_KEY:CUSTOM_SHIFT_P]
[BLOCK:1:0:0:0] workbenches no longer block
[BLOCK:2:0:0:0]
[BLOCK:3:0:0:0]
[TILE:0:1:' ':' ':150]
[TILE:0:2:' ':' ':'/']
[TILE:0:3:'-':' ':' ']
[COLOR:0:1:0:0:0:0:0:0:6:0:0]
[COLOR:0:2:0:0:0:0:0:0:6:0:0]
[COLOR:0:3:6:0:0:0:0:0:0:0:0]
[TILE:1:1:' ':' ':'=']
[TILE:1:2:'-':' ':8]
[TILE:1:3:' ':' ':150]
[COLOR:1:1:0:0:0:0:0:0:6:0:0]
[COLOR:1:2:6:0:0:0:0:0:6:0:0]
[COLOR:1:3:0:0:0:0:0:0:6:0:0]
[TILE:2:1:'-':' ':8]
[TILE:2:2:' ':' ':8]
[TILE:2:3:' ':150:' ']
[COLOR:2:1:6:0:0:0:0:0:6:0:0]
[COLOR:2:2:0:0:0:0:0:0:6:0:0]
[COLOR:2:3:0:0:0:6:0:0:0:0:0]
[TILE:3:1:150:' ':8]
[TILE:3:2:' ':' ':8]
[TILE:3:3:' ':240:' ']
[COLOR:3:1:6:0:0:0:0:0:6:7:0]
[COLOR:3:2:0:0:0:0:0:0:6:7:0]
[COLOR:3:3:0:0:0:7:0:1:0:0:0]
[BUILD_ITEM:1:BUCKET:NONE:NONE:NONE][EMPTY][CAN_USE_ARTIFACT]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]
[TOOLTIP:Use tallow (rendered fat) or oil here with lye to make soap.]
}}

A line-by-line breakdown:

{{code|
[NAME:Soap Maker's Workshop]
[NAME_COLOR:7:0:1]
}}

These define the name of the workshop ({{DFtext|Soap Maker's Workshop|7:1}}) and [[color]] of the workshop's name when examined.

{{code|
[DIM:3:3]
[WORK_LOCATION:2:2]
}}

{{token|DIM|b}} refers to how large the workshop will be, in this case 3 wide, 3 tall. {{token|WORK_LOCATION|b}} tells where the creature using it (usually a dwarf) will work, numbered from the top right--in this case, ``2:2``, or the middle. Multiple work locations can be defined, even outside the dim.

{{code|
[BUILD_LABOR:SOAP_MAKER]
[BUILD_KEY:CUSTOM_SHIFT_S]
}}

These refer to the worker required to build it ([[Soaper|soap maker]]) and the key used to build it in the workshop menu (capital {{k|S}}).

{{code|
[BLOCK:1:0:0:0]
...
}}
This is a bit more complex, and is where we get to the meaty part of workshop making--the tiles' properties. {{token|BLOCK|b}} refers to which tiles will be untraversable--1 means blocked, 0 means unblocked. The first number refers to row, and the next 3 refer to column, so 1:0:0:0 means that, on the first row, all tiles will be unblocked. This is the case for all vanilla workshops, as of now.

{{code|
[TILE:0:1:' ':' ':150]
...
}}
The {{token|TILE|b}} token tells which tile will go where. note, however, that there are 5 entries here instead of 4. The first number, in this case, refers to build stage, numbered from 0 to 3; 3 or 1 is fully built (depending on whether there are stages), 0 is just placed, and 2 is always an intermediate stage, while 1 is usually an intermediate stage. Whether 1 is an intermediate stage or not depends on if there are a 2 and 3 stage; if 2 and 3 exist, 1 will be intermediate. The second number and beyond are similar to {{token|BLOCK|b}}; however, instead of 1s and 0s, you must input tiles. The tiles themselves can be given in quotes (as in ' ') or given as a number, which can be looked up [[Tilesets|here]]. Here, we have 150, which is û.

{{code|
[COLOR:0:1:0:0:0:0:0:0:6:0:0]
...
}}
{{token|COLOR|b}} is as {{token|TILE|b}}, but with colors instead of tiles; however, colors are made up of 3 numbers each or MAT. MAT refers to the color of the material used to make it; the 3 numbers refer to ``<foreground>:<background>:<foreground brightness>``, and can be looked up [[Color|here]]. For example, ``4:2:1`` will give you bright red with a dark green background ({{Raw tile|☻|4:2:1}}).

For the first row (``0:1``) our colors are [``0:0:0``, ``0:0:0``, ``6:0:0``]. Combining tile and color, this is our result:
{{Tile| |0:0}}{{Tile| |0:0}}{{Tile| |0:0}}{{Tile| |0:0}}{{Tile|û|6:0}}

{{code|
[BUILD_ITEM:1:BUCKET:NONE:NONE:NONE][EMPTY][CAN_USE_ARTIFACT]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]
}}
These refer to items required to build the building. These are in the same format as [[Reaction|reaction reagents and products]]:
``<quantity>:<[[Item token|item]]>:<item subtype>:<[[Material token|material]]>:<material subtype>``.

You'll learn more about those on the article about [[Reaction|reactions]], though. The second {{token|BUILD_ITEM|b}} is special— it uses modifiers exclusively to determine its requirements.

{{token|BUILDMAT|b}} refers to [[wood]] logs, wood [[block]]s, [[stone]] boulders, and stone blocks; {{token|WORTHLESS_STONE_ONLY|b}} means it can't use economic stone; {{token|CAN_USE_ARTIFACT|b}} means that it... can use artifacts. {{token|EMPTY|b}}, in the bucket's case, means that the bucket must be empty.

{{code|
[TOOLTIP:Use tallow (rendered fat) or oil here with lye to make soap.]
}}

This is the text in the tooltip shown when the building is highlighted by the mouse in the workshops list.

More can be seen at the [[Building token|building tokens]] article, including links to graphical editors for assembling workshop tile visuals.

=== Reactions ===

Reactions are the crafting recipes used in [[workshop]]s, and by the [[adventurer mode|adventurer]]. By adding new reactions you can make new items available, or enable you to get items or materials in new ways. The reactions can also be given to entities, in which case they will make use of them during both world gen and play; making a reaction that creates [[steel]] directly from [[plant fiber]]s could allow the elves to craft steel, and arrive clad in it in a [[siege]].

Not all crafting jobs are custom reactions. Reactions are explicitly defined in raws, such as those for [[ceramic industry|pottery]] and [[Metal#Alloys 2|alloy]] making.

An in-depth guide for reactions is available [[Reactions|here]].

=== Materials ===

As we've seen when talking about creatures, materials are vital. Materials can be defined in three forms: material templates, organic materials local to creatures and plants, and inorganic materials such as stone or metal.

Let's take a look at "METAL_TEMPLATE" in ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/inorganic_metal.txt material_template_default.txt]``. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/inorganic_metal.txt inorganic_metal.txt]``. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at ``[https://github.com/DF-Wiki/DFRawFunctions/blob/master/raws/v50/inorganic_stone_mineral.txt inorganic_stone_mineral.txt]``. Here we can see that in addition to the changes made to the template, there are also {{token|ENVIRONMENT|im}} tokens - these tell the game where to place these minerals during worldgen.

[[material definition token|Here's a list of material tokens]]. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, [[leather]] and [[iron]] - they're fundamentally the same thing regardless of the item type, just with different properties.

== Selecting and Cutting ==

[[#Modifying the vanilla objects|As explained above]], existing raws can be altered with the use of ``SELECT``, and can also be culled with ``CUT`` for more granular control, compared to simply unloading vanilla content in the mod loader. Token behavior when multiple tokens are added depends on the individual token, such as adding to or overwriting the past value. Removing tags from an object without cutting and recreating the object in question is typically impossible, except for creature object tags removed and/or replaced with the use of [[creature variation token]]s.

The syntax for selecting and cutting objects is as follows:

{{code|code=
Substitute X for the desired object. A CUT does not need a SELECT prior, this is simply a list of available options.
Functions that apply only to local sub-objects are indented. In order to edit these, the base object must be currently being defined or have been selected prior.

[SELECT_CREATURE:X]
[CUT_CREATURE:X]

[SELECT_CASTE:X]
[SELECT_ADDITIONAL_CASTE:X]

[SELECT_MATERIAL:X]
[PLUS_MATERIAL:X]
[REMOVE_MATERIAL:X]

[SELECT_TISSUE:X]
[REMOVE_TISSUE:X]

[SELECT_TISSUE_LAYER:X]
[PLUS_TISSUE_LAYER:X]

[SELECT_ENTITY:X]
[CUT_ENTITY:X]

[SELECT_INTERACTION:X]
[CUT_INTERACTION:X]

[SELECT_ITEM:X]
[CUT_ITEM:X]

[SELECT_WORD:X]
[CUT_WORD:X]

[SELECT_TRANSLATION:X]
[CUT_TRANSLATION:X]

[SELECT_SYMBOL:X]
[CUT_SYMBOL:X]

[SELECT_INORGANIC:X]
[CUT_INORGANIC:X]

[SELECT_PLANT:X]
[CUT_PLANT:X]

[SELECT_MATERIAL:X]

[SELECT_GROWTH:X]

[SELECT_REACTION:X]
[CUT_REACTION:X]

[SELECT_MUSIC:X]
[CUT_MUSIC:X]

[SELECT_SOUND:X]
[CUT_SOUND:X]

}}

Note that the {{token|SELECT_SYMBOL|e}} [[entity token]] is separate from the ``[SELECT_SYMBOL]`` [[language token]].

== Examples ==
:''Main articles: [[:Category:Modding_Examples]]''

The Hydling below was made by Mysteryguye (and annotated, updated and separated into blocks by Putnam), to act as an example creature.

{{code|code=
[CREATURE:HYDLING]
[DESCRIPTION:A seven-headed small hairy thing, about the size of a dog. It is very loyal to its masters, and will promptly disembowel any enemy straying too close.]
This is the description that shows up in-game when viewing the creature.

[NAME:hydling:hydlings:hydlish] If there were a civ made of hydlings, it would appear as "hydlings" in the neighbors screen.

[CASTE_NAME:hydling:hydlings:hydlish]

[CREATURE_TILE:'='][COLOR:2:0:1] Will appear as a light green "=".

[PETVALUE:40][NATURAL] Creature is known to be naturally occurring by the game. Will cost 40 embark points to buy.

[LARGE_ROAMING] Will spawn outdoors, wandering around.

[COMMON_DOMESTIC][TRAINABLE][PET] Can be bought on embark as a pet, war animal, or hunting animal.

[BONECARN] Can eat meat and bones only--no vegetables.

[PREFSTRING:loyalty] Dwarves will like it for its loyalty.

[LARGE_PREDATOR] Will attack rather than flee.

[BODY:BASIC_2PARTBODY:7HEADNECKS:BASIC_FRONTLEGS:BASIC_REARLEGS:TAIL:2EYES:NOSE:2LUNGS:HEART:GUTS:ORGANS:THROAT:SPINE:BRAIN:SKULL:3TOES_FQ_REG:3TOES_RQ_REG:MOUTH:TONGUE:GENERIC_TEETH_WITH_FANGS:RIBCAGE]

Has a lower body, upper body, 4 legs, a tail, fourteen eyes, fourteen ears, seven noses, two lungs, a heart, guts, a pancreas etc., and 7 heads with all that goes with those.

[BODYGLOSS:PAW] Feet will be called "paws"

[BODY_DETAIL_PLAN:STANDARD_MATERIALS] Declares the standard materials that most creatures' tissues are made of.

[BODY_DETAIL_PLAN:STANDARD_TISSUES] This declares the tissues that the creature's tissue layers are made of.

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] And this describes the tissue layers that the creature is made of.

[BODY_DETAIL_PLAN:BODY_HAIR_TISSUE_LAYERS:HAIR] Creature will be covered with a layer of fur.

[USE_MATERIAL_TEMPLATE:NAIL:NAIL_TEMPLATE] And it'll have nails.

[USE_TISSUE_TEMPLATE:NAIL:NAIL_TEMPLATE]

[TISSUE_LAYER:BY_CATEGORY:TOE:NAIL:FRONT] On the toe, specifically.

[SELECT_TISSUE_LAYER:HEART:BY_CATEGORY:HEART]
[PLUS_TISSUE_LAYER:SKIN:BY_CATEGORY:THROAT]
[TL_MAJOR_ARTERIES] Heart and throat--called above--will cause heavy bleeding if ruptured.

[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS] Places eyes, ears and what-have-you into their correct placement, so that you don't have people punching out eyes from behind.

[BODY_DETAIL_PLAN:HUMANOID_RIBCAGE_POSITIONS] Sets the ribcage as being around lungs and heart.

[USE_MATERIAL_TEMPLATE:SINEW:SINEW_TEMPLATE] Defines sinew so that...
[TENDONS:LOCAL_CREATURE_MAT:SINEW:200] Tendons...
[LIGAMENTS:LOCAL_CREATURE_MAT:SINEW:200] ...And ligaments can be defined.

[HAS_NERVES] Creature has nerves, and as such can be disabled by severing them.

[USE_MATERIAL_TEMPLATE:BLOOD:BLOOD_TEMPLATE] Defines the material BLOOD using the template BLOOD_TEMPLATE.
[BLOOD:LOCAL_CREATURE_MAT:BLOOD:LIQUID] Defines the creature's BLOOD as being made of the above-defined BLOOD material in a LIQUID state.

[CREATURE_CLASS:GENERAL_POISON] Creature can be affected by syndromes that affect GENERAL_POISON.

[GETS_WOUND_INFECTIONS] Pretty much self-explanatory. Creature can get infected from wounds.
[GETS_INFECTIONS_FROM_ROT] And from necrosis.

[USE_MATERIAL_TEMPLATE:PUS:PUS_TEMPLATE] Defines PUS using PUS_TEMPLATE.
[PUS:LOCAL_CREATURE_MAT:PUS:LIQUID] Defines PUS as being made of PUS.

[BODY_SIZE:0:0:1000] Creature will be 1000 cubic centimeters at birth...
[BODY_SIZE:1:0:12500] 12500 cubic centimeters at 1 year old...
[BODY_SIZE:2:0:30000] and 30000 cubic centimeters at 2.

[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] Creature can be anywhere from 90% to 110% as long as others.
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] As above, but with height.
[BODY_APPEARANCE_MODIFIER:BROADNESS:90:95:98:100:102:105:110] As above, but with broadness. This puts the minimum size of the creature (when fully grown) at 21870 and the maximum size at 39930.

[MAXAGE:20:30] Creature will die of old age between the ages of 20 and 30, no later than 30, no sooner than 20.

[CAN_DO_INTERACTION:MATERIAL_EMISSION] Creature can use the MATERIAL_EMISSION interaction.
[CDI:ADV_NAME:Hurl fireball] In adventurer mode, the MATERIAL_EMISSION interaction will appear as "Hurl fireball".
[CDI:USAGE_HINT:ATTACK] Creature will use MATERIAL_EMISSION when it's attacking, on creatures that it's attacking.
[CDI:BP_REQUIRED:BY_CATEGORY:HEAD] Creature must have at least one HEAD to use MATERIAL_EMISSION.
[CDI:FLOW:FIREBALL] The MATERIAL_EMISSION will shoot a fireball.
[CDI:TARGET:C:LINE_OF_SIGHT] The target for the emission--a location--must be within the line of sight of the Hydling.
[CDI:TARGET_RANGE:C:15] And must be, at most, 15 tiles away.
[CDI:MAX_TARGET_NUMBER:C:1] The hydling can only shoot at one target at a time...
[CDI:WAIT_PERIOD:30] and only every 30 ticks (3 tenths of a second at 100 FPS)

[ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH] Defines a BITE attack that uses teeth.
[ATTACK_SKILL:BITE] Attack uses the BITE skill.
[ATTACK_VERB:nom:noms] "The Hydling noms the Elf in the left first toe, tearing the muscle!"
[ATTACK_CONTACT_PERC:100] Will use all of the tooth. Note that this can be more than 100.
[ATTACK_PENETRATION_PERC:100] Will sink the tooth all the way in. This can also be more than 100.
[ATTACK_FLAG_EDGE] Attack is an EDGE attack.
[ATTACK_PRIORITY:MAIN] Attack is of priority MAIN. Other option is SECOND.
[ATTACK_FLAG_CANLATCH] Attack can latch on.
[ATTACK_PREPARE_AND_RECOVER:3:3] Takes 3 ticks to wind up attack and 3 to recover from it.
[ATTACK_FLAG_INDEPENDENT_MULTIATTACK] Can use each head independently.

[ATTACK:SCRATCH:CHILD_TISSUE_LAYER_GROUP:BY_TYPE:STANCE:BY_CATEGORY:ALL:NAIL] As above, but for nail instead of teeth.
[ATTACK_SKILL:STANCE_STRIKE] Uses the kicking skill.
[ATTACK_VERB:slice:slices] "You slice the Elf in the left foot and the severed part sails off in an arc!"
[ATTACK_CONTACT_PERC:100] Uses the whole nail.
[ATTACK_PENETRATION_PERC:100] The whole nail goes in.
[ATTACK_FLAG_EDGE] Attack is an edge attack.
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK_PRIORITY:SECOND]

[CHILD:1] Hydling will become an adult at 1 year old.

[GENERAL_CHILD_NAME:hydie:hydies] Children will appear as "hydies".

[DIURNAL] Is active during the daytime.

[HOMEOTHERM:10070] Has a body temperature of 102 Fahrenheit.

[APPLY_CREATURE_VARIATION:STANDARD_QUADRUPED_GAITS:900:730:561:351:1900:2900] Can run at 25 kph
[APPLY_CREATURE_VARIATION:STANDARD_SWIMMING_GAITS:3512:2634:1756:878:4900:6900] Can swim at 10 kph
[APPLY_CREATURE_VARIATION:STANDARD_CRAWLING_GAITS:6561:6115:5683:1755:7456:8567] Can crawl at 5 kph
[SWIMS_INNATE]Swims innately.

[CASTE:FEMALE] Defines a caste called FEMALE.
[FEMALE] FEMALE caste is female.

[CASTE:MALE] As above, but with male.
[MALE] See above.
}}

== See also ==
{{catbox|Modding}}

* [[Raw file]]
* [[Token]]
* [[Modding pitfalls]]
* [[Cheating]]
* Bay 12 Guide: https://bay12games.com/dwarves/modding_guide.html

{{Category|Modding}}
{{Category|Guides}}
[[ru:Modding]]

Template:Info.txt tokens

2026-01-15T00:41:56Z

Putnam3145: /* Info.txt Tokens */

==Info.txt Tokens==
{| {{prettytable}}
|- bgcolor="#DCCF99"
! Token
! Arguments
! Usage
! Description

|-
| {{text anchor|ID}}
| id
| {{tc|red|Required}}
| The ID of the mod. This should be unique, with no two mods sharing the same ID. IDs starting with "vanilla_" are reserved for vanilla raws.

|-
| {{text anchor|NUMERIC_VERSION}}
| integer
| {{tc|red|Required}}
| An '''integer''' version number for the mod. Must be greater than or equal to EARLIEST_COMPATIBLE_NUMERIC_VERSION. "Integer" here means 0, 1, 2, and so on. Negatives are allowed. Anything that is not an integer will not work; 0.2 will be read as "0".

|-
| {{text anchor|DISPLAYED_VERSION}}
| string
| {{tc|red|Required}}
| The version of the mod, as displayed in-game. This is only a display, and will have no effect.

|-
| {{text anchor|EARLIEST_COMPATIBLE_NUMERIC_VERSION}}
| integer
| {{tc|red|Required}}
| The earliest compatible numeric version of the mod. Installed mods are automatically updated, if a later compatible version is available. '''This must be at most the same as NUMERIC_VERSION, and doing otherwise will result in an error.'''

|-
| {{text anchor|EARLIEST_COMPATIBLE_DISPLAYED_VERSION}}
| string
| {{tc|red|Required}}
| The earliest compatible numeric version, as displayed in-game.

|-
| {{text anchor|AUTHOR}}
| string
| {{tc|red|Required{{verify}}}}
| The name of the author (usually you).

|-
| {{text anchor|NAME}}
| string
| {{tc|red|Required{{verify}}}}
| The name of the mod.
|-

|-
| {{text anchor|DESCRIPTION}}
| string
|
| A description of the mod, shown in the mod loading screen.
|-

|-
| {{text anchor|REQUIRES_ID}}
| string
|
| Mod cannot be used unless mod with given ID is also loaded.
|-

|-
| {{text anchor|REQUIRES_ID_BEFORE_ME}}
| string
|
| Mod cannot be used unless mod with given ID is earlier in the mod load list.
|-

|-
| {{text anchor|REQUIRES_ID_AFTER_ME}}
| string
|
| Mod cannot be used unless mod with given ID is later in the mod load list.
|-

|-
| {{text anchor|CONFLICTS_WITH_ID}}
| string
|
| Mod cannot be used if mod with given ID is also loaded.
|-

|}

Template:Info.txt tokens

2026-01-15T00:37:47Z

Putnam3145: /* Info.txt Tokens */

==Info.txt Tokens==
{| {{prettytable}}
|- bgcolor="#DCCF99"
! Token
! Arguments
! Usage
! Description

|-
| {{text anchor|ID}}
| id
| {{tc|red|Required}}
| The ID of the mod. This should be unique, with no two mods sharing the same ID. IDs starting with "vanilla_" are reserved for vanilla raws.

|-
| {{text anchor|NUMERIC_VERSION}}
| integer
| {{tc|red|Required}}
| An '''integer''' version number for the mod. Must be greater than or equal to EARLIEST_COMPATIBLE_NUMERIC_VERSION. "Integer" here means 0, 1, 2, and so on. Negatives are allowed. Anything that is not an integer will not work; 0.2 will be read as "0".

|-
| {{text anchor|DISPLAYED_VERSION}}
| string
| {{tc|red|Required}}
| The version of the mod, as displayed in-game.

|-
| {{text anchor|EARLIEST_COMPATIBLE_NUMERIC_VERSION}}
| integer
| {{tc|red|Required}}
| The earliest compatible numeric version of the mod. Installed mods are automatically updated, if a later compatible version is available. '''This must be at most the same as NUMERIC_VERSION, and doing otherwise will result in an error.'''

|-
| {{text anchor|EARLIEST_COMPATIBLE_DISPLAYED_VERSION}}
| string
| {{tc|red|Required}}
| The earliest compatible numeric version, as displayed in-game.

|-
| {{text anchor|AUTHOR}}
| string
| {{tc|red|Required{{verify}}}}
| The name of the author (usually you).

|-
| {{text anchor|NAME}}
| string
| {{tc|red|Required{{verify}}}}
| The name of the mod.
|-

|-
| {{text anchor|DESCRIPTION}}
| string
|
| A description of the mod, shown in the mod loading screen.
|-

|-
| {{text anchor|REQUIRES_ID}}
| string
|
| Mod cannot be used unless mod with given ID is also loaded.
|-

|-
| {{text anchor|REQUIRES_ID_BEFORE_ME}}
| string
|
| Mod cannot be used unless mod with given ID is earlier in the mod load list.
|-

|-
| {{text anchor|REQUIRES_ID_AFTER_ME}}
| string
|
| Mod cannot be used unless mod with given ID is later in the mod load list.
|-

|-
| {{text anchor|CONFLICTS_WITH_ID}}
| string
|
| Mod cannot be used if mod with given ID is also loaded.
|-

|}

Template:Info.txt tokens

2026-01-15T00:36:39Z

Putnam3145: /* Info.txt Tokens */

==Info.txt Tokens==
{| {{prettytable}}
|- bgcolor="#DCCF99"
! Token
! Arguments
! Usage
! Description

|-
| {{text anchor|ID}}
| id
| {{tc|red|Required}}
| The ID of the mod. This should be unique, with no two mods sharing the same ID. IDs starting with "vanilla_" are reserved for vanilla raws.

|-
| {{text anchor|NUMERIC_VERSION}}
| integer
| {{tc|red|Required}}
| An '''integer''' version number for the mod. Must be greater than or equal to EARLIEST_COMPATIBLE_NUMERIC_VERSION. "Integer" here means 0, 1, 2, and so on. Negatives are allowed. Anything that is not an integer will not work; 0.2 will be read as "0".

|-
| {{text anchor|DISPLAYED_VERSION}}
| string
| {{tc|red|Required}}
| The version of the mod, as displayed in-game.

|-
| {{text anchor|EARLIEST_COMPATIBLE_NUMERIC_VERSION}}
| integer
| {{tc|red|Required}}
| The earliest compatible numeric version of the mod. Installed mods are automatically updated, if a later compatible version is available.

|-
| {{text anchor|EARLIEST_COMPATIBLE_DISPLAYED_VERSION}}
| string
| {{tc|red|Required}}
| The earliest compatible numeric version, as displayed in-game.

|-
| {{text anchor|AUTHOR}}
| string
| {{tc|red|Required{{verify}}}}
| The name of the author (usually you).

|-
| {{text anchor|NAME}}
| string
| {{tc|red|Required{{verify}}}}
| The name of the mod.
|-

|-
| {{text anchor|DESCRIPTION}}
| string
|
| A description of the mod, shown in the mod loading screen.
|-

|-
| {{text anchor|REQUIRES_ID}}
| string
|
| Mod cannot be used unless mod with given ID is also loaded.
|-

|-
| {{text anchor|REQUIRES_ID_BEFORE_ME}}
| string
|
| Mod cannot be used unless mod with given ID is earlier in the mod load list.
|-

|-
| {{text anchor|REQUIRES_ID_AFTER_ME}}
| string
|
| Mod cannot be used unless mod with given ID is later in the mod load list.
|-

|-
| {{text anchor|CONFLICTS_WITH_ID}}
| string
|
| Mod cannot be used if mod with given ID is also loaded.
|-

|}

Turkey

2025-11-28T05:28:45Z

Putnam3145: Pathfinding is not and has never been the main cause of units slowing down FPS, line of sight checks are

{{Quality|Fine}}
{{Creaturelookup/0
|image=turkey_sprites.png
|contrib=no
|bone=6
|meat=9
|fat=9
|intestine=1
|skull=1
|skin=hide
|wiki=Turkey_(bird)
}}
{{av}}
{{creaturedesc}}

'''Turkeys''' are a species of [[domestic animal|domesticated]] [[creature]] who can be brought on [[embark]] or found in the wild, inhabiting [[temperate]] [[wetland]]s. Males are called ''turkey gobblers'', females are called ''turkey hens'' and hatchlings are called ''poults''.

[[Domestic animal#Comparison of domestic poultry|Compared]] to other domestic poultry, turkeys are the largest in size, being a better [[food]] source than the likes of [[chicken]]s. Turkeys take two years to reach their full weight, while the slightly smaller [[blue peafowl]] and [[goose|geese]] take only one year. They lay the most [[egg]]s in average out of all domestic birds (12, compared to the average 10 eggs of the [[duck]] and 9 of the [[guineafowl]]), making them the best domestic birds for [[egg production]]. Having both genders of turkey around allows one to breed them fairly quickly, though [[framerate]] can be negatively impacted by [[catsplosion#Birdsplosion|plentifully]]-peeping poults. As with other tame animals, if many turkeys are confined in a small area, they can become [[overcrowding|overcrowded]] and start fights. Since poults need no food, and have no practical utility until mature, they are generally best [[cage]]d, where they cannot eat FPS by doing line-of-sight checks until they are ready for egg laying or [[Butcher|slaughter]]. Putting a couple in a cage in the [[dining hall]] gives dwarves who like turkeys happy thoughts, as well.

Wild turkeys can be captured with [[cage]] [[trap]]s. [[Animal trainer|Training]] them will render them completely tame.

Some [[Dwarf|dwarves]] [[Preferences|like]] turkeys for their ''wattle'', their ''snood'' and their ''gobble''.

[[File:Wild turkey eastern us.jpg|thumb|400px|center|Admired for its ''gobble''.]]

{{Gamedata}}
{{Creatures}}
{{Category|Animals}}

Personality value

2025-11-27T21:16:19Z

Putnam3145:

{{Quality|Superior}}
{{av}}
[[File:personality_v50_preview.png|thumb|262px|right|Randomly generated personality of a [[miner]].]]

'''Personality values''', as distinct from [[attributes]] and [[mannerism]]s, can be found for a creature in the second sub-tab of the "Personality" tab of its character sheet. In general, these do not have as important a gameplay effect as attributes, at least for skill rolls, but they have a major effect on how a dwarf reacts emotionally to various circumstances, which can have [[mental breakdown|rippling effects.]]

These describe a creature's beliefs; examples include things like [[#TRADITION|tradition]] ("He/she holds the maintenance of tradition as one of the highest ideals"), [[#COOPERATION|cooperation]] ("...is thoroughly disgusted by cooperation"), and [[#SACRIFICE|sacrifice]] ("...believes that those who sacrifice for others should be deeply respected"). Values can conflict with [[personality facet|facets]], but this doesn't mean they are incompatible. For instance, it's possible a dwarf will deeply value [[#ROMANCE|romance]], even though one of their personality facets prevents him/her from [[Personality facet#LOVE_PROPENSITY|forming romantic bonds]]. This particular combination would show up in the "Traits" sub-tab of the "Personality" tab of the creature's character screen as "S/he never falls in love or develops positive feelings toward anything, and s/he is bothered by this since s/he sees romance as one of the highest ideals".

S/he {{DFtext|personally values romance, finds maintaining decorum a silly, fumbling waste of time, values tranquility and a peaceful day and doesn't care about art one way or another.|3:1}}
{{Modding}}

Each value has a range from −50 to 50. The value triggers a report (except for the -10 to +10 range, which does not) on the "Values" sub-tab of the "Personality" tab of a creature's character sheet, depending on where it falls in any of seven levels:
{| class="wikitable"
! Value range !! Values in range !! Probability !! Effect
|-
| +41 to +50 || 10 || 0.4% || Highest
|-
| +26 to +40 || 15 || 2% || Very High
|-
| +11 to +25 || 15 || 8.5% || High
|-
| −10 to +10 || 21 || 78% || Neutral
|-
| −25 to −11 || 15 || 8.5% || Low
|-
| −40 to −26 || 15 || 2% || Very Low
|-
| −50 to −41 || 10 || 0.4% || Lowest
|}

Values are also influenced by cultural values via the use of the VALUE [[entity token]]. For example, dwarven civilizations hold craftsdwarfship in the highest regard, whereas goblins hold the ideas of fairness and sacrifice in utter disdain. If an individual person's values differ significantly from their civilization's values, then that value gets highlighted in cyan in the traits tab. Values, along with traits, dictate [[need]]s and the frequency with which they need to be fulfilled before the focus of the dwarf/adventurer is negatively impacted.

Values can also be changed through successful arguments – in adventure mode, this can be used to change the core values of your adventurer (and, consequently, some of their needs). Since they can argue for values they don't actually hold, you can convince a person of a value you ''want'' your adventurer to hold, get into ''another'' argument over said value, and acquiesce to that (new) position. Note that traits cannot be changed in this way, although they may be subject to changing due to events that happen in your character's adventures.{{verify}} In fortress mode, some [[Memory (thought)|memories]] have the potential to change values over time.

For a creature to have values, it needs the ability to [[Learning|learn]] or [[Speaking|speak]]. Certain values can conflict with personality traits.

{| class="wikitable anchortable"
! Topic
! style="width:7em"| Value !! Description !! Effects
|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|LAW}}
| +41 to +50 || is an absolute believer in the rule of law ||! rowspan=7 | 
|-
| +26 to +40 || has a great deal of respect for the law
|-
| +11 to +25 || respects the law
|-
| −10 to +10 || doesn't feel strongly about the law
|-
| −25 to −11 || does not respect the law
|-
| −40 to −26 || disdains the law
|-
| −50 to −41 || finds the idea of laws abhorrent

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|LOYALTY}}
| +41 to +50 || has the highest regard for loyalty ||! rowspan=7 | 
|-
| +26 to +40 || greatly prizes loyalty
|-
| +11 to +25 || values loyalty
|-
| −10 to +10 || doesn't particularly value loyalty
|-
| −25 to −11 || views loyalty unfavorably
|-
| −40 to −26 || disdains loyalty
|-
| −50 to −41 || is disgusted by the idea of loyalty

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|FAMILY}}
| +41 to +50 || sees family as one of the most important things in life ||! rowspan=7 | 
|-
| +26 to +40 || values family greatly
|-
| +11 to +25 || values family
|-
| −10 to +10 || does not care about family one way or the other
|-
| −25 to −11 || is put off by family
|-
| −40 to −26 || lacks any respect for family
|-
| −50 to −41 || finds the idea of family loathsome

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|FRIENDSHIP}}
| +41 to +50 || believes friendship is a key to the ideal life ||! rowspan=5 | maybe can learn Conversationalist? (maybe subject to LEISURE_TIME?, subject to GREGARIOUSNESS and BASHFUL)
|-
| +26 to +40 || sees friendship as one of the finer things in life
|-
| +11 to +25 || thinks friendship is important
|-
| −10 to +10 || does not care about friendship
|-
| −25 to −11 || finds friendship burdensome
|-
| −40 to −26 || is completely put off by the idea of friends ||! rowspan=2 | maybe cannot learn Conversationalist? (unless overridden by extreme GREGARIOUSNESS or BASHFUL)
|-
| −50 to −41 || finds the whole idea of friendship disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|POWER}}
| +41 to +50 || believes that the acquisition of power over others is the ideal goal in life and worthy of the highest respect ||! rowspan=5 | can learn Intimidator (subject to HARMONY and TRANQUILITY, subject to ASSERTIVENESS and DISCORD)
|-
| +26 to +40 || sees power over others as something to strive for
|-
| +11 to +25 || respects power
|-
| −10 to +10 || doesn't find power particularly praiseworthy
|-
| −25 to −11 || has a negative view of those who exercise power over others
|-
| −40 to −26 || hates those who wield power over others ||! rowspan=2 | cannot learn Intimidator (unless overridden by extreme ASSERTIVENESS or DISCORD)
|-
| −50 to −41 || finds the acquisition and use of power abhorrent and would have all masters toppled

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|TRUTH}}
| +41 to +50 || believes the truth is inviolable regardless of the cost ||! rowspan=2 | cannot learn Flatterer (unless overridden by extreme FRIENDLINESS) cannot learn Liar
|-
| +26 to +40 || believes that honesty is a high ideal
|-
| +11 to +25 || values honesty || can learn Flatterer (subject to FRIENDLINESS) cannot learn Liar
|-
| −10 to +10 || does not particularly value the truth ||! rowspan=4 | can learn Flatterer (subject to FRIENDLINESS) can learn Liar
|-
| −25 to −11 || finds blind honesty foolish
|-
| −40 to −26 || sees lying as an important means to an end
|-
| −50 to −41 || is repelled by the idea of honesty and lies without compunction

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|CUNNING}}
| +41 to +50 || holds well-laid plans and shrewd deceptions in the highest regard ||! rowspan=7 | 
|-
| +26 to +40 || greatly respects the shrewd and guileful
|-
| +11 to +25 || values cunning
|-
| −10 to +10 || does not really value cunning and guile
|-
| −25 to −11 || sees guile and cunning as indirect and somewhat worthless
|-
| −40 to −26 || holds shrewd and crafty individuals in the lowest esteem
|-
| −50 to −41 || is utterly disgusted by guile and cunning

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|ELOQUENCE}}
| +41 to +50 || believes that artful speech and eloquent expression are of the highest ideals ||! rowspan=5 | can learn Persuader (subject to ASSERTIVENESS)
|-
| +26 to +40 || deeply respects eloquent speakers
|-
| +11 to +25 || values eloquence
|-
| −10 to +10 || doesn't value eloquence so much
|-
| −25 to −11 || finds eloquence and artful speech off-putting
|-
| −40 to −26 || finds [him/her]self somewhat disgusted with eloquent speakers ||! rowspan=2 | cannot learn Persuader (unless overridden by extreme ASSERTIVENESS)
|-
| −50 to −41 || sees artful speech and eloquence as a wasteful form of deliberate deception and treats it as such

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|FAIRNESS}}
| +41 to +50 || holds fairness as one of the highest ideals and despises cheating of any kind ||! rowspan=7 | 
|-
| +26 to +40 || has great respect for fairness
|-
| +11 to +25 || respects fair-dealing and fair-play
|-
| −10 to +10 || does not care about fairness
|-
| −25 to −11 || sees life as unfair and doesn't mind it that way
|-
| −40 to −26 || finds the idea of fair-dealing foolish and cheats when [he/she] finds it profitable
|-
| −50 to −41 || is disgusted by the idea of fairness and will freely cheat anybody at any time

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|DECORUM}}
| +41 to +50 || views decorum as a high ideal and is deeply offended by those that fail to maintain it ||! rowspan=7 | 
|-
| +26 to +40 || greatly respects those that observe decorum and maintain their dignity
|-
| +11 to +25 || values decorum, dignity and proper behavior
|-
| −10 to +10 || doesn't care very much about decorum
|-
| −25 to −11 || finds maintaining decorum a silly, fumbling waste of time
|-
| −40 to −26 || sees those that attempt to maintain dignified and proper behavior as vain and offensive
|-
| −50 to −41 || is affronted by the whole notion of maintaining decorum and finds so-called dignified people disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|TRADITION}}
| +41 to +50 || holds the maintenance of tradition as one of the highest ideals ||rowspan=3 | Gets a happy [[thought]] when speaking to the [[Champion]]
|-
| +26 to +40 || is a firm believer in the value of tradition
|-
| +11 to +25 || values tradition
|-
| −10 to +10 || doesn't have any strong feelings about tradition
|-
| −25 to −11 || disregards tradition ||rowspan=3 | Gets an unhappy [[thought]] when speaking to the [[Champion]]
|-
| −40 to −26 || finds the following of tradition foolish and limiting
|-
| −50 to −41 || is disgusted by tradition and would flout any [he/she] encounters if given a chance

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|ARTWORK}}
| +41 to +50 || believes that the creation and appreciation of artwork is one of the highest ideals ||! rowspan=7 | 
|-
| +26 to +40 || greatly respects artists and their works
|-
| +11 to +25 || values artwork
|-
| −10 to +10 || doesn't care about art one way or another
|-
| −25 to −11 || finds artwork boring
|-
| −40 to −26 || sees the whole pursuit of art as silly
|-
| −50 to −41 || finds art offensive and would have it destroyed whenever possible

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|COOPERATION}}
| +41 to +50 || places cooperation as one of the highest ideals ||! rowspan=7 | Low cooperation may inhibit [[guildhall]] demonstrations. 
|-
| +26 to +40 || sees cooperation as very important in life
|-
| +11 to +25 || values cooperation
|-
| −10 to +10 || doesn't see cooperation as valuable
|-
| −25 to −11 || dislikes cooperation
|-
| −40 to −26 || views cooperation as a low ideal not worthy of any respect
|-
| −50 to −41 || is thoroughly disgusted by cooperation

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|INDEPENDENCE}}
| +41 to +50 || believes that freedom and independence are completely non-negotiable and would fight to defend them ||! rowspan=7 | 
|-
| +26 to +40 || treasures independence
|-
| +11 to +25 || values independence
|-
| −10 to +10 || doesn't really value independence one way or another
|-
| −25 to −11 || finds the ideas of independence and freedom somewhat foolish
|-
| −40 to −26 || sees freedom and independence as completely worthless
|-
| −50 to −41 || hates freedom and would crush the independent spirit wherever it is found

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|STOICISM}}
| +41 to +50 || views any show of emotion as offensive ||! rowspan=2 | cannot learn Consoler (unless overridden by extreme SWAYED_BY_EMOTIONS, CRUELTY, or DISCORD)
|-
| +26 to +40 || thinks it is of the utmost importance to present a bold face and never grouse, complain or even show emotion
|-
| +11 to +25 || believes it is important to conceal emotions and refrain from complaining ||! rowspan=5 | can learn Consoler (subject to SWAYED_BY_EMOTIONS, CRUELTY, and DISCORD)
|-
| −10 to +10 || doesn't see much value in being stoic
|-
| −25 to −11 || sees no value in holding back complaints and concealing emotions
|-
| −40 to −26 || feels that those who attempt to conceal their emotions are vain and foolish
|-
| −50 to −41 || sees concealment of emotions as a betrayal and tries [his/her] best never to associate with such secretive fools

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|INTROSPECTION}}
| +41 to +50 || feels that introspection and all forms of self-examination are the keys to a good life and worthy of respect ||! rowspan=7 | Those who value introspection will enjoy [[library|libraries]] and reading and writing [[book]]s. 
|-
| +26 to +40 || deeply values introspection
|-
| +11 to +25 || sees introspection as important
|-
| −10 to +10 || doesn't really see the value in self-examination
|-
| −25 to −11 || finds introspection to be a waste of time
|-
| −40 to −26 || thinks that introspection is valueless and those that waste time in self-examination are deluded fools
|-
| −50 to −41 || finds the whole idea of introspection completely offensive and contrary to the ideals of a life well-lived

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|SELF_CONTROL}}
| +41 to +50 || believes that self-mastery and the denial of impulses are of the highest ideals ||! rowspan=7 | A dwarf with high self control can go longer without [[alcohol]]. 
|-
| +26 to +40 || finds moderation and self-control to be very important
|-
| +11 to +25 || values self-control
|-
| −10 to +10 || doesn't particularly value self-control
|-
| −25 to −11 || finds those that deny their impulses somewhat stiff
|-
| −40 to −26 || sees the denial of impulses as a vain and foolish pursuit
|-
| −50 to −41 || has abandoned any attempt at self-control and finds the whole concept deeply offensive

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|TRANQUILITY}}
| +41 to +50 || views tranquility as one of the highest ideals ||! rowspan=2 | cannot learn Intimidator (unless overridden by extreme ASSERTIVENESS or DISCORD)
|-
| +26 to +40 || strongly values tranquility and quiet
|-
| +11 to +25 || values tranquility and a peaceful day ||! rowspan=5 | can learn Intimidator (subject to POWER and HARMONY, subject to ASSERTIVENESS and DISCORD)
|-
| −10 to +10 || doesn't have a preference between tranquility and tumult
|-
| −25 to −11 || prefers a noisy, bustling life to boring days without activity
|-
| −40 to −26 || is greatly disturbed by quiet and a peaceful existence
|-
| −50 to −41 || is disgusted by tranquility and would that the world would constantly churn with noise and activity

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|HARMONY}}
| +41 to +50 || would have the world operate in complete harmony without the least bit of strife or disorder ||! rowspan=2 | cannot learn Intimidator (unless overridden by extreme ASSERTIVENESS or DISCORD)
|-
| +26 to +40 || strongly believes that a peaceful and ordered society without dissent is best
|-
| +11 to +25 || values a harmonious existence ||! rowspan=5 | can learn Intimidator (subject to POWER and TRANQUILITY, subject to ASSERTIVENESS and DISCORD)
|-
| −10 to +10 || sees equal parts of harmony and discord as part of life
|-
| −25 to −11 || doesn't respect a society that has settled into harmony without debate and strife
|-
| −40 to −26 || can't fathom why anyone would want to live in an orderly and harmonious society
|-
| −50 to −41 || believes deeply that chaos and disorder are the truest expressions of life and would disrupt harmony wherever it is found

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|MERRIMENT}}
| +41 to +50 || believes that little is better in life than a good party ||! rowspan=5 | can learn Comedian (subject to HUMOR)
|-
| +26 to +40 || truly values merrymaking and parties
|-
| +11 to +25 || finds merrymaking and partying worthwhile activities
|-
| −10 to +10 || doesn't really value merrymaking
|-
| −25 to −11 || sees merrymaking as a waste
|-
| −40 to −26 || is disgusted by merrymakers ||! rowspan=2 | cannot learn Comedian (unless overriden by extreme HUMOR)
|-
| −50 to −41 || is appalled by merrymaking, parties and other such worthless activities

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|CRAFTSMANSHIP}}
| +41 to +50 || holds crafts[man]ship to be of the highest ideals and celebrates talented artisans and their masterworks ||! rowspan=7 | 
|-
| +26 to +40 || has a great deal of respect for worthy crafts[man]ship
|-
| +11 to +25 || values good crafts[man]ship
|-
| −10 to +10 || doesn't particularly care about crafts[man]ship
|-
| −25 to −11 || considers crafts[man]ship to be relatively worthless
|-
| −40 to −26 || sees the pursuit of good crafts[man]ship as a total waste
|-
| −50 to −41 || views crafts[man]ship with disgust and would desecrate a so-called masterwork or two if [he/she] could get away with it

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|MARTIAL_PROWESS}}
| +41 to +50 || believes that martial prowess defines the good character of an individual ||! rowspan=7 | 
|-
| +26 to +40 || deeply respects skill at arms
|-
| +11 to +25 || values martial prowess
|-
| −10 to +10 || does not really value skills related to fighting
|-
| −25 to −11 || finds those that develop skill with weapons and fighting distasteful
|-
| −40 to −26 || thinks that the pursuit of the skills of warfare and fighting is a low pursuit indeed
|-
| −50 to −41 || abhors those that pursue the mastery of weapons and skill with fighting

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|SKILL}}
| +41 to +50 || believes that the mastery of a skill is one of the highest pursuits ||! rowspan=7 | 
|-
| +26 to +40 || really respects those that take the time to master a skill
|-
| +11 to +25 || respects the development of skill
|-
| −10 to +10 || doesn't care if others take the time to master skills
|-
| −25 to −11 || finds the pursuit of skill mastery off-putting
|-
| −40 to −26 || believes that the time taken to master a skill is a horrible waste
|-
| −50 to −41 || sees the whole idea of taking time to master a skill as appalling

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|HARD_WORK}}
| +41 to +50 || believes that hard work is one of the highest ideals and a key to the good life ||! rowspan=7 | 
|-
| +26 to +40 || deeply respects those that work hard at their labors
|-
| +11 to +25 || values hard work
|-
| −10 to +10 || doesn't really see the point of working hard
|-
| −25 to −11 || sees working hard as a foolish waste of time
|-
| −40 to −26 || thinks working hard is an abject idiocy
|-
| −50 to −41 || finds the proposition that one should work hard in life utterly abhorrent

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|SACRIFICE}}
| +41 to +50 || finds sacrifice to be one of the highest ideals ||! rowspan=7 | 
|-
| +26 to +40 || believes that those who sacrifice for others should be deeply respected
|-
| +11 to +25 || values sacrifice
|-
| −10 to +10 || doesn't particularly respect sacrifice as a virtue
|-
| −25 to −11 || sees sacrifice as wasteful and foolish
|-
| −40 to −26 || finds sacrifice to be the height of folly
|-
| −50 to −41 || thinks that the entire concept of sacrifice for others is truly disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|COMPETITION}}
| +41 to +50 || holds the idea of competition among the most important and would encourage it wherever possible ||! rowspan=7 | 
|-
| +26 to +40 || views competition as a crucial driving force in the world
|-
| +11 to +25 || sees competition as reasonably important
|-
| −10 to +10 || doesn't have strong views on competition
|-
| −25 to −11 || sees competition as wasteful and silly
|-
| −40 to −26 || deeply dislikes competition
|-
| −50 to −41 || finds the very idea of competition obscene

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|PERSEVERANCE}} (not to be confused with the [[Personality facet#PERSEVERANCE|PERSEVERANCE facet]])
| +41 to +50 || believes that perseverance is one of the greatest qualities somebody can have ||! rowspan=7 | 
|-
| +26 to +40 || greatly respects individuals that persevere through their trials and labors
|-
| +11 to +25 || respects perseverance
|-
| −10 to +10 || doesn't think much about the idea of perseverance
|-
| −25 to −11 || sees perseverance in the face of adversity as bull-headed and foolish
|-
| −40 to −26 || thinks there is something deeply wrong with people that persevere through adversity
|-
| −50 to −41 || finds the notion that one would persevere through adversity completely abhorrent

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|LEISURE_TIME}}
| +41 to +50 || believes that it would be a fine thing if all time were leisure time ||! rowspan=5 | maybe can learn Conversationalist? (maybe subject to FRIENDSHIP?, subject to GREGARIOUSNESS and BASHFUL)
|-
| +26 to +40 || treasures leisure time and thinks it is very important in life
|-
| +11 to +25 || values leisure time
|-
| −10 to +10 || doesn't think one way or the other about leisure time
|-
| −25 to −11 || finds leisure time wasteful
|-
| −40 to −26 || is offended by leisure time and leisurely living ||! rowspan=2 | maybe cannot learn Conversationalist? (unless overridden by extreme GREGARIOUSNESS or BASHFUL)
|-
| −50 to −41 || believes that those that take leisure time are evil and finds the whole idea disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|COMMERCE}}
| +41 to +50 || sees engaging in commerce as a high ideal in life ||! rowspan=7 | 
|-
| +26 to +40 || really respects commerce and those that engage in trade
|-
| +11 to +25 || respects commerce
|-
| −10 to +10 || doesn't particularly respect commerce
|-
| −25 to −11 || is somewhat put off by trade and commerce
|-
| −40 to −26 || finds those that engage in trade and commerce to be fairly disgusting
|-
| −50 to −41 || holds the view that commerce is a vile obscenity

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|ROMANCE}}
| +41 to +50 || sees romance as one of the highest ideals ||! rowspan=7 | 
|-
| +26 to +40 || thinks romance is very important in life
|-
| +11 to +25 || values romance
|-
| −10 to +10 || doesn't care one way or the other about romance
|-
| −25 to −11 || finds romance distasteful
|-
| −40 to −26 || is somewhat disgusted by romance
|-
| −50 to −41 || finds even the abstract idea of romance repellent

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|NATURE}}
| +41 to +50 || holds nature to be of greater value than most aspects of civilization ||! rowspan=2 | Receives [[Thought|unhappy thought]] when slaughtering/caging animals and felling trees.{{version|0.42.01}}
|-
| +26 to +40 || has a deep respect for animals, plants and the natural world
|-
| +11 to +25 || values nature
|-
| −10 to +10 || doesn't care about nature one way or another
|-
| −25 to −11 || finds nature somewhat disturbing ||! rowspan=3 | Receives [[Thought|happy thought]] when slaughtering/caging animals and felling trees, always gets annoyed when rained on.{{version|0.42.01}}
|-
| −40 to −26 || has a deep dislike of the natural world
|-
| −50 to −41 || would just as soon have nature and the great outdoors burned to ashes and converted into a great mining pit

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#2AFCD2" | {{text anchor|PEACE}}
| +41 to +50 || believes the idea of war is utterly repellent and would have peace at all costs ||! rowspan=5 | can learn Pacifier (subject to DISCORD)
|-
| +26 to +40 || believes that peace is always preferable to war
|-
| +11 to +25 || values peace over war
|-
| −10 to +10 || doesn't particularly care between war and peace
|-
| −25 to −11 || sees war as a useful means to an end
|-
| −40 to −26 || believes war is preferable to peace in general ||! rowspan=2 | cannot learn Pacifier (unless overridden by extreme DISCORD)
|-
| −50 to −41 || thinks that the world should be engaged in perpetual warfare

|- style="border-top: 3px solid #aaa"
! rowspan=7 style="background-color:#28EDC5" | {{text anchor|KNOWLEDGE}}
| +41 to +50 || finds the quest for knowledge to be of the very highest value ||! rowspan=7 | Low knowledge will prevent the ability to become a [[scholar]]. 
|-
| +26 to +40 || views the pursuit of knowledge as deeply important
|-
| +11 to +25 || values knowledge
|-
| −10 to +10 || doesn't see the attainment of knowledge as important
|-
| −25 to −11 || finds the pursuit of knowledge to be a waste of effort
|-s
| −40 to −26 || thinks the quest for knowledge is a delusional fantasy
|-
| −50 to −41 || sees the attainment and preservation of knowledge as an offensive enterprise engaged in by arrogant fools
|}

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

Weapon

2025-11-22T07:02:42Z

Putnam3145: /* Bugs */ It's not really a bug so much as mildly unexpected behavior--the alternative is "it's completely inscrutable which of your dwarves can equip which weapons", which isn't really a good situation.

{{av}}
:''This page deals entirely with manufactured weapons. For natural weapons, see [[Natural weapon]].''
[[File:weapons_sprites_preview.png|right]]A '''weapon''', in the sense described on this page, is any [[item]] specifically designed to be wielded in [[combat]] against others. In [[fortress mode]], weapons can be made at a [[metalsmith's forge]] (all metal weapons, including [[crossbow]]s, and [[bolt]]s in stacks of 25) using a single bar of metal*, a [[bowyer's workshop]] ([[wood|wooden]] and [[bone]] crossbows and bolts in stacks of 25 or 5 respectively) with a single [[log]] or [[bone]], or at a [[craftsdwarf's workshop]] (obsidian short swords* only) with one stone of obsidian plus one log.

: (* No "wooden handle" is required for most non-wooden weapons. The unique [[obsidian]] option for [[short sword]]s is the sole exception to this. Any metal weapons, including short swords made from metal, need no wood for their production.)
Graphically, each weapon's color palette will change according to the material used to make them.

Many creatures with a humanoid form ([[giant]], [[magma man|magma men]], [[animal people]], etc.), or even some non-humanoid creatures with hands can also wield weapons, which can be seen in the items tab after clicking on a creature, although their sprite will not reflect this. This is because only dwarves, humans, elves, goblins and kobolds currently have dedicated sprites to resemble what they're wearing and wielding.

== Basics ==
=== Native vs. foreign ===
In fortress mode, weapons can be split into two categories: those that you can produce, and those that you can't. [[Weaponsmith]]s can produce seven types of native weapons at a [[metalsmith's forge]], but there are also fourteen foreign weapons that can be found in the hands of enemy combatants, or bought from trading caravans (note, however, that due to bugs, several foreign weapons currently are effectively unusable by dwarves). These may use skills your dwarves are unfamiliar with, it is impossible to buy them in bulk, and they are of variable quality and material. Like all weapons, they tend to be expensive as trade goods, and may be worth using if you can secure a high-quality specimen (see [[#Quality and strange moods|Quality]] below). Since they are common for other nations, it is important to understand their properties when you have to fight enemies wielding them.

=== Types of weapons ===
{{main|Attack types}}
Mechanically, all weapon attacks are separated into "edge" and "blunt" types, although these can be further split into four practical categories:
*Slashing
*Piercing
*Crushing
*Ranged

(Weapons that are native to dwarven culture, that dwarves can create for themselves, are listed first, with ''foreign weapons'', types that must be looted off dead enemies or traded for, listed in parentheses and italics. Dwarves can use many types of foreign weapons, but finding a good-[[quality]] one is rare.)

====Slashing weapons====
* [[battle axe]]s, [[short sword]]s ''(also [[scimitar]]s, [[scourge]]s, [[great axe]]s, [[halberd]]s, [[long sword]]s and [[two-handed sword]]s)''

These work by concentrating their force along a sharp edge, allowing them to cut gashes in or to completely sever body parts. Severing is most likely when the body part's thickness is smaller than the weapon's contact edge. They make the quickest work of unarmored opponents who are not tremendously large. They are far less effective against armored targets, however, as armor will usually prevent the cutting, converting strikes into weaker blunt damage. An advantage of severing parts is that they cannot be targetted again, allowing dwarves to better focus on more vital parts.

'''Short swords''' are, generally speaking, less effective than axes. Although categorized as a "slashing" weapon, analysis of combat statistics shows that short swords also deliver piercing and bludgeoning blows (the latter from the butt-end of the handle). However, they do all of these less effectively than other weapons in those categories, making them the "Jack of all trades, master of none" weapon. However, if going against heavily armored opponents, they do have that occasional piercing attack as an advantage over axes, if only that. Also, if [[obsidian]] is available (along with spare wood), obsidian short swords can be produced outside of the usual metal industry chain of production.

====Crushing weapons====
* [[war hammer]]s, [[mace]]s, training weapon attacks (see below), melee attacks with [[crossbow]]s ''(also [[flail]]s, [[maul]]s, [[whip]]s)''

Also known as "blunt" or "bludgeoning" weapons, these work by concentrating their force behind a tiny, blunt point, (notably, war hammers have half the contact area of spears), smashing right through armor and breaking bones beneath their blows. As broken bones cause extreme pain, living creatures that can feel it will often "give in" to it and fall unconscious very quickly. Attacks against such helpless targets will always result in perfectly accurate and perfectly square strikes to the head, which will usually cause fatal brain injury. Nevertheless, blunt weapons are still slower to kill unarmored enemies than slashing weapons are.

====Piercing weapons====
* [[spear]]s, [[pick]]s, [[crossbow]] bolts ''(also [[dagger]]s, [[Pike (weapon)|pikes]], [[morningstar]], [[arrow]]s and [[blowdart]]s)''

These work by concentrating their force at a point, allowing them to punch through armor and damage internal organs. They often get stuck in the opponent, forcing their wielder to spend valuable time pulling the weapon back out between uses.

====Ranged weapons====
* [[crossbow]]s ''(also [[bow]]s and [[blowgun]]s)''

These are effectively lightweight piercing weapons which work from a distance. When opponents engage the user in melee, the users are then forced to wield these weapons as melee weapons. Ranged weapons depend on shoot force and the material composition of the ammunition to deal damage. Best used against light to medium armored targets. All ranged ammunition deals "edged" damage. Wielding any of these as melee weapons is not recommended.

====Training weapons====

There exists one more umbrella category of weapon: the so-called "'''training weapon'''". Training weapons are wooden, and are made at a [[carpenter's workshop]]. Training axes, spears, and short swords can be constructed in fortress mode. They all do blunt impact damage, but only a tiny amount due to the poor [[material science|material properties]] of wood for a combat weapon. While every weapon is actually safe to use in [[Training|sparring]], the primary purpose of training weapons in fortress mode is to allow your dwarves to start training before you have a working metal industry. They can also be used during live combat exercises (beating upon a disarmed goblin, etc.) to extend the training session's length. Finally, they may be issued to the guards to reduce the lethality of a [[justice|criminal beating]].

=== Weapon skill ===
{{main|Combat skill#Weapon skill}}
Every type of weapon has its own associated [[military]] [[skill]]. The higher a dwarf is in his skill with a weapon, the better he will be able to use it in combat, connecting hammer blows to more advantageous sweet spots and sending spears right through enemy hearts and lungs with greater accuracy. The higher the weapon skill, the better at fighting the dwarf will be.

Once a dwarf has reached "Great" skill in a certain weapon, they become '''[weapon] lords''' for that specific weapon. They will love fighting and will no longer complain about long patrol duties. Weapon skill is trained in fighting enemies in combat, demonstrations, and combat drills, but if you leave your dwarves shield-less, a [[danger room]] will train their skill very, very quickly. Note that this does not quite work for marksdwarves - danger rooming ranged weapons increases their melee skill, increasing their hammerdwarf skill, although [[Cross-training|this may be the point]].

=== Attachment ===
A dwarf that has used a particular weapon for a long time will grow [[Attachment|attached]] to it, equipping it whenever their uniform allows them to. This is fine if they are wielding a ☼steel mace☼, but a major problem if they are wielding what is meant to be a training weapon (be it a wooden axe or a copper spear). You can avoid this pitfall by not using training weapons and not forging weapons until you have real weaponsmithing underway. These events generate [[announcement]]s. If a dwarf does become attached, you can easily force him to relinquish the weapon by assigning a 'specific weapon' instead in his equipment view.

In addition, dwarves that reach a certain number or level of kills, or train long enough with a weapon, will name it. This prompts a major announcement. The weapon in question may have no kills associated with it (legendary dwarves occasionally name their weapons while training with them). Once named, the weapon will appear in the artifact list, albeit in blue. It is unknown if named weapons perform better than unnamed weapons. Dwarves may also become attached to shields and name them in the same way.

=== Quality and strange moods ===
The [[quality]] of a weapon has a significant impact on its combat performance, as well as its [[value]].

{{:Item quality/Table}}

Weaponsmithing is a [[moodable]] profession, which means that you can get [[artifact]] weapons. Artifact weapons have a 3x combat bonus and can be made out of a wide range of materials; ordinarily a [[hippo]] [[bone]] spear is impossible, but a moody dwarf can create one with a stack of hippo bone. Artifact weapons made of totally inappropriate materials are inferior to regular ones made of weapons-grade metal, although the exact balance is still under discussion. As with other moodable skills, a dwarf who creates an artifact using the weaponsmith skill stands a [[Strange mood#Skills_and_workshops|high chance]] of becoming a legendary weaponsmith.

=== Weapons as tools ===
[[Hunter]]s use crossbows, [[wood cutter]]s use [[battle axe]]s, and [[miner]]s use [[pick]]s. They must be in possession of these items to do their jobs, and it's as simple as that.

Hunters gain [[marksdwarf]] skill from hunting, but wood cutters do not gain [[axedwarf]] weapon skill from cutting trees. Miners gain [[mining]] skill, which is not considered a military skill, but is used as a weapon skill when fighting with a pick. A dwarf using a weapon as a tool will not use the same tool as a military weapon, instead dropping their tool to pick up another for military use.{{bug|1451}} Dwarves may carry only one weapon as a tool at a time; for example, woodcutters/hunters will drop their axes then go and pick up crossbows every time they begin hunting.

=== Ammunition ===
:''Main article: [[Ammunition]]''

[[Crossbow]]s and other ranged weapons require [[ammunition]] (in the case of the crossbow, [[bolt]]s). This ammunition is carried in a [[quiver]] in packs of about 25, and when they run out they will switch to using their ranged weapons as crude hammers. It's often a good idea to try to get them to retreat once they run out of ammo — crossbows are meant for shooting, not bashing.

=== Secondary weapons ===
Although it sounds like a cool idea, equipping a marksdwarf with a backup short sword "just in case" doesn't often work, as dwarves are just as quick to run up to their foes and start bashing them with a crossbow as they are to draw their swords and do it properly.

=== "Best" weapon choices ===
To put it simply, the combat system behind ''Dwarf Fortress'' is ''very'' complicated. It's not just a question of ''"What is the weapon with the biggest number?"'' - no such thing here. If you want technical specifics, that's addressed in the bottom half of this article (and elsewhere), but for now, from both study of the formulae and observed behavior, there are some patterns for what weapons seem to work "best" against certain targets, and what don't, and (basically) why.

''Dwarf Fortress'' combat is rarely "one-shot", nor is it a long process of whittling away a huge pile of "hit points" (which do not exist in DF). Your best tactic is to try to quickly cripple or stun an opponent, so that you can then deliver a killing blow against a (momentarily) defenseless target, and then move on to the next opponent. The recommended weapons are chosen with this in mind.

==== Superior metal rule ====
As a general rule, if a weapon slashes or pierces, it wants to be made from a "better" metal than the [[armor]] it's trying to penetrate. If it is, it goes through more easily; if it is equal, it has some problems, and if it's inferior, it has some real problems. That does '''not''' mean that a copper spear can't hurt a superior-metal-clad target - just understand that the odds drop compared to weapons of equal metal, and, similarly, superior weapons start to ignore armor of inferior metal.

Also, note that this effectively works in steps - copper is weak against bronze/iron targets, but feeble against steel.

(Note: In this section, if 2 metals are equivalent to each other, they will be placed together in parentheses for ease of comparison.)

* [[steel]], the clear best*
* ([[bronze]] or [[iron]]), very respectable, roughly equivalent** to each other
* [[copper]], a distant third
* [[silver]], a ''very'' distant last (included only because silver is listed to make slashing/piercing weapons)

: (* There is also [[adamantine]], which is late game only, in a different league from the rest. That is not the subject of a "basic" discussion.)
: (** There are some "X weapon vs Y armor" situations where iron is slightly better, but a couple where bronze is actually better than iron - but each is a very specific case. "Roughly equivalent" is a good rule of thumb.)

Ranged attacks (for dwarves, [[crossbow]]s, but also bows and arrows for enemies) are also piercing, and suffer even more from the "superior metal" rule, especially since everything except adamantine has essentially equal density when it comes to bolts due to their max velocity and force. It can be very disheartening to see all those cheap bolts bounce off their armored targets when it matters most.

Note that [[Attack_types#Blunt_weapons|blunt]] weapons, such as [[mace]]s or [[war hammer]]s, do '''''not''''' follow this rule. For them, generally speaking, "heavier is better", so [[density|denser]] metals, such as silver, perform well, although the hardness of steel makes it another strong performer. In terms of which is actually better, it depends on the skill level of the dwarf swinging the weapon. Unskilled dwarves are much better off using steel because of its lower weight; silver tires them out far too quickly. This means blunt weapons made of steel are good for militias, or any squad that doesn't do much dedicated training. For more skilled dwarves, however, silver's weight tends to tire the wielder out much slower now, and the extra damage per hit makes it better than steel in this case. This means that if you have a squad that trains for most of the year, they will make much better use of a silver blunt weapon than a steel one. For the other weapons-grade metals, they are all a close third to these and are perfectly serviceable, as the small differences in density do not matter that much. Rare heavy artifact blunt weapons from [[gold]] or, better, [[platinum]], do only slightly more damage (despite being 273% the density of steel, platinum only gets about 1% more momentum), but with the greater weight comes a greater risk of tiring out the wielder in a long fight.[http://www.bay12forums.com/smf/index.php?topic=181479]

==== vs. unarmored ====
This includes most wild [[animal]]s, [[siege]]-mounts, [[thief|thieves]], [[kobold]]s, etc. Leather/bone armor helps against animal attacks, not against metal weapons.

It may also include some [[semi-megabeast]]s and [[megabeast]]s, depending on specifics.

* recommended weapon: any sharp weapon

Most unarmored creatures are biological beings much larger than dwarf, a situation where spear excels at reaching the vitals. Axes have 60% the penetration and swords 40% of the penetration of spears, but much larger areas, which leads to much more bleeding and more chance of pulping. In theory, all edged weapons follow the "superior metal" rule, but, against unarmored targets, skin and bone will always lose to ''any'' edged metal weapon - even silver! (However, see "vs. undead", below.)

Blunt weapons can break bones, which stuns the target and allows a killing blow, but removing a limb is obviously better. War hammers break bones more easily than maces, causing pain, though maces achieve total pulping blows sooner. However, unless you're facing small enemies even the best blunt weapon is going to lose to the worst sharp weapon.

Crossbows can hit a vital organ, knee or guts if lucky, but otherwise are slow to cripple and may get off only 2-3 shots before melee combat begins. They are, however, excellent for chasing down fleeing targets, making them ideal against various thieves/wildlife.

And the bonus lesson here is... armor your military.

==== vs. [[armor]]ed ====

Usually showing up only during a [[siege]] or [[ambush]]. [[Quality]] has a significant effect, but copper chain pieces have much less stopping power than bronze/iron plate pieces.

* recommended weapon: steel spear
* other choices: any steel sharp weapon, any warhammer or pick

Your typical goblin or human sieges will never have steel. Even when undead have it, the coverage is only partial.

Steel spears are the only edged weapon that can consistently pierce armor. Unless held by an extremely strong dwarf or made of adamantine, a sword will have difficulty getting through a breastplate, and an axe '''never''' will.

Steel swords have biggest variety of attacks, allowing them to both stab organs and remove limbs. Picks have the velocity of a blunt weapon with the edge of a sharp weapon, giving them extra punch. Functionally, having "superior metal" will make the battle much like removing enemy armor.

(Note also that piercing weapons have a chance to get stuck in an opponent, which can lead to [[wrestling]] to get the weapon out, or to apply more punishment.)

Blunt weapons work on flexible chain just as well as against an unarmored opponent, and can deform solid armor (which is everything "not chain") to land a killing blow. Warhammers are superior to maces in penetrating solid, "non-chain" armor and breaking bones.

Slashing weapons really suffer here, and especially so against non-chain targets. It's critical that they be superior metal if you want any chance of them having much reliable effect against heavy armor. A lucky blow can still take a limb, but often slashing blows just do little more than anger the target, even with steel.

Crossbows suffer doubly from superior metal issues against chain, and it only gets worse against plate [http://www.bay12forums.com/smf/index.php?topic=160814.msg7192083#msg7192083 3]

==== vs. [[undead]] ====

* recommended weapon: mace or war hammer if you want to have a single corpse, axe if you want efficiency.
* other choices: sword will do a fine job.

u/MrNorrelDoesHisPart:

"Maces did indeed perform the best in terms of creating the smallest number of additional reanimated opponents. They always scored perfectly and thus don’t have a margin of error. Axes produced the largest number of additional reanimated opponents, and spears produced relatively few reanimated body parts...(However) Axes and spears tie for fastest and maces come a distant third. Although it is true that an axe is much messier than a mace, it seems that an axe’s greater killing ability more than compensates for this problem. Maces thus appear to be the best choice when cleanliness is a priority but the worst choice when combat efficiency is important."

*Newest Dwarven [https://www.reddit.com/r/dwarffortress/comments/11bh54h/combat_science_iii_fighting_the_undead/ !!Science!!] shows that while axe create a messy pile of reanimated corpse, the axe generally takes only 1/3 the time to kill all the reanimated bits. Therefore without considering the extra hauling labor, battle axe is the superior solution to reanimated corpse.

War hammers can be preferable to maces when fighting living enemies that you don't want to resurrect. Killing a living enemy with a war hammer will usually result in a mangled corpse just like in the case of maces, but a war hammer will deal more damage due to its superior ability to penetrate outer layers and damage internal organs and bones, as well as better ability to stun enemies. An axe can still kill unarmored living creatures faster, but it will cut off limbs and head which can later resurrect. Resurrected body parts are often easy to kill, even for unarmed dwarves (although sometimes they are significantly stronger, such as a resurrected neck killing multiple dwarves), but can generate job cancellation spam and unhappy thoughts from being attacked by the dead. Also, resurrected body parts may need to be killed many times before they are mangled, even when using maces or war hammers.

==== vs. Undead megabeast and other large fleshy creatures ====

** recommended weapon if has access to steel: large army with steel spears.
** recommended weapon if has access to adamantine: adamantine axe.
** unrecomended weapon: anything inferior than steel.

The result varies between axe, spear and sword. When a squad of 4 armored dwarves fight an undead cyclops with metal inferior to adamantine, only the ones armed with steel spears have a chance of winning. The squads with axe, mace and sword stand no fighting chance.

With an adamantine weapon, however, axe and sword outperforms spear. Even one grandmaster axedwarf with an adamantine axe stands a chance to defeat the undead cyclops.

==== vs. others ====
This category consists of the rare "not like anything else" creature, the type you get when you breach the [[cavern]]s or [[magma]] (or deeper), or once your fortress is large enough to get their attention.

* recommended weapon: (varies)
* other choices: any steel axe (depending), crossbow (from behind fortifications), whip

There are many different types here, and no one approach works for all. Some are merely gigantic but (more or less) "normal", but many are non-organic, and most enjoy the "[[No Pain|don't feel pain]]" tag, including [[titan]]s, [[forgotten beast]]s, [[bronze colossus]]es, [[Iron man|iron men]], and [[HFS|hidden fun stuff]]. Many of these enemies ''have'' no internal organs while being huge, weakening the effectiveness of pain and pierce. Some are still flesh and blood, and they're functionally like unarmored wildlife, but some are made from some material that may be very difficult to slash at.* In the worst case of being made of steel, it leaves chipping away at the target until they collapse from cumulative damage, which means either penetrating a LOT of armor (warhammer or ideally whip) or breaking everything (mace). Some few megabeasts are metal (e.g. [[bronze colossus]]), and the "superior metal" rule goes ''strongly'' in effect there - use steel sharp weapons for them, though whip would be best if you don't have those.

(* although a forgotten beast made of, for instance, "mud" is laughably easy to kill)

Ranged attacks are useful for taking care of the ones who are unapproachable themselves while being incredibly fragile. And at the very least, you're at less risk when raining down bolts from above, even if it won't do much damage.

==== Final verdict ====
Now, all that said, overall, if you had to choose one "least worst" weapon, it would probably have to be... the steel short sword. It has no true counters, no enemy it cannot ever defeat - while axes falls to iron men and copper armor and maces/hammers/spears falls to big creatures. If you cannot get steel, a second option would be the goblin-made whip, which is still somewhat effective against bronze colossuses and big beasts, and maces and hammers will always be effective no matter what they're made of.

Outside that, for edged/piercing weapons (axe, spear, bolts, and sword) against unarmored (and non-"unusual" targets) any metal will be overpowered, easily cutting/chopping/piercing all equally. Soft targets aside, make edged/piercing weapons out of the best metal you can (steel > iron > bronze > copper > silver) for use against armor, if/when you meet that. Crushing weapons (in order: hammer, mace, and crossbow in melee) can be any metal, steel being quite a bit better for untrained dwarves, and silver being the best for trained dwarves. If you want to add megabeasts into the consideration, go with steel to be safe, for any weapon type.

= Technical =
From here down, there are tables of values pulled from the raws, some technical analyses, a few statistical observations, and some solid and speculative inferences and conclusions.

Insert obligatory "math warning" here.

== Weapons ==
=== Native weapons ===
{| class="wikitable" border="border"
! Type
! Graphic
! Size
! Attack
! [[Attack type]]
! Contact Area
! Penetration
! Velocity
! Skill Used
! Hands Used
! [[Weaponsmith|Metal]]
! [[Bowyer|Wood]]
! [[Bowyer|Bone]]
! [[Stone crafter|Obsidian]]
|- valign="top"
|rowspan="3"| [[battle axe|Battle Axe]]
|rowspan="3"| [[File:battle_axe_sprite.png]]
|rowspan="3"| 800
| Hack || Edge || 40000 || 6000 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| one
|rowspan="3"| Yes
|rowspan="3"| No
|rowspan="3"| No
|rowspan="3"| No
|-
| Flat slap || Blunt || 40000 || (6000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|-
| [[Crossbow]] (Melee)
| [[File:crossbow_sprite.png]]
| 400
| Bash || Blunt || 10000 || (4000) || 1.25×
| Hammer
| two
| Yes
| Yes
| Yes
| No
|-
| [[Mace]]
| [[File:mace_sprite.png]]
| 800
| Bash || Blunt || 20 || (200) || 2.0×
| Mace
| one
| Yes
| No
| No
| No
|-
| [[Pick]] (foreign)
| [[File:pickaxe_sprite.png]]
| 500
| Strike || Edge || 100 || 4000 || 2.0×
| Mining
| one
| Yes
| No
| No
| No
|- valign="top"
|rowspan="4"| [[short sword|Short Sword]]
|rowspan="4"| [[File:short_sword_sprite.png]]
|rowspan="4"| 300
| Slash || Edge || 20000 || 4000 || 1.25×
|rowspan="4"| Sword
|rowspan="4"| one
|rowspan="4"| Yes
|rowspan="4"| No
|rowspan="4"| No
|rowspan="4"| Yes
|-
| Stab || Edge || 50 || 2000 || 1.0×
|-
| Flat slap || Blunt || 20000 || (4000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
|rowspan="2"| [[Spear]]
|rowspan="2"| [[File:spear_sprite.png]]
|rowspan="2"| 400
| Stab || Edge || 20 || 10000 || 1.0×
|rowspan="2"| Spear
|rowspan="2"| one
|rowspan="2"| Yes
|rowspan="2"| No
|rowspan="2"| No
|rowspan="2"| No
|-
| Shaft bash || Blunt || 10000 || (6000) || 1.25×
|-
| [[war hammer|War Hammer]]
| [[File:war_hammer_sprite.png]]
| 400
| Bash || Blunt || 10 || (200) || 2.0×
| Hammer
| one
| Yes
| No
| No
| No
|}

Note that although the [[pick]] is a foreign weapon, it can be produced by dwarves and is therefore considered native.{{bug|680}}

=== Details ===
*If you find your dwarves wearing more than one weapon – or any unwanted [[armor]], for that matter – one way to get rid of them is to dump the weapon from their {{k|v}}-{{k|i}} inventory screen. This does not always work, as they might re-equip the item. Another option is to remove any weapons and/or shields listed on their military equip screen. This too does not always work. At least "left-handedness" seems to not pose a problem. If you cancel the work by {{k|v}}-{{k|p}} and selecting a job that needs a tool they will sometimes put it back in the pile. Example: Miners use picks, cancel their mining job and they will put the pick away AFTER you ordered it to be dumped.
* Using weapons is much more effective than unarmed combat – an untrained swordsdwarf with an [[iron]] weapon can defeat a grand master [[wrestler]], provided neither is wearing armor. Larger weapons tend to do more damage due to the [[Material science#Attack Momentum|momentum formula]]
* The size for a weapon is its volume in cm3.
* Attacks of type EDGE will either slice or pierce their target, depending on the contact area and penetration depth, while BLUNT attacks tend to damage internal organs without necessarily causing significant damage to outer layers.
* The contact area represents the area of contact of the weapon, and the penetration determines how deep the attack goes (and is apparently ignored entirely for BLUNT attacks – indicated by numbers in parentheses). The game does not distinguish between "piercing" and "slashing" attacks, despite this page using those terms often--the only difference is that piercing weapons have small contact area and slashing ones have large contact area. Penetration tends to be the same between either, but large contact area makes it much more difficult for weapons to get through armor--armor that a spear can barely pierce would require '''400 times''' as much momentum for an axe to pierce.
* The velocity is a direct multiplier on the attack's [[Material science#Attack Momentum|momentum]] - for example, war hammers have a 2x velocity multiplier, presumably to model the fact that the hammer's mass is concentrated at the tip which, when combined with a long handle, permits swinging it harder than a weapon whose mass is evenly distributed (such as a sword).
* Crossbows can be made of metal, wood, and bone. Metal crossbows are made by a [[weaponsmith]] at a [[forge]], while wood and bone crossbows are made by a [[bowyer]] at a [[bowyer's workshop]]. The material of a crossbow does not affect its firing ability, only its melee damage. A dwarf's marksmanship skill is only affected by the core [[item quality|quality]] of the bow. This may be a consideration when deciding which dwarf you want outfitting your marksdwarves: a [[experience|legendary]] bowyer is a better choice than a proficient weaponsmith.
* Dwarves will never select a pick for a weapon if allowed "individual choice." You must specify picks as part of their uniform, or on the individual equip screen, if you wish to utilize them as weapons.

=== Training weapons ===
All [[training weapon]]s must be made of [[wood]] at the [[carpenter's workshop]].

{| class="wikitable" border="border"
|-
! Type
! Graphic
! Size
! Attack
! [[Attack type]]
! Contact Area
! Penetration
! Velocity
! Skill Used
|- valign="top"
|rowspan="3"| Training Axe
|rowspan="3"| [[File:training_axe_sprite.png]]
|rowspan="3"| 800
| Hack || Blunt || 30000 || (6000) || 1.25×
|rowspan="3"| Axe
|-
| Flat slap || Blunt || 30000 || (6000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
|rowspan="4"| Training Sword
|rowspan="4"| [[File:training_sword_sprite.png]]
|rowspan="4"| 300
| Slash || Blunt || 20000 || (4000) || 1.25×
|rowspan="4"| Sword
|-
| Stab || Blunt || 50 || (2000) || 1.0×
|-
| Flat slap || Blunt || 20000 || (4000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
|rowspan="2"| Training Spear
|rowspan="2"| [[File:training_spear_sprite.png]]
|rowspan="2"| 400
| Stab || Blunt || 200 || (10000) || 1.0×
|rowspan="2"| Spear
|-
| Shaft bash || Blunt || 10000 || (6000) || 1.25×
|}

=== Foreign weapons ===
Using any multi-grasp weapon in a single hand (i.e. with a shield in the other hand) without being of the proper size/broadness (which dwarves in Fortress Mode almost never are), gives you a disability to hit - do not equip two-handed swords with a shield, for instance. '''The game will not stop you from doing this''', so be wary about it.

In Adventurer Mode, however, if your character passes the one-handed check for single-handing a multi-grasp weapon, it is possible to wield a two-handed sword, or any multi-grasp weapon, in one hand without penalty (allowing for the simultaneous use of a shield). For example, if you create a human character, and manage to spawn into a world with a "broad body" or a "tall body" in the character description, you will be able to single-hand any multi-grasp weapon (and will be forced to, much like you are forced to single-hand any single-grasp weapon), which allows for the simultaneous, disability-free use of a shield, thus making your damage and defensive capabilities much higher than they would be with a single-grasp weapon and shield. Note that upping Strength to Superior (and eventually Superhuman) will make all attacks more likely to deal extra damage, making cutting off the limbs of your enemies much easier.

{| class="wikitable" border="border"
|-
! Type
! Graphic
! Size
! Attack
! [[Attack type]]
! Contact Area
! Penetration
! Velocity
! Skill Used
! Used by
! Hands Used (average human)
|- valign="top"
|rowspan="4"| [[Two-handed sword]]
|rowspan="4"| [[File:two_handed_sword_sprite.png]]
|rowspan="4"| 900
| Slash || Edge || 100000 || 8000 || 1.25×
|rowspan="4"| Sword
|rowspan="4"| [[Goblin]], [[Human]]
|rowspan="4"| Multi-grasp
|-
| Stab || Edge || 50 || 4000 || 1.0×
|-
| Flat slap || Blunt || 100000 || (8000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
| [[Blowgun]] (Melee)
| [[File:blowgun_sprite.png]]
| 150
| Bash || Blunt || 10000 || (4000) || 1.25×
| Sword
| Subterranean [[animal people]]
| Single-grasp
|- valign="top"
| [[Bow]] (Melee)
| [[File:bow_sprite.png]]
| 300
| Bash || Blunt || 10000 || (4000) || 1.25×
| Sword
| [[Elf]], [[Goblin]], [[Human]], [[Kobold]]
| Single-grasp
|- valign="top"
| [[Flail]]
| [[File:flail_sprite.png]]
| 500
| Bash || Blunt || 200 || (4000) || 2.5×
| Mace
| [[Goblin]], [[Human]]
| Single-grasp
|- valign="top"
|rowspan="3"| [[great axe|Great Axe]]
|rowspan="3"| [[File:great_axe_sprite.png]]
|rowspan="3"| 1300
| Hack || Edge || 60000 || 8000 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| [[Goblin]], [[Human]]
|rowspan="3"| Multi-grasp
|-
| Flat slap || Blunt || 60000 || (8000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
|rowspan="3"| [[Halberd]]
|rowspan="3"| [[File:halberd_sprite.png]]
|rowspan="3"| 1200
| Slash || Edge || 20000 || 8000 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| [[Goblin]], [[Human]]
|rowspan="3"| Multi-grasp
|-
| Stab || Edge || 50 || 2000 || 1.0×
|-
| Shaft bash || Blunt || 20000 || (6000) || 1.25×
|- valign="top"
|rowspan="3"| [[Dagger]] (Large)
|rowspan="3"| [[File:dagger_sprite.png]]
|rowspan="3"| 200
| Slash || Edge || 1000 || 800 || 1.25×
|rowspan="3"| Dagger
|rowspan="3"| [[Goblin]], [[Kobold]]
|rowspan="3"| Single-grasp
|-
| Stab || Edge || 5 || 1000 || 1.0×
|-
| Pommel strike || Blunt || 20 || (600) || 1.0×
|- valign="top"
|rowspan="4"| [[long sword|Long Sword]]
|rowspan="4"| [[FIle:long_sword_sprite.png]]
|rowspan="4"| 700
| Slash || Edge || 60000 || 6000 || 1.25×
|rowspan="4"| Sword
|rowspan="4"| [[Elf]], [[Goblin]], [[Human]]
|rowspan="4"| Single-grasp
|-
| Stab || Edge || 50 || 3000 || 1.0×
|-
| Flat slap || Blunt || 60000 || (6000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
| [[Maul]]
| [[File:maul_sprite.png]]
| 1300
| Bash || Blunt || 100 || (6000) || 2.0×
| Hammer
| [[Goblin]], [[Human]]
| Multi-grasp
|- valign="top"
|rowspan="2"| [[Morningstar]]
|rowspan="2"| [[File:morningstar_sprite.png]]
|rowspan="2"| 500
| Bash || Edge || 10 || 500 || 2.0×
|rowspan="2"| Mace
|rowspan="2"| [[Goblin]], [[Human]]
|rowspan="2"| Single-grasp
|-
| Pommel strike || Blunt || 50 || (1000) || 1.0×
|- valign="top"
|rowspan="2"| [[pike (weapon)|Pike]]
|rowspan="2"| [[File:pike_weapon_sprite.png]]
|rowspan="2"| 800
| Stab || Edge || 20 || 12000 || 1.0×
|rowspan="2"| Pike
|rowspan="2"| [[Goblin]], [[Human]]
|rowspan="2"| Multigrasp
|-
| Shaft bash || Blunt || 10000 || (6000) || 1.25×
|- valign="top"
|rowspan="4"| [[Scimitar]]
|rowspan="4"| [[File:scimitar_sprite.png]]
|rowspan="4"| 300
| Slash || Edge || 20000 || 4000 || 1.25×
|rowspan="4"| Sword
|rowspan="4"| [[Goblin]], [[Human]]
|rowspan="4"| Single-grasp
|-
| Stab || Edge || 50 || 2000 || 1.0×
|-
| Flat slap || Blunt || 20000 || (4000) || 1.25×
|-
| Pommel strike || Blunt || 50 || (1000) || 1.0×
|- valign="top"
| [[Scourge]]
| [[File:scourge_sprite.png]]
| 300
| Lash || Edge || 10 || 50 || 2.0×
| Whip
| [[Goblin]]
| Single-grasp
|- valign="top"
| [[Whip]]
| [[File:whip_sprite.png]]
| 100
| Lash || Blunt || 1 || (10) || 5.0×
| Whip
| [[Goblin]], [[Human]]
| Single-grasp
|- valign="top"
|rowspan="3"| Stone axe
|rowspan="3"|[[File:stone_axe_sprite.png]]
|rowspan="3"| 400
| Hack || Edge || 800 || 400 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| Player in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Slap|| Blunt || 800|| 400 || 1.25×
|-
| Strike || Blunt || 20|| 400 || 1.0×
|- valign="top"
|rowspan="3"| Carving knife
|rowspan="3"|[[File:carving_knife_sprite.png]]
|rowspan="3"| 150
| Slash || Edge || 800 || 600 || 1.25×
|rowspan="3"| Dagger
|rowspan="3"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Stab || Edge || 4 || 800 || 1.0×
|-
| Strike|| Blunt || 15|| 400 || 1.0×
|- valign="top"
|rowspan="3"| Boning knife
|rowspan="3"|[[File:boning_knife_sprite.png]]
|rowspan="3"| 50
| Slash || Edge || 500 || 300 || 1.25×
|rowspan="3"| Dagger
|rowspan="3"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Stab || Edge || 2 || 400 || 1.0×
|-
| Strike|| Blunt || 10 || 200 || 1.0×
|- valign="top"
|rowspan="3"| Slicing knife
|rowspan="3"|[[File:slicing_knife_sprite.png]]
|rowspan="3"| 150
| Slash || Edge || 900 || 700|| 1.25×
|rowspan="3"| Dagger
|rowspan="3"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Stab || Edge || 3 || 900 || 1.0×
|-
| Strike|| Blunt || 15 || 400 || 1.0×
|- valign="top"
|rowspan="3"| Meat cleaver
|rowspan="3"|[[File:meat_cleaver_sprite.png]]
|rowspan="3"| 300
| Hack|| Edge || 800 || 400 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Clap || Blunt || 800 || 400 || 1.25×
|-
| Strike || Blunt || 20 || 400 || 1.0×
|- valign="top"
|rowspan="2"| Carving fork
|rowspan="2"| [[File:carving_fork_sprite.png]]
|rowspan="2"| 150
| Stab|| Edge || 1 || 100 || 1.0×
|rowspan="2"| Dagger
|rowspan="2"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="2"| Single-grasp
|-
| Strike || Blunt || 15 || 400 || 1.0×
|}

===Special variations===
Some rare entities have their own [[divine equipment|procedurally generated variations]] of weapons. Currently, these weapons are produced by copying the default properties of the "base" weapon, and adding an adjective ("bulky", "large-headed", "branching", etc.) or renaming the weapon altogether ("blade", "curved sword"). Dwarves in [[strange mood]]s which select from all weapons with a certain tag may produce one of these procedurally generated weapons. Since they retain the properties of their base items, these weapons should be as usable as a standard weapon of the base type.

== Size ==

Weapons have a minimum size to use at all, and a minimum size to use one-handed. Adult dwarves vary in size between 33750 and 93750 (average 60000) based on their height and broadness. Unfortunately, this is currently bugged in fortress mode.{{Bug|0005812}} 'One-handed' vs. 'two-handed' checks are performed correctly, but 'can wield' vs. 'can't wield' ignores height and broadness modifiers. So dwarves in fortress mode will never equip two-handed swords, great axes, halberds, mauls, or pikes. Other weapons have a minimum wielding size of less than 60000, and are wielded one-handed if the individual dwarf is large enough. See [http://www.bay12forums.com/smf/index.php?topic=119068.msg3790913#msg3790913 this] forum post.

The following table shows approximately how many dwarves ''should be'' able to use each weapon one- or two-handed (see [http://www.bay12forums.com/smf/index.php?topic=101379.msg3029579#msg3029579 this forum post] for details), with all fractional numbers being approximate. While there are seven categories each for height and broadness, the number used is chosen randomly from within each category.

Note that there are other factors (such as fat and muscle mass) affecting dwarf size, and e.g. [[DFHack]] {{k|Alt}}+{{k|I}} will take them into account, but (at least in adventure mode) only base height and broadness appear to determine weapon wieldability.

Additionally, even if a creature is large enough to wield a weapon with one hand/appendage, it is still possible to wield it with both/more through [[Wrestling#Bugs|wrestling]] by first lodging it into a target, then grabbing it with a free hand/appendage, and then pulling it free.

Where the size checking bug affects weapon wielding for dwarves, correct approximate figures are given in brackets.
{| class="wikitable sortable" border="border"
|-
! Type
! Min Size
(Two-Handed)
! Min Size
(One-Handed)
! Dwarves
Can't Wield
! Dwarves Wield
Two-Handed
! Dwarves Wield
One-Handed
|- valign="top"
| [[battle axe|Battle Axe]]
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| [[Crossbow]] (Melee)
| 15000
| 0
| -
| -
| 49/49
|- valign="top"
| [[Mace]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| [[Pick]]
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| [[short sword|Short Sword]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| [[Spear]]
| 5000
| 47500
| -
| 11/49
| 38/49
|- valign="top"
| [[war hammer|War Hammer]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| Training Axe
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| Training Sword
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| Training Spear
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| [[two-handed sword|2H Sword]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Blowgun]] (Melee)
| 15000
| 0
| -
| -
| 49/49
|- valign="top"
| [[Bow]] (Melee)
| 15000
| 0
| -
| -
| 49/49
|- valign="top"
| [[Flail]]
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| [[great axe|Great Axe]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Halberd]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Dagger]] (Large)
| 5000
| 27500
| -
| -
| 49/49
|- valign="top"
| [[long sword|Long Sword]]
| 52500
| 57500
| 11/49 (0)
| 7/49 (18/49)
| 31/49
|- valign="top"
| [[Maul]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Morningstar]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| [[pike (weapon)|Pike]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Scimitar]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| [[Scourge]]
| 22500
| 27500
| -
| -
| 49/49
|- valign="top"
| [[Whip]]
| 22500
| 27500
| -
| -
| 49/49
|}

==Material==

Weapons and armor (with a few exceptions) can only be forged from weapon-grade metals (adamantine, steel, iron, silver, bronze, bismuth bronze, copper, and divine metal), wood, or bone. The exceptions include obsidian short-swords and items created during a strange mood.

{{v0.31 material metal table head}}

{{v0.31 material metal table row|name=Adamantine|color={{Tile|/|3:1}}3:3:1|source=[[Raw adamantine]]|notes= |soliddensity=0.200|mp=25000|val=300|valinc=+50|impactyield=5000|impactfracture=5000|impactelasticity=0|shearyield=5000|shearfracture=5000|shearelasticity=0
}}

{{v0.31 material metal table row|name=Divine metal|notes= |soliddensity=1.0|val=300|impactyield=1000|impactfracture=2000|impactelasticity=0|shearyield=1000|shearfracture=2000|shearelasticity=0
}}

{{v0.31 material metal table row|name=Steel|color={{Tile|/|0:1}}0:7:1|source=[[Iron]] + [[Pig iron]] + [[flux]] stone + [[fuel]] '''!'''|notes= |soliddensity=7.85|val=30|valinc=+20|mp=12718|impactyield=1505|impactfracture=2520|impactelasticity=940|shearyield=430|shearfracture=720|shearelasticity=215
}}

{{v0.31 material metal table row|name=Bismuth bronze|color={{Tile|/|6:1}}6:6:1|source=2 [[Copper]] + 1 [[Tin]] + 1 [[Bismuth]] '''!'''|notes= |soliddensity=8.25|val=6|valinc=+4|mp=11868|impactyield=602|impactfracture=843|impactelasticity=547|shearyield=172|shearfracture=241|shearelasticity=156
}}

{{v0.31 material metal table row|name=Bronze|color={{Tile|/|6:0}}6:4:0|source=[[Tin]] + [[Copper]]|notes= |soliddensity=8.25|val=5|valinc=+3|mp=11868|impactyield=602|impactfracture=843|impactelasticity=547|shearyield=172|shearfracture=241|shearelasticity=156
}}

{{v0.31 material metal table row|name=Iron|color={{Tile|/|0:1}}0:7:1|source=[[Hematite]], [[Limonite]], [[Magnetite]]|notes= |soliddensity=7.85|mp=12768|val=10|valinc=+2|impactyield=542|impactfracture=1080|impactelasticity=319|shearyield=155|shearfracture=310|shearelasticity=189
}}

{{v0.31 material metal table row|name=Copper|color={{Tile|/|6:0}}6:4:0|source=[[Native copper]], [[Malachite]], [[Tetrahedrite]]|notes= |soliddensity=8.93|mp=11952|val=2|valinc=+0, +0, -1*|impactyield=245|impactfracture=770|impactelasticity=175|shearyield=70|shearfracture=220|shearelasticity=145
}}

{{v0.31 material metal table row|name=Silver|color={{Tile|/|7:1}}7:7:1|source=[[Native silver]], [[Horn silver]], [[Galena]] (50%), [[Tetrahedrite]] (20%) |notes= |soliddensity=10.49|mp=11731|val=10|valinc=+0, +0, +5*, +7*|impactyield=350|impactfracture=595|impactelasticity=350|shearyield=100|shearfracture=170|shearelasticity=333
}}

{{v0.31 material metal table row|name=Platinum|color={{Tile|/|7:1}}7:7:1|source=[[Native platinum]]|notes= Only available as artifact weapons.|soliddensity=21.4|mp=13182|val=40|valinc=+?, +?, +?, +?|impactyield=350|impactfracture=700|impactelasticity=152|shearyield=100|shearfracture=200|shearelasticity=164
}}

{{v0.31 material metal table row|name=Bone|color={{Tile|/|7:1}}7:7:1|source=Creatures|notes= |soliddensity=0.50|mp=NONE(burn at 10250)|val=1|valinc=+?, +?, +?, +?|impactyield=200|impactfracture=200|impactelasticity=100|shearyield=115|shearfracture=130|shearelasticity=100
}}

{{v0.31 material metal table row|name=Wood|color={{Tile|/|6:0}}7:7:1|source=Trees|notes= |soliddensity=0.50|mp=NONE(burn at 10250)|val=1|valinc=+?, +?, +?, +?|impactyield=10|impactfracture=10|impactelasticity=1000|shearyield=40|shearfracture=40|shearelasticity=1000
}}

{{v0.31 material metal table row|name=Shell|color={{Tile|/|2:0}}7:7:1|source=Creatures|notes= Only available as artifact weapons.|soliddensity=0.50|mp=NONE(burn at 10250)|val=1|valinc=+?, +?, +?, +?|impactyield=200|impactfracture=200|impactelasticity=100|shearyield=115|shearfracture=130|shearelasticity=100
}}

{{v0.31 material metal table row|name=Leather|color={{Tile|/|2:0}}7:7:1|source=Creatures|notes= Material data added for comparison.|soliddensity=0.50|mp=NONE(burn at 10250)|val=1|valinc=+?, +?, +?, +?|impactyield=10|impactfracture=10|impactelasticity=50000|shearyield=25|shearfracture=25|shearelasticity=50000
}}

{{v0.31 material metal table row|name=Obsidian|color={{Tile|/|0:1}}7:7:1|source=Lava|notes= Only available for Short Swords.|soliddensity=2.67|mp=13600|val=3|valinc=+0|impactyield=1000|impactfracture=1000|impactelasticity=2222|shearyield=35|shearfracture=35|shearelasticity=114
}}

{{v0.31 material metal table row|name=Crystal glass|color={{Tile|/|7:1}}7:7:1|source=Sand|notes= Only available as trap components.|soliddensity=2.6|mp=13600|val=10|valinc=+0|impactyield=1000|impactfracture=1000|impactelasticity=2222|shearyield=33|shearfracture=33|shearelasticity=113
}}

{{v0.31 material metal table row|name=Clear glass|color={{Tile|/|3:0}}7:7:1|source=Sand|notes= Only available as trap components.|soliddensity=2.6|mp=13600|val=5|valinc=+0|impactyield=1000|impactfracture=1000|impactelasticity=2222|shearyield=33|shearfracture=33|shearelasticity=113
}}

{{v0.31 material metal table row|name=Green glass|color={{Tile|/|2:0}}7:7:1|source=Sand|notes= Only available as trap components.|soliddensity=2.6|mp=13600|val=2|valinc=+0|impactyield=1000|impactfracture=1000|impactelasticity=2222|shearyield=33|shearfracture=33|shearelasticity=113
}}

|}

*''Combat information'' is used internally by the game to determine the combat properties of weapons and armor made from this metal:
**'''Density''': Used in conjunction with other factors - heavier weapons (higher numbers) hit with a bit more force, very light weapons tend to have less penetration. Value shown here is g/cm3, which is the raw value divided by 103
**'''Impact yield''': Used for blunt-force combat; ''higher'' is better for blunt weapons, but ''lower'' is better for armor. This is the raw value divided by 103 (i.e., kPa).
**'''Impact fracture''': Used for blunt-force combat; ''higher'' is better. This is the raw value divided by 103 (i.e., kPa).
**'''Impact elasticity''' (or '''strain at yield'''): Used for blunt-force combat; ''lower'' is better. This is the raw value.
**'''Shear yield''': Used for cutting calculations in combat; ''higher'' is better. This is the raw value divided by 103 (i.e., kPa).
**'''Shear fracture''': Used for cutting calculations in combat; ''higher'' is better. This is the most important indicator of edged strength. This is the raw value divided by 103 (i.e., kPa).
**'''Shear elasticity''' (or '''strain at yield'''): Used for cutting calculations in combat; ''lower'' is better. This is the raw value.

*General Term Explanations (from Wikipedia)
**'''Yield Strength''' - The stress at which material strain changes from elastic deformation to plastic deformation, causing it to deform permanently.
**'''Fracture Strength''' - The stress coordinate on the stress-strain curve at the point of rupture.
**'''Stress''' - Force per area = F/A
**'''Strain''' - Deformation of a solid due to stress = Stress/Young's Modulus

=== Explanation ===
* '''Yield Strength''' is the amount of stress required to permanently deform (bend) a material (plastic deformation).
* '''Fracture Strength''' is the amount of stress required to permanently break (rupture) a material.
* '''Elasticity''' or '''Strain at yield''' is the amount of deformation (bending) that occurs at the yield point.

=== Implications ===
Yield strength combined with strain at yield can tell what a material will do under stress (be it from a hammer, axe, or arrow); higher yield means that it takes more stress to deform, while lower strain at yield means that it will deform less when stress is applied.

== Combat formulae ==

Penetration is poorly understood, but most of the rest of combat is fairly well understood. Maybe it defines how deep a blade may go through layers of armor and flesh and bones and even cut off limbs. This may explain why it does not apply for blunt attacks that do not go through layers.

First, you need to calculate your weapon's momentum.

Melee Weapon Momentum: M = Skill * Size * Str * Vel / (106 * (1 + i_Size/(w_density*w_size) ))
* Dwarf Melee Momentum: M = 0.06 * Str * Vel / (1 + i_Size/(w_density*w_size) )
* Quick attacks halve melee momentum, wild and heavy attacks multiply it by 1.5
* Attacking a prone opponent in melee doubles momentum.

Ranged Weapon Momentum: M = (w_density*w_size)/105 * min(105*(SHOOT_FORCE/20)/(w_density*w_size), SHOOT_MAXVEL/10)
* Bow and Crossbow Momentum: M = (w_density*150)/105 * min(105/(w_density*3), 20)
** If 20 is smaller because the ammunition is density 1666 or less, M = w_density*3/100 = w_density*0.03
** If 20 is larger because the ammunition is density 1667 or larger, M = 50
* Blowgun Momentum: M = (w_density*20)/105 * min(105/(w_density*4), 100)
** If 100 is smaller because the ammunition is density 250 or less, M = w_density/50 = w_density*0.02
** If 100 is larger because the ammunition is density 251 or more, M = 5

where:
* '''M''' is the momentum.
* '''Skill''' is a gradual multiplier based on skill level, from 1x base up to 2x at Grand Master.
* '''Str''' is the creature's strength (e.g. 1250 for the average dwarf)
* '''Vel''' is the weapon's velocity modifier if present (e.g. 1.25x, 2x)
* '''Size''' is the average creature size (e.g. 60000 for dwarves)
* '''i_Size''' is the specific creature's size
** Dwarves range from a minimum size of 33750 to a maximum size of 93750, with an average size of 60000.
* '''w_density''' is the weapon's material's density for melee weapons, or the ammunition's density for ranged weapons
* '''w_size''' is the weapon's size for melee weapons, or the ammunition's size for ranged weapons
* '''SHOOT_FORCE''' is the ranged weapon's SHOOT_FORCE constant, which is used to determine its maximum momentum.
* '''SHOOT_MAXVEL''' is the ranged weapon's SHOOT_MAXVEL constant, which is used to determine its maximum velocity, where ammo momentum = ammo mass * ammo velocity.

An edged weapon undergoes the following comparison:

M >= (aSY/wSY + (A+1)*aSF/wSF) * (10 + 2*a_quality) / (Sha * w_quality),

where:
* '''aSY''' is the armor's SHEAR_YIELD, which is based on its material
* '''wSY''' is the weapon's SHEAR_YIELD, which is based on its material
* '''aSF''' is the armor's SHEAR_FRACTURE, which is based on its material
* '''wSF''' is the weapon's SHEAR_FRACTURE, which is based on its material
* '''A''' is attack [[Material science#Contact_Area|contact area]]
* '''Sha''' is weapon material [[edge|sharpness]] multiplier (1x for most metals, 1.2x for [[divine metal]], 1.5x for [[glass]], 2x for [[obsidian]], 10x for [[adamantine]] and 0.1x for all other materials)
* '''w_quality''' is weapon [[quality]] sharpness multiplier (0.5x for normal quality, 0.7x for fine, 1x for masterwork, etc.)
* '''a_quality''' is armor [[quality]] multiplier

Expressed in the above terms,

* 0.06 * Str * Vel / (1 + i_Size/(w_density*w_size)) >= (aSY/wSY + (A+1)*aSF/wSF) * (10 + 2*Qa) / (Sha * w_quality)
* 0.06 * Sha * w_quality * Str * Vel / (1 + i_Size/(w_density*w_size)) >= (aSY/wSY + (A+1)*aSF/wSF) * (10 + 2*a_quality)
* 0.06 * Sha * w_quality * Str * Vel / ((1 + i_Size/(w_density*w_size)) * (10 + 2*a_quality)) >= aSY/wSY + (A+1)*aSF/wSF

Because Shear Yield and Shear Fracture are always within a power of 10 of each other for actually available materials, but the smallest possible A value is 20 (a blowgun dart, which is smaller than the smallest item of clothing/armor a dwarf can wear), this means that in practice, Shear Fracture is significantly more important than Shear Yield, and you can reliably compare weapons and armor without paying attention to Shear Yield. In both cases, higher is better on both weapons and armor, as is quality. Sharpness only matters to the weapon, and smaller contact area is better for the attacker.

If the test is passed, attack momentum is decreased by some 5% and the layer is considered punctured/severed, and the process continues to the next layer, including working through layers of the defender's body. If the test is failed, the attack becomes blunt for this layer.

If the attack is blunt, either due to starting off blunt or due to failing the above test, it is then subjected to this test:

2 * w_size * wIY > A * a_density

where:
* '''a_density''' is the armor material's density
* '''wIY''' is the weapon's impact yield in MPa (i.e. raw value divided by 106). {{verify}}

Failure means the attack bounces off, meaning denser, larger armor resists blunt attacks better, but larger blunt weapons with smaller contact areas and higher impact yields get through armor better. This also means adamantine armor is some of the worst in the game at outright deflecting attacks, due to its poor density, but this is not typically relevant, as impact yields are typically at least 10 times larger than density values for the actual metals available, so this step is routinely passed by most weapons regardless of relative materials.

On success, the following test is applied:

M >= (2*aIF - aIY) * (2 + 0.4*a_quality) * A,

where:
* '''aIF''' is the armor's impact fracture in MPa (i.e. raw value divided by 106)
* '''aIY''' is the armor's impact yield in MPa (i.e. raw value divided by 106).

Note that the armor wants as high impact fracture as possible to make this test fail. The armor also wants low impact yield, although the weapon's impact fracture does not matter, and high quality and high contact area.

On a success, attack momentum is decreased by some 5% and the layer is considered punctured/severed, and the process continues to the next layer, including working through layers of the defender's body. If the attack was edged, it becomes edged again. On a failure, the momentum is multiplied by SHEAR_STRAIN_AT_YIELD/50000 for edged attacks or IMPACT_STRAIN_AT_YIELD/50000 for blunt attacks, then it becomes *permanently* blunt, and is passed on to the next layer. This means most rigid metal armor will reduce blocked attacks by 98%-99%, but elastic armor, such as a mail shirt, has both strain at yield values raised to 50000, so it multiplies by 1 at this step (i.e. does nothing to the momentum, but does still convert it to blunt) regardless of material.

== Combat testing ==
In regards to edged weaponry: [[adamantine]] and [[steel]] take first and a distant second place respectively, with [[iron]] a slightly less distant third best material in the game, nearly matched by the [[bronze]]s. Beyond that is [[copper]], the second worst material, and [[silver]] is the worst weapon material available (and due to the existence of training weapons, not even useful in that regard).

Additionally, with regards to blunt weapons, almost all of the non-adamantine materials perform equally well, with a very slight edge towards steel and silver. Here is the thread with the details: [http://www.bay12forums.com/smf/index.php?topic=53571.0].

Keep in mind that, given how unbelievably complicated this system is, very little should be taken as word of law yet.

{| class="wikitable"
|-
!
! Best
! Better
! Good
! Fair
! Poor
! Terrible
! Notes
|-
| Armor
| Adamantine
| Steel
| Iron
| Bronze, Bismuth Bronze
| Copper
|
|
|-
| Edged Weapons
| Adamantine
| Steel
| Iron
| Bronze, Bismuth Bronze
| Copper
| Silver
| For piercing iron armor, copper is better than bronze, but when piercing copper or bronze armor, bronze is better than copper.
|-
| Ammunition
| Steel, Iron, Bronze, Bismuth Bronze, Copper, Silver
|
| Adamantine
|
|
|
| Adamantine bolts deflect off of adamantine armor, but otherwise their performance is on par with bolts made out of other metals.
|-
| Blunt Weapons
| Platinum, Slade
| Steel, Silver
| Copper, Bismuth Bronze, Bronze, Iron
|
|
| Adamantine
| All six standard weapon metals perform nearly identically. Steel has a slightly higher rate of critical wounds, while silver is slightly more likely to penetrate armor. Platinum (only available as [[artifact]] weapons) has twice the density of silver and several other improved properties, making it the best metal for impact weapons, though very limited in production. Adamantine's light weight makes it a terrible choice for blunt weapons, roughly the same as making a weapon out of [[featherwood]] or cork.
|}

Cross referencing this table with the table at the top of this section seems to indicate that low densities, high impact fractures, and high shear fractures contribute to the killing power of edged weapons.

===Analysis===
Testing of weapons (15 dwarves-versus-15 dwarves combat) in the [[object testing arena]] shows that the best dwarven-made weapon against unarmored humanoids is the battle axe, while the war hammer performs the best against armored targets.

Even in 15×(steel armor+silver war hammer) versus 15×(adamantine armor+adamantine battle axe) matches, hammerdwarves won with less than 50% casualties (mostly one-strike kills). However, when the dwarves in question were without armor or only wearing leather/cloth, the result was inverted — axedwarves won with less than 50% casualties. In battles against megabeasts, 6 silver hammerdwarves were barely able to scratch a [[bronze colossus]] (attacks were glancing away) due to bronze being a better "weapon" material.

This is because silver has the highest solid density of all materials that can regularly be made into weapons by dwarves. Tests show that indeed [[gold]] and [[platinum]] (increasingly dense) do increasing amounts of damage, and that war hammers remain the tool of choice, however they can only be produced by a moody dwarf (and a very lucky one at that).

For more on ranged ammunition see the forum thread [http://www.bay12forums.com/smf/index.php?topic=116151.0 Dwarven Research: A Comparison Study on the Effectiveness of Bolts vs Armors].

More arena tests are available in the [[Main:Military testing|Military testing]] article.

==Bugs==
*Equipping weapons/armor on military is erratic. This is likely due to a single piece of weapons/armor being erroneously assigned to multiple dwarves and seems to occur when dwarves are upgrading their equipment or going on raids. Removing and reassigning equipment for all military dwarves can temporarily fix this problem.{{Bug|535}}
*In the Premium version, the sprite sheets for equipped gear are mostly incomplete. The material of equipped gear is currently distinguished for [[dwarf|dwarves]], for [[elf|elves']] and [[kobold|kobolds']] [[armor]] (including metal armor), and for elves' wooden weapons; everything else has a default, 'gray' color palette.
*The Premium version has placeholder sprites for equipped artifact gear (which can be any material), but these are not used for gear of nonstandard materials spawned in the [[object testing arena]], resulting in creatures that use them appearing un-equipped.

==See also==
* [[User:Shinziril#Weapons_and_Armor|Outstanding research]] on weapons and armor by Shinziril

{{Weapons}}
{{Industry}}
{{Category|Weapons}}

Importing and exporting worlds

2025-11-11T23:51:09Z

Putnam3145: /* Save */

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

Although ''Dwarf Fortress'' is a single-player game, it is still common to incorporate a social aspect into the game. For example, you may have found a great site that you want to share with others, you want to play a save or embark that someone else posted, you're reporting a crash during world generation, or maybe you simply want to back up your world or game. There are two primary methods for importing and exporting worlds in ''Dwarf Fortress'': exchanging the seed, and exchanging the save.

== Seeds ==
{{main|Advanced_world_generation#Seed_values|Advanced_world_generation#Seed_notes|l1=Seed values|l2=Seed notes}}
"Seeds" refers to the 4 specific random strings used to seed the pseudo-random number generator. These values are not sufficient to duplicate a world without the rest of the [[world token|world generation parameters]]. Unfortunately, the historical events during world generation don't currently always happen the same way, and this method is incapable of replicating any events that happened after world generation ended, including any fortresses or adventures. Mods and even parameters can greatly change how a world generates, causing the game to use more or fewer pseudo-random numbers for each step, meaning later steps get a different series of numbers.

===Export===
When the game generates a world, it writes the seeds it used for that world in the <code>gamelog.txt</code> file in the main ''Dwarf Fortress'' folder. Unfortunately, the game doesn't currently provide a full output of the world generation parameters.

===Import===
If the world was generated using [[advanced world generation]] and the parameters were saved, or can otherwise be remembered, then the seeds can be copied into <code>prefs/world_gen.txt</code>, using the proper tokens. They cannot currently be pasted into the game directly, but can be entered manually.

==Save==
{{main|Saved game folder}}
A [[Saved game folder|save folder]] contains all the information on a world, including everything done in it since it was generated. Use this to share an active fortress or adventure, or if previous activity is important, rather than just the pristine unplayed world. In addition to being the more complete way of sharing a world than using seeds, moving a save folder around is also a way to back up your saves while reducing clutter in the {{DFtext|Continue active game|7:2:1}} menu.

Additionally, mods are not included in saves, thus, when sharing a save of a modded game the [[Game_folders_and_files#Mods_folders|installed_mods]] folder should also be included.

===Location===
{{main|Game folders and files}}

The easiest way to get to the save folder is to go into the "files" menu for the relevant save; this is found in the "Files" button to the left of saves. If there's a "Delete" button instead, click on the save itself and you will find the Files button within.

A saved game is all the files in each folder in the <code>save</code> folder, the location of which depends on the [[Settings#Portable_mode|portable mode setting]]; that location can be opened through the {{DFtext|Files|7:0:1}} button next to individual saves and worlds. Saves that existed before the addition of the portable mode setting, or when changing the setting, may still be in the old location.

The <code>save</code> folder contains one or more sub-folders, each one a world, by default named <code>region''#''</code>, and a <code>current</code> folder. The <code>current</code> folder is used to track the changes to the active world while ''Dwarf Fortress'' is running; it is not important unless ''Dwarf Fortress'' is open, and can safely be deleted otherwise.

===Export===
Upload the entire save folder (preferably compressed and maybe renamed to be less generic than <code>region''#''</code>), and the <code>installed_mods</code> folder if applicable, to the [http://dffd.bay12games.com/ Dwarf Fortress File Depot], or some other file host.

===Import===
Extract the archive to a temporary location, ensure the contained save folder has a unique name, renaming it if needed, and move it to the <code>save</code> folder, and the contents of the <code>installed_mods</code> folder, if included, to <code>data\installed_mods</code>, then start ''Dwarf Fortress'' and the save should be available.

{{Category|Guides}}
[[ru:Importing and exporting worlds]]

Dragon

2025-10-20T17:37:30Z

Putnam3145: /* Domestication */

{{Quality|Exceptional|16:09, 7 March 2023 (CST)}}
{{Creaturelookup/0
|image=dragon_sprites.png
|portrait=dragon_portrait.png
|bone=66-110
|tooth=3
|meat=113-173
|fat=42-65
|nail=1
|lung=8-18
|heart=2-4
|intestine=14-27
|liver=4-9
|tripe=4-9
|sweetbread=2-4
|spleen=2-4
|kidney=4-8
|brain=4-8
|skull=1
|skin=scale
|eye=2
|contrib=no
|wiki=yes
}}
{{av}}
{{creaturedesc}}
'''Dragons''' are massive, [[fire]]-breathing [[megabeast]]s who, at their full size, are the [[List_of_creatures_by_adult_size#end_of_list|second largest]] land [[creature]]s in the world (behind the [[giant elephant]]). They are covetous monsters and seek to [[Steals items|steal items]] from your fortresses to bring back to their lairs. Dragons generally pilfer successfully in [[World generation|worldgen]], but when they attack a player fortress, they will simply wipe the place out or die trying.

Dragons are most notable for their ability to quickly and frequently exhale long (20+ tiles) jets of [[dragonfire]], a much-hotter (theoretically {{ct|50000}}, over four times the heat of [[magma]]) version of fire, which can make quick work of any creature caught in its path and can kill even creatures normally immune to fire, though it can be blocked by enemies equipped with [[shield]]s. All dragons are born with Talented [[skill]] in [[Combat skill|fighting, biting, kicking, dodging]] and [[Observer|observing]], which, combined with their size and dragonfire, makes them formidable opponents to an untrained [[military]] [[squad]].

While based on the western dragon model, dragons neither fly nor have wings, and are not intelligent (though there is room to address this; see [[#Irregularities, bugs, and future plans|Bugs and Future Plans]]). They are often described as [http://tvtropes.org/pmwiki/pmwiki.php/Main/GlassCannon glass cannons], as they are not particularly durable and can be defeated somewhat easily with skilled soldiers or [[trap]]s, but only in comparison to their fellow megabeasts; a single dragon can easily wipe out an unprepared fortress. Dragons are associated with the [[sphere]]s of fire and wealth, and their names will often reflect that.

They are not to be confused with the [[cave dragon]]s, a separate, non-megabeast species.

Some dwarves [[preferences|like]] dragons for their ''terrible majesty''.

==Dragon Size==
Dragons slowly grow to become one of the largest creatures in the game, finally reaching their adult size of 25,000,000 cm3 after 1000 years. As a hatchling, dragons are quite tiny, at exactly 1/10th an adult dwarf's size, but they grow very rapidly, at roughly 500,000 cm3 per year until they reach age 10, at which point they slow to 20202 per year. Dragons reach dwarven size shortly after birth, are the size of a draltha at year 5, and become elephant sized by year 10.

*At birth, a dragon is the size of a [[fox]].
*At 2 years, a dragon is the size of a [[water buffalo]].
*At 10 years, a dragon is the size of an [[elephant]] and becomes an adult.
*At 100 years, a dragon is the size of a [[blind cave ogre]].
*At 200 years, a dragon is larger than a [[hydra]].
*At 800 years, a dragon is the size of a [[bronze colossus]] or an adult [[roc]].
*After 1000 years, a dragon is the second largest creature found on land. (The [[giant elephant]] is the largest land creature, while the [[giant sperm whale]] is the largest creature found anywhere.)

==Defense strategies==
Dragonfire can be blocked if the victim is using a shield, and it will be, more than 99% of the time. Though they are among the physically weakest of the megabeasts, dragons are still massively powerful in melee combat, so they can be hard to take down without a good military. They should never be engaged in areas covered in [[grass]] or [[cave moss]], as their breath attacks will cause fire to spread across '''all''' grass in the area, consuming your map in flames, causing [[tree]]s to fall, and, above all else, murdering your [[FPS]]. When attacked by a dragon, lure it underground, preferably into an area made out of stone floors away from any [[farm plot]]s. While they are immune to fire damage, dragons can still [[swimmer|drown]] if immersed in magma.

Dragonfire can be avoided by fighting the dragon in a hallway that is covered in 4/7 water depth, here the dragon can not spit fire leaving it open for melee combat.

Possibly the best defence is to use piercing weapons like crossbows, especially spears, and hope you get lucky and hit a vital organ which can bring it down immediately. An alternative is building one or multiple cage traps, possibly beforehand, which will probably cage the dragon making it harmless. You should know that cages and mechanisms will be destroyed by dragonfire unless constructed from pure slade, so either make sure both cages (or weapons, or supports) and mechanisms are impervious to dragonfire, or, more simply; ensure that the dragon has no reason to breathe fire by removing animals and dwarves from the trapped area. While they won't breathe on buildings normally, a stray blast (at your outdoor livestock or bait animals, say) that catches any traps, doors, or bridges not made of dragonfire-safe materials will melt and deactivate them. This can be used to your advantage, since dragons will destroy the bridge they are standing on, even if they aren't aiming for it. Also, dragons make good companions if you are able to reanimate them as a [[necromancer]].

==Domestication==
[[File:dragonprev.png|thumb|260px|right|How majestic! ''Art by Olivitree'']]
Dragons can be captured in [[cage]] [[trap]]s and [[Animal trainer|trained]] if you're lucky enough to catch one. Currently, knowledge of animal behaviour is based on the civilization level and depends partly on the animals available for contact in a given civilization site. Such a rare megabeast as a dragon is unlikely to have had any civilized contact aside from adventurers attempting to slay them and other violent contact; as such, your fort will have to build the knowledge base from the ground up, making dragon-training a highly difficult task. Bear in mind that even with a skilled animal trainer at hand, your first attempts to control such a powerful and elusive beast may result in [[Fun|half your fortress burning in dragonfire]]. (Outdated: Being megabeasts, trained dragons will still be hostile to caravans, diplomats and other visitors.) It seems like this has been patched in the Steam version, at least according to [https://www.reddit.com/r/dwarffortress/comments/111mnh1/tame_dragon_not_attacking_military/ this] Reddit post. At least assuming the same thing that was causing it to attack guests was also making it attack guards.

If you can manage to endure its long-untamed wrath, you'll have a massively valuable pet that can lay [[egg]]s. Dragons can also be trained as war or hunting animals at an [[Activity_zone#Animal_Training|animal training zone]]. While a trained dragon is an immensely destructive tool at your disposal, it is also very eager to use dragonfire against your enemies, which can be ''exceedingly'' [[fun]] if it happens in your [[Pasture|grass]], [[Alcohol|booze]] [[stockpile]] or [[meeting area]].

Provided you are lucky enough to capture a pair of dragons of different sexes, you can [[Egg#Hatching Conditions|breed]] them with a [[nest box]]. Hatched dragons will need to progress through 1,000 years of growth to reach full size, but reach 20% of their full size at age 10.

==Irregularities, bugs, and future plans==
[[File:Dragon_Size.png|frame|Estimated size comparison between a fully-grown dragon and a dwarf.]]
Dragons have been observed to occasionally wear some [[armor]] (breastplates, greaves, leggings and boots). This armor is specified as "Large [metal][armor type]" and gives the dragon the same protection as any other species might get from it. This is a bug, as dragons can't normally equip items.

[[Main:Toady One|Toady One]] has mentioned that he plans to eventually extend the random creature generator of the game to create different species and varieties of dragon within certain constraints, calling it "Half-Random", with ideas for variants including just about anything dragons have been given in literature, such as acidic blood, while maintaining a basic draconic structure.([http://www.bay12forums.com/smf/index.php?topic=30026.msg1012311#msg1012311]) He has also commented on the game's current portrayal of dragons as wingless unintelligent creatures, citing his reasons to be the many ways dragons are depicted in real-life sources.([http://www.bay12forums.com/smf//index.php?topic=159164.msg7156980#msg7156980])

One of the [[Main:Consolidated_development#Power_Goals|old power goals]] referenced stealing dragon eggs as part of an [[adventurer mode]] quest.

[[File:Dragon2.png|thumb|300px|center|Dragons; admired for their terrible majesty]]

{{D for Dwarf}}


Contrary to popular belief, a dragon is not in fact toothless, and will tear you to shreds, resulting in [[fun]].


They will, however, in accordance to popular belief, set fire to the countryside, as well as any [[peasant|peasants]] and thatched-roof cottages that happen to be in the vicinity.
Fortunately, there are no dragon men. Otherwise they might come in the night.


Also contrary to popular belief, dragonfire is in fact not actually fire, but is composed of boiling, molten clouds of varied metals such as: silver, copper, steel, etc... So one could argue that dragons feed on minerals and armored adventurers to produce their breath, or that dragons can breath plasma.


Dragonfire is also known to make trade depots explode.


Though dragons are thought to make their lairs in dungeons, actual sightings of "Dragons in Dungeons" are extremely rare.

{{Translation
| dwarven = måmgoz
| elvish = vutheni
| goblin = kusnath
| human = tamun
}}

{{gamedata}}
{{Creatures}}
{{Category|Megabeasts}}

Dragon

2025-10-20T17:37:00Z

Putnam3145: /* Dragon Size */ dragon sizes were changed over a year ago and nobody changed the wiki, yikes

{{Quality|Exceptional|16:09, 7 March 2023 (CST)}}
{{Creaturelookup/0
|image=dragon_sprites.png
|portrait=dragon_portrait.png
|bone=66-110
|tooth=3
|meat=113-173
|fat=42-65
|nail=1
|lung=8-18
|heart=2-4
|intestine=14-27
|liver=4-9
|tripe=4-9
|sweetbread=2-4
|spleen=2-4
|kidney=4-8
|brain=4-8
|skull=1
|skin=scale
|eye=2
|contrib=no
|wiki=yes
}}
{{av}}
{{creaturedesc}}
'''Dragons''' are massive, [[fire]]-breathing [[megabeast]]s who, at their full size, are the [[List_of_creatures_by_adult_size#end_of_list|second largest]] land [[creature]]s in the world (behind the [[giant elephant]]). They are covetous monsters and seek to [[Steals items|steal items]] from your fortresses to bring back to their lairs. Dragons generally pilfer successfully in [[World generation|worldgen]], but when they attack a player fortress, they will simply wipe the place out or die trying.

Dragons are most notable for their ability to quickly and frequently exhale long (20+ tiles) jets of [[dragonfire]], a much-hotter (theoretically {{ct|50000}}, over four times the heat of [[magma]]) version of fire, which can make quick work of any creature caught in its path and can kill even creatures normally immune to fire, though it can be blocked by enemies equipped with [[shield]]s. All dragons are born with Talented [[skill]] in [[Combat skill|fighting, biting, kicking, dodging]] and [[Observer|observing]], which, combined with their size and dragonfire, makes them formidable opponents to an untrained [[military]] [[squad]].

While based on the western dragon model, dragons neither fly nor have wings, and are not intelligent (though there is room to address this; see [[#Irregularities, bugs, and future plans|Bugs and Future Plans]]). They are often described as [http://tvtropes.org/pmwiki/pmwiki.php/Main/GlassCannon glass cannons], as they are not particularly durable and can be defeated somewhat easily with skilled soldiers or [[trap]]s, but only in comparison to their fellow megabeasts; a single dragon can easily wipe out an unprepared fortress. Dragons are associated with the [[sphere]]s of fire and wealth, and their names will often reflect that.

They are not to be confused with the [[cave dragon]]s, a separate, non-megabeast species.

Some dwarves [[preferences|like]] dragons for their ''terrible majesty''.

==Dragon Size==
Dragons slowly grow to become one of the largest creatures in the game, finally reaching their adult size of 25,000,000 cm3 after 1000 years. As a hatchling, dragons are quite tiny, at exactly 1/10th an adult dwarf's size, but they grow very rapidly, at roughly 500,000 cm3 per year until they reach age 10, at which point they slow to 20202 per year. Dragons reach dwarven size shortly after birth, are the size of a draltha at year 5, and become elephant sized by year 10.

*At birth, a dragon is the size of a [[fox]].
*At 2 years, a dragon is the size of a [[water buffalo]].
*At 10 years, a dragon is the size of an [[elephant]] and becomes an adult.
*At 100 years, a dragon is the size of a [[blind cave ogre]].
*At 200 years, a dragon is larger than a [[hydra]].
*At 800 years, a dragon is the size of a [[bronze colossus]] or an adult [[roc]].
*After 1000 years, a dragon is the second largest creature found on land. (The [[giant elephant]] is the largest land creature, while the [[giant sperm whale]] is the largest creature found anywhere.)

==Defense strategies==
Dragonfire can be blocked if the victim is using a shield, and it will be, more than 99% of the time. Though they are among the physically weakest of the megabeasts, dragons are still massively powerful in melee combat, so they can be hard to take down without a good military. They should never be engaged in areas covered in [[grass]] or [[cave moss]], as their breath attacks will cause fire to spread across '''all''' grass in the area, consuming your map in flames, causing [[tree]]s to fall, and, above all else, murdering your [[FPS]]. When attacked by a dragon, lure it underground, preferably into an area made out of stone floors away from any [[farm plot]]s. While they are immune to fire damage, dragons can still [[swimmer|drown]] if immersed in magma.

Dragonfire can be avoided by fighting the dragon in a hallway that is covered in 4/7 water depth, here the dragon can not spit fire leaving it open for melee combat.

Possibly the best defence is to use piercing weapons like crossbows, especially spears, and hope you get lucky and hit a vital organ which can bring it down immediately. An alternative is building one or multiple cage traps, possibly beforehand, which will probably cage the dragon making it harmless. You should know that cages and mechanisms will be destroyed by dragonfire unless constructed from pure slade, so either make sure both cages (or weapons, or supports) and mechanisms are impervious to dragonfire, or, more simply; ensure that the dragon has no reason to breathe fire by removing animals and dwarves from the trapped area. While they won't breathe on buildings normally, a stray blast (at your outdoor livestock or bait animals, say) that catches any traps, doors, or bridges not made of dragonfire-safe materials will melt and deactivate them. This can be used to your advantage, since dragons will destroy the bridge they are standing on, even if they aren't aiming for it. Also, dragons make good companions if you are able to reanimate them as a [[necromancer]].

==Domestication==
[[File:dragonprev.png|thumb|260px|right|How majestic! ''Art by Olivitree'']]
Dragons can be captured in [[cage]] [[trap]]s and [[Animal trainer|trained]] if you're lucky enough to catch one. Currently, knowledge of animal behaviour is based on the civilization level and depends partly on the animals available for contact in a given civilization site. Such a rare megabeast as a dragon is unlikely to have had any civilized contact aside from adventurers attempting to slay them and other violent contact; as such, your fort will have to build the knowledge base from the ground up, making dragon-training a highly difficult task. Bear in mind that even with a skilled animal trainer at hand, your first attempts to control such a powerful and elusive beast may result in [[Fun|half your fortress burning in dragonfire]]. (Outdated: Being megabeasts, trained dragons will still be hostile to caravans, diplomats and other visitors.) It seems like this has been patched in the Steam version, at least according to [https://www.reddit.com/r/dwarffortress/comments/111mnh1/tame_dragon_not_attacking_military/ this] Reddit post. At least assuming the same thing that was causing it to attack guests was also making it attack guards.

If you can manage to endure its long-untamed wrath, you'll have a massively valuable pet that can lay [[egg]]s. Dragons can also be trained as war or hunting animals at an [[Activity_zone#Animal_Training|animal training zone]]. While a trained dragon is an immensely destructive tool at your disposal, it is also very eager to use dragonfire against your enemies, which can be ''exceedingly'' [[fun]] if it happens in your [[Pasture|grass]], [[Alcohol|booze]] [[stockpile]] or [[meeting area]].

Provided you are lucky enough to capture a pair of dragons of different sexes, you can [[Egg#Hatching Conditions|breed]] them with a [[nest box]]. Hatched dragons will need to progress through 1,000 years of growth to reach full size.

==Irregularities, bugs, and future plans==
[[File:Dragon_Size.png|frame|Estimated size comparison between a fully-grown dragon and a dwarf.]]
Dragons have been observed to occasionally wear some [[armor]] (breastplates, greaves, leggings and boots). This armor is specified as "Large [metal][armor type]" and gives the dragon the same protection as any other species might get from it. This is a bug, as dragons can't normally equip items.

[[Main:Toady One|Toady One]] has mentioned that he plans to eventually extend the random creature generator of the game to create different species and varieties of dragon within certain constraints, calling it "Half-Random", with ideas for variants including just about anything dragons have been given in literature, such as acidic blood, while maintaining a basic draconic structure.([http://www.bay12forums.com/smf/index.php?topic=30026.msg1012311#msg1012311]) He has also commented on the game's current portrayal of dragons as wingless unintelligent creatures, citing his reasons to be the many ways dragons are depicted in real-life sources.([http://www.bay12forums.com/smf//index.php?topic=159164.msg7156980#msg7156980])

One of the [[Main:Consolidated_development#Power_Goals|old power goals]] referenced stealing dragon eggs as part of an [[adventurer mode]] quest.

[[File:Dragon2.png|thumb|300px|center|Dragons; admired for their terrible majesty]]

{{D for Dwarf}}


Contrary to popular belief, a dragon is not in fact toothless, and will tear you to shreds, resulting in [[fun]].


They will, however, in accordance to popular belief, set fire to the countryside, as well as any [[peasant|peasants]] and thatched-roof cottages that happen to be in the vicinity.
Fortunately, there are no dragon men. Otherwise they might come in the night.


Also contrary to popular belief, dragonfire is in fact not actually fire, but is composed of boiling, molten clouds of varied metals such as: silver, copper, steel, etc... So one could argue that dragons feed on minerals and armored adventurers to produce their breath, or that dragons can breath plasma.


Dragonfire is also known to make trade depots explode.


Though dragons are thought to make their lairs in dungeons, actual sightings of "Dragons in Dungeons" are extremely rare.

{{Translation
| dwarven = måmgoz
| elvish = vutheni
| goblin = kusnath
| human = tamun
}}

{{gamedata}}
{{Creatures}}
{{Category|Megabeasts}}

Lua functions

2025-10-10T17:51:27Z

Putnam3145: /* Tables */ well that's just not right at all

{{av}}
{{Modding}}

Dwarf Fortress defines a number of functions in addition to those standard for [https://www.lua.org/manual/5.4/ Lua 5.4].

==C++ Function Calls==

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''int'' {{text anchor|trandom}}(''int'' n)
| Returns a 32-bit integer from {{Tooltip|0 to n-1|Lua arrays start at 1, C++ arrays start at 0, hence the discrepancy.}}. Uses DF's internal RNG system instead of ``math.random()``.

|-
| ''str'' {{text anchor|capitalize_string_words}}(''str'' s)
| Capitalizes every word in a string.

|-
| ''str'' {{text anchor|capitalize_string_first_word}}(''str'' s)
| Capitalizes the first word in a string.

|-
| ''str'' {{text anchor|utterance}}()
| Returns a word from the [[kobold language]].

|-
| ''void'' {{text anchor|lua_log}}(''str'' s)
| Prints a string to ``Dwarf Fortress/lualog.txt``. The ``log()`` function is more robust and should be used instead.

|-
|
''void'' {{text anchor|raws.register_reactions}}(''table'' lines) 
''void'' {{text anchor|raws.register_creatures}}(''table'' lines) 
''void'' {{text anchor|raws.register_entities}}(''table'' lines) 
''void'' {{text anchor|raws.register_items}}(''table'' lines) 
''void'' {{text anchor|raws.register_inorganics}}(''table'' lines) 
''void'' {{text anchor|raws.register_interactions}}(''table'' lines) 
''void'' {{text anchor|raws.register_languages}}(''table'' lines) 
''void'' {{text anchor|raws.register_plants}}(''table'' lines)
| Takes a table of [[token]]s and reads them as that type of [[raw file]]. It is not necessary to add a header.

|}

==Globals==
Helper functions are defined in ``init/globals.lua``, and can be accessed by any script even if ``vanilla_procedural`` is not loaded.

===Generation===
This function is defined in ``init/generators.lua``.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''table'' {{text anchor|add_generated_info}}(''table'' tbl)
| Adds {{token|GENERATED}} to the input table, and {{token|SOURCE_HFID}}/{{token|SOURCE_ENID}} if IDs are defined. Necessary for generated raws to be saved properly.

|}

===Randomization===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''value'' {{text anchor|pick_random}}(''table'' t)
| Returns a random value from a table.

|-
| ''value'' {{text anchor|pick_random_no_replace}}(''table'' t)
| Returns a random value from a table, then removes it from the table.

|-
| ''value'' {{text anchor|pick_random_conditional}}(''table'' t, ''function'' cond,...)
| Returns a random value from a table that satisfies ``cond(...)``.

|-
| ''bool'' {{text anchor|one_in}}(''num'' x)
| Returns true with a one in x chance.

|-
| ''value'' {{text anchor|pick_random_pairs}}(''table'' tbl)
| Returns a random key from a table. For example, ``pick_random_pairs( {WATER = true} )`` returns "WATER".

|-
| ''value'' {{text anchor|pick_weighted_from_table}}(''table'' tbl)
| Requires a table of tables with ``weight`` keys. Returns a weighted random value.
At debug level >=4, logs the roll.

|-
| ''value'' {{text anchor|generate_from_list}}(''table'' tbl,...)
| Requires a table of functions that return a ``weight`` key. Runs each function and returns a weighted random output. Used by [[werebeast]]s to generate an interaction and link to options from it.

|}

===Tables===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description
|-
| ''table'' {{text anchor|split_to_lines}}(''table'' tbl,''string'' str)
| Adds a string into a table, with each line being a separate key.

|-
| ''table'' {{text anchor|map_merge}}(''table'' tbl1, ''table'' tbl2)
| Combines two tables. If ``tbl1`` already has a value for a given key, it will not be overwritten. Used for sets such as ``{ WATER = true }``.

|-
| ''table'' {{text anchor|table_merge}}(''table'' tbl1, ''table'' tbl2)
| Adds each value from ``tbl2`` onto the end of ``tbl1``.

|-
| ''bool'' {{text anchor|find_in_array_part}}(''table'' tbl, ''value'' item)
| Returns true if ``item`` is a value in ``tbl``.

|-
| ''void'' {{text anchor|convert_array_to_set}}(''table'' tbl)
| Makes a set from an array, e.g. takes {"a","b","c"} and makes it {a=true,b=true,c=true} so that it can be indexed.

|-
| ''void'' {{text anchor|add_unique}}(''table'' tbl, ''value'' item)
| Adds ``item`` to the end of ``tbl`` if not already present.

|-
| ''void'' {{text anchor|remove_item}}(''table'' tbl, ''value'' item)
| Removes all instances of ``item`` from ``tbl``.

|-
| ''table'' {{text anchor|shallow_copy}}(''table'' tbl)
| Returns a table copied from all values in the input table.

|-
| ''table'' {{text anchor|deep_copy}}(''table'' tbl)
| Returns a table recursively copied from all values in the input table.

|}

===Debug===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Description
|-
| ''void'' {{text anchor|log}}(...)
| Logs the input to ``Dwarf Fortress/lualog.txt``. Used for most cases.

|-
| ''string'' {{text anchor|get_caller_loc_string}}()
| Returns the debug source info and the current line.

|-
| ''string'' {{text anchor|get_debug_logger}}(''num'' level=1,...)
| Logs ``get_caller_loc_string()`` and any overloads if the ``debug_level`` is at least ``level``. ``debug_level`` is a global variable that defaults to 0.

|-
| ''function'' {{text anchor|partial_function}}(''function'' f, arg,...)
| Returns ``f(arg,...)``.

|-
| ''function'' {{text anchor|log_table}}(''table'' tbl, ''num'' debug_level=0, ''num'' nest_level=0, ''num'' added_debug_from_nest=0)
| Logs a table if the global ``debug_level`` is at least the input ``debug_level``. ``nest_level`` starts at 0 and adds ``added_debug_from_nest`` for each nesting to the input debug level.

|-
| ''function'' {{text anchor|print_table}}(''table'' tbl, ''num'' nest_level=0)
| Logs a table, regardless of debug level.

|}

===Spheres===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="45%" | Function
! width="55%" | Description

|-
| ''string'' {{text anchor|get_random_sphere_adjective}}(''string'' [[Sphere#Sphere tokens|sphere]])
| Returns a random string from global table ``random_sphere_adjective[sph]``.

|-
| ''table'' {{text anchor|get_random_sphere_noun}}(''string'' [[Sphere#Sphere tokens|sphere]])
| Returns a random table ``tbl`` from global table ``random_sphere_nouns[sphere]``.
``tbl`` has two members: ``tbl.str``, which is a string; and ``tbl.flags``, which defaults to ``{OF=true,PREPOS=true,PRE=true}``, for grammar.

|-
| ''table'' {{text anchor|add_sphere_mpp}}(''table'' sphere_list, ''string'' [[Sphere#Sphere tokens|new_s]], ''table'' available_sphere, ''table'' available_sphere_cur)
| Adds ``new_s`` to ``sphere_list`` and all parents and children. Sets the added spheres in ``available_sphere`` and ``available_sphere_cur`` to false, and sets all enemies in ``available_sphere_cur`` to false.
At debug level >= 2, will be logged.
|}

==Generation Tables==
The ``generate()`` function is defined in ``init/generators.lua``, and is called to generate objects.

Each type of random object is defined through a function that generates a table of raws. To generate objects for specific purposes, ``generate()`` can call functions from a table and provide inputs such as ``tok`` (unique token string).
For example, [[forgotten beast]]s are unique and generated for each cave region. If multiple functions are defined in ``creatures.fb``, such as both ``creatures.fb.default`` and a modded forgotten beast, the game uses the ``weight`` output to influence which one will be randomly chosen.

By default, objects are generated in this order: unittests{{Tooltip|*|if debug_level is at least 0}}, preprocess, do_once, materials, items, languages, creatures, interactions, entities, and postprocess. Do note that you can register raws at any step. For example, each [[vault]] entity generates a set of [[divine equipment]] during the entity step, and [[werebeast]]s generate a curse interaction during the creature step.

===Custom===

{{main|Lua scripting#Object generation}}

When the game uses ``generate()`` to generate objects, all functions in the following tables are run in sequence.

``random_object_parameters.pre_gen_randoms`` and ``random_object_parameters.main_world_randoms`` are only ever true for one generation call each, at the start of world generation in that order.

You cannot predict when ``generate()`` is called. Raws registered through ``preprocess`` and ``postprocess`` should check for either variable so that further calls do not endlessly register raws.

Functions stored and called through these tables are not supplied with arguments.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="80%" | Description

|-
| preprocess
| Run at the start of each ``generate()`` call, after unit testing.
Includes two functions by default: 
``preprocess.demon()``, which populates the distribution of ``demon_type`` string inputs 
``preprocess.bogeyman_polymorph()``, which generates the [[bogeyman]]'s polymorph [[Interaction token|interactions]] if bogeymen exist 

|-
| do_once_early
| As ``do_once``, but only runs if ``random_object_parameters.pre_gen_randoms == true`` (before the map exists)
Recommended for generating custom objects that need to be placed in the map; ie: animal populations, [[stone layers|minerals]].

|-
| do_once
| Runs immediately after all functions in preprocess, and before all other generation steps. Only runs if ``random_object_parameters.main_world_randoms == true`` (in prehistory once the map is finalized)
Recommended for generating most custom objects. 
Includes one function by default: 
``do_once.rcp_mat_emission()``, adds the ``RCP_MATERIAL_EMISSION`` [[Interaction token|interaction]]

|-
| postprocess
| Runs after all other generation steps are finished.

|-
| unittests
| Runs before preprocess if the global ``debug_level`` is greater than 0. Expects a boolean output.

|-
| languages
| For each function in this table, registers a language. Expects table of key-value pairs where the key is the [[Language token#WORD|word token]] and the value is the translated string. Initial generation call only.

|}

===Creatures===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Table
! width="40%" | Inputs
! width="60%" | Article

|-
|
creatures.angel.great_beast 
creatures.angel.humanoid_generic 
creatures.angel.humanoid_warrior
| function(tok)
| [[Angel]] (see [[Angel#Angel types|types]])

|-
| creatures.demon
| function(demon_type, difficulty, tok)
| [[Demon]]

|-
|
creatures.experiment.beast_large 
creatures.experiment.beast_small 
creatures.experiment.failed_large 
creatures.experiment.failed_small 
creatures.experiment.humanoid_giant 
creatures.experiment.humanoid 
| function(tok)
| [[Experiment]]

|-
| creatures.fb
| function(layer_type, tok)
| [[Forgotten beast]]

|-
| creatures.night_creature.bogeyman
| function(tok)
| [[Bogeyman]]

|-
| creatures.night_creature.nightmare
| function(tok)
| [[Nightmare]]

|-
| creatures.night_creature.troll
| function(tok)
| [[Night troll]]

|-
| creatures.night_creature.werebeast
werebeast_origin_interactions{{Tooltip|*|Called by vanilla_procedural, not by init/generators}}
| function(tok)
function(tok, name, options)
| [[Werebeast]]

|-
| creatures.titan
| function(subregion, tok)
| [[Titan]]

|}
====Creature patching====
{{Main|Lua scripting#Tweaks}}
While ``SELECT_CREATURE`` cannot target generated objects, there are global tables set up to append data when building a creature. These tables contain functions which have access to tokens, options, and local functions from ``build_body_from_rcp()``. All functions in these tables are run at corresponding stages in the build function.

``lines``, ``options`` and ``rcp`` are the creature's raw lines and data, which can be read or modified in these functions.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="10%" | Table
! width="30%" | Inputs
! width="50%" | Timing

|-
| btc1_tweaks
| function(lines, options, add_to_body, add_to_body_unique, add_tweak_candidate)
| Before ``options.btc`` (the first tweak) is determined.

|-
| feature_tweaks
| function(rcp, options, add_to_body, add_to_body_unique, add_tweak_candidate)
| After ``options.btc2`` is set. ``add_tweak_candidate()`` is unused in vanilla at this stage.

|-
| post_attack_tweaks
| function(lines, options, is_in_body)
| After ``options.attack_tweak`` is set. By default, runs functions to add {{token|ATTACK}}s for body parts.

|-
| post_gait_tweaks
| function(lines, options)
| This is the last operation in the build function.
Includes the ``bogey_polymorph()`` function by default, which checks ``options.can_bogey_polymorph`` to add the interaction.

|}

{| {{prettytable}}
|- style='background-color:#ddd'
! width="25%" | Local Function
! width="80%" | Effect

|-
| ''void'' add_to_body(str)
| Adds the input [[body token]] to the ``options.body_string`` table.

|-
| ''void'' add_to_body_unique(str)
| As ``add_to_body()`` and ``add_unique()``, only adds if not already present.

|-
| ''void'' add_tweak_candidate(str)
| Adds the input to ``options.body_tweak_candidate``, pointing to a key in the ``tweaks`` table.

|-
| ''bool'' is_in_body(str)
| Checks if the input [[body token]] is in ``options.body_string``.

|}

===Entities===

Generated entities are supplied with the ``idx`` parameter, which is a number that starts at 1 and increments by 1 for each entity of that type. It can be used to give a unique ID to [[divine equipment]].

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Table
! width="20%" | Inputs
! width="60%" | Articles

|-
| entities.vault_guardian
| function(idx,tok)
| [[Vault]] ([[angel]]s)

|-
| entities.mythical_guardian
| function(idx,tok)
| [[Mysterious dungeon]] ([[dungeon guardian]]s)

|}

===Interactions===

====World====
World interactions are generated in the ``generate_random_interactions()`` step of ``generators.lua``.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Table
! width="30%" | Inputs
! width="60%" | Examples

|-
|
interactions.blessing.minor 
interactions.blessing.medium
| function(idx)
| [[Die]] roll effects: luck, holy item, healing, etc

|-
|
interactions.curse.minor 
interactions.curse.medium
| function(idx)
| [[Die]] roll effects: week of curse

|-
| interactions.curse.major
| function(idx,tok)
| [[Vampire]]

|-
| interactions.disturbance
| function(idx)
| [[Mummy]]

|-
| interactions.mythical
| function(idx,power_level,[[sphere]])
| [[Dungeon guardian]]

|-
| interactions.mythical_item_power
| spheres={}, interaction=function()
| [[Primordial remnant#List of powers]]

|-
| interactions.regional
| function(idx)
| Reanimating [[Surroundings#Evil|evil biomes]]

|-
| interactions.secrets
| function(idx,[[sphere]])
| [[Necromancer]]

|}

====Powers====
Powers are stored in the ``interactions.powers`` table and can be generated by other interactions. The structure of each power entry contains several keys that determine how it can be added to an interaction's syndrome.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="15%" | Key
! width="30%" | Inputs
! width="60%" | Notes

|-
| tags
| ''table''
| A table of user-defined values that can be checked by other functions.

|-
| tags.lieutenant
| ''bool''
| If true, available to [[intelligent undead]].

|-
| rarity
| ''number'' n
| Higher is rarer. An [[intelligent undead]] has a 1 in n chance to receive this power.

|-
| gen
| ''table'' ``tbl``, ''table'' ``end_tbl`` function(name)
| Generates and returns lines of raws.
* ``tbl`` consists of [[syndrome]] lines comprising {{token|CE_CAN_DO_INTERACTION|syndrome}} and ``[[Interaction token#Usage|CDI]]``.
* ``end_tbl`` consists of lines that define the [[interaction]].

|}

====Interaction helpers====

Interaction helpers are defined by ``vanilla_procedural``.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| ''table'' ``tbl``, ''table'' ``end_tbl`` basic_lieutenant(''string'' name, ''string'' name_plural, ''string'' token)
| Generates an interaction that raises an [[intelligent undead]] and calls ``basic_lieutenant_powers(token)``.

|-
| ''table'' ``tbl``, ''table'' ``end_tbl`` basic_lieutenant_powers(''string'' token)
| Adds any number of powers (chosen from among ``interaction.powers``) and 0-5 sicken effects (from ``add_curses()``) to the current definition.

|-
| ''table'' ``tbl``, ''table'' ``end_tbl``, ''int'' ``idx`` add_curses(''table'' tbl, ''table'' end_tbl, ''string'' token, ''int'' num, ''int'' start_idx, ''int'' sev, ''table'' good_effects)
| Adds ``num`` curses/afflictions to the current definition. ``good_effects`` lists the possible curses that can be chosen from ``default_curse_effects``, and ``sev`` is the syndrome's severity. Basic lieutenants use a ``sev`` of 500.

|-
| ''string'' get_abstract_gesture()
| Returns a random string from either ``gestures`` or ``gestures_abstract``, used for {{token|VERB|interaction}}.

|-
| populate_monotone_color_pattern()
| Writes all [[Descriptor color token|MONOTONE color patterns]] from ``world.descriptor.color_pattern`` to the global table ``monotone_color_pattern``, if not already populated.
Not to be confused with ``world.descriptor.color``, which has the same keys as a color rather than a pattern.

|-
| add_base_poison_effects(mat, good_effects, sev, max_eff, min_start, max_start, min_peak, max_peak, min_end, max_end, terminal_chance, resist_chance, size_delay_chance, size_dilute_chance)
| Writes 1 to ``max_eff`` [[syndrome]] effects from ``good_effects`` to ``mat``, a table of raw lines. Has a one in ``terminal_chance`` to not end. If the effect {{token|RESISTABLE}}

|}

===Items===

====Instruments====

The default [[instrument]] system is not currently open to Lua, but ``generators.lua`` defines tables for each token.
{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Table
! width="30%" | Inputs
! width="40%" | Token

|-
| items.instruments.keyboard
| N/A
| {{token|GENERATE_KEYBOARD_INSTRUMENTS|e}}

|-
| items.instruments.stringed
| N/A
| {{token|GENERATE_STRINGED_INSTRUMENTS|e}}

|-
| items.instruments.wind
| N/A
| {{token|GENERATE_WIND_INSTRUMENTS|e}}

|-
| items.instruments.percussion
| N/A
| {{token|GENERATE_PERCUSSION_INSTRUMENTS|e}}

|}

====Divine equipment====
{{Main|Divine equipment}}
``entities.vault_guardian.default`` generates from the list ``angel_item_gens``, the default function of which then calls functions from ``angel_item_info``. Unless otherwise stated, the '''Behavior''' column refers to the behavior of how ``angel_item_gens.default`` generates from these lists.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="20%" | Inputs
! width="60%" | Behavior

|-
| angel_item_gens
| function(prefix,tokens)
| Called by ``entities.vault_guardian.default``, which supplies a unique ``prefix`` and doesn't provide ``tokens``.

|-
|
angel_item_info.armor.pants.gen 
angel_item_info.armor.armor.gen 
angel_item_info.armor.helm.gen 
angel_item_info.armor.gloves.gen 
angel_item_info.armor.shoes.gen 
angel_item_info.shield.gen
| function(i,prefix)
| Generates 1 piece of [[armor]] for each slot and 1 [[shield]].

|-
|
angel_item_info.clothing.pants.gen 
angel_item_info.clothing.armor.gen 
angel_item_info.clothing.helm.gen 
angel_item_info.clothing.gloves.gen 
angel_item_info.clothing.shoes.gen
| function(i,prefix)
| Generates 1 piece of [[clothing]] for each slot.

|-
|
angel_item_info.weapon.PIKE.gen 
angel_item_info.weapon.WHIP.gen 
angel_item_info.weapon.BOW.gen 
angel_item_info.weapon.BLOWGUN.gen 
angel_item_info.weapon.AXE.gen 
angel_item_info.weapon.SWORD.gen 
angel_item_info.weapon.DAGGER.gen 
angel_item_info.weapon.MACE.gen 
angel_item_info.weapon.HAMMER.gen 
angel_item_info.weapon.SPEAR.gen 
angel_item_info.weapon.CROSSBOW.gen
| function(i,prefix)
| Generates 5 [[weapon]]s. The tables correspond to [[combat skill]]s, and are not repeated. For example, a vault can't generate two types of swords.

|-
|
angel_item_info.ammo.ARROW 
angel_item_info.ammo.BOLT 
angel_item_info.ammo.BLOWDART
| function()
| When a ranged weapon is generated, it will also generate a random subtype of the proper ammunition.

|}

===Materials===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="15%" | Inputs
! width="15%" | Article
! width="60%" | Notes

|-
| materials.clouds
materials.rain
| function()
| [[Evil weather]]
| Associated regional [[interaction]]s are automatically written by ``init/generators.lua``.

|-
| materials.divine.metal
materials.divine.silk
| function([[sphere]])
| [[Divine metal]]
[[Divine fabric]]
| The list of potential spheres is determined by the individual function. See [[Lua script examples#New divine metal]].
{{token|DIVINE|inorganic}} and {{token|SPHERE|inorganic}} are added by ``generators.lua`` rather than in the individual function.

|-
| materials.mythical_remnant
| function([[sphere]])
| [[Primordial remnant]]
| Possible spheres are determined by ``random_object_parameters.mythical_sphere``.

|-
| materials.mythical_healing
| function()
| [[Mythical substance]]
|

|}

==Random Creatures==

Creatures generated by ``vanilla_procedural`` use a number of shared functions to determine their attributes. The local ``options`` table stores most of the data used by these steps.

===RCP Functions===
The random creature profile determines the basic body of a generated creature, such as "humanoid" or "[[toad]]", and provides options and data to later build the proper creature definition.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| ''table'' get_random_creature_profile(options,blacklist)
| Makes a weighted random choice of options from ``random_creature_types`` that satisfy arguments set in ``options`` (``options.do_water``, etc) and ``blacklist``. Falls back to ``random_creature_types.GENERAL_BLOB``.
At debug_level >= 3, will log failures. At debug_level >= 4, will also log successes.

|-
| ''bool'' is_valid_random_creature(''string'' creature, ''bool'' do_water, ''bool'' humanoid_only, ''bool'' is_good, ''bool'' beast_only)
| Checks if ``creature`` is a valid key in certain tables depending on the arguments: aquatic (``do_water``), can be "twisted into humanoid form" (``humanoid_only``), isn't an "evil" species (``is_good``), and is an animal species (``beast_only``)
At debug_level >= 3, will be logged.

|-
| ''void'' finalize_random_creature_types()
| If ``random_creature_types_finalized`` is false: sets it to true and iterates over ``random_creature_types`` to sanitize certain inputs.

|}

===Shared Functions===

Default creatures use ``add_regular_tokens()``, ``populate_sphere_info()``, ``get_random_creature_profile()``, ``add_body_size()`` and ``build_procgen_creature()`` as the main steps in generating raws.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| add_regular_tokens(tbl,options)
| Adds tokens to ``tbl``. Sets {{token|PETVALUE|2000}}, calculates material weaknesses (if ``options.material_weakness``), and adds a few immunity tokens depending on ``options.normal_biological``.

|-
| tile_string(arg)
| Returns a string usable for {{token|CREATURE_TILE}}. Encloses number arguments in ``'`` characters.

|-
| add_body_size(tbl,size,options)
| Adds {{token|BODY_SIZE|0:0:size}} and sets ``options.body_size``. Calls ``body_size_properties()``.

|-
| body_size_properties(tbl,size,options)
| Adds {{token|BUILDINGDESTROYER|2}} if size > 80,000; adds {{token|GRASSTRAMPLE|20}} and {{token|TRAPAVOID}} if size > 100,000.

|-
| populate_sphere_info(tbl,options)
| Adds {{token|SPHERE}} tokens from ``options.spheres``. If ``options.do_sphere_rcm``, 1/2 chance to set ``options.sphere_rcm``.

|-
| add_poison_bits(tbl,options)
| Generates a [[Venom|poison material]] based on ``options.poison_state`` and ``options.sickness_name``.

|-
| build_procgen_creature(rcp,tbl,options)
| Calls ``build_body_from_rcp()``, ``build_description()``, and ``build_pcg_graphics()``.

|-
| build_body_from_rcp(rcp,tbl,options)
| Generates based on ``rcp`` and ``options``, assigns tweaks (mutations from the base body), tissues, organs, special attacks.

|-
| build_description(tbl,options)
| Writes the {{token|DESCRIPTION}} and any {{token|PREFSTRING}}s.

|-
| build_pcg_graphics(tbl,options)
| Assigns [[procedural graphics layer]]s based on ``options.pcg_layering`` keys set by ``build_body_from_rcp()``.

|}

===Options===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="15%" | Key
! width="20%" | Usage
! width="80%" | Notes

|-
| token
| add_poison_bits()
build_body_from_rcp()
| The creature's token.

|-
| do_water
| get_random_creature_profile()
| Use an aquatic RCP (``water_based_random_creature``)

|-
| humanoid_only
| get_random_creature_profile()
build_body_from_rcp()
| Use a RCP that can be turned into a humanoid form (``humanoidable_random_creature``), and automatically applies the ``MAKE_HUMANOID`` tweak.

|-
| beast_only
| get_random_creature_profile()
| Forbids generic humanoid/blob/quadruped RCPs (``not_beast_random_creature``).

|-
| normal_biological
| add_regular_tokens()
| If untrue, adds {{token|AMPHIBIOUS}}, {{token|SWIMS_INNATE}}, {{token|NONAUSEA}}, {{token|NOEXERT}}, {{token|NO_DIZZINESS}}, {{token|NOPAIN}}, {{token|NOSTUN}}. Used by [[experiment]]s.

|-
| always_nobreathe
| build_body_from_rcp()
| Adds {{token|NOBREATHE}}, even if not uniform.

|-
| no_general_poison
| build_body_from_rcp()
| If untrue and the creature has blood or ichor, adds {{token|CREATURE_CLASS|c|GENERAL_POISON}}.

|-
| fire_immune
| build_body_from_rcp()
| Adds {{token|FIREIMMUNE}}. Does not affect materials. Set if the creature has a fire interaction.

|-
| material_weakness
| add_regular_tokens()
| Will gain a 10x {{token|MATERIAL_FORCE_MULTIPLIER}} to a random weapon [[metal]] and a {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c|1:2}}.

|-
| is_good
|
get_random_creature_profile() 
build_body_from_rcp() 
build_description()
| Forbids "evil" RCPs (``cannot_be_good_random_creature``).
Affects options for materials, tweaks, description. Cannot have attack tweaks unless the RCP forces it.

|-
| is_evil
| build_body_from_rcp()
build_description()
| Affects options for materials, tweaks, description.

|-
| spheres
| populate_sphere_info()
color_picker_functions 
build_description()
| A set of the creature's spheres.

|-
| do_sphere_rcm
| populate_sphere_info()
| Adds a 1/2 chance to set ``options.sphere_rcm`` to a material relevant to their spheres.

|-
| pick_sphere_rcm
| random_creature_class.UNIFORM.body_fun()
| If uniform, adds an additional 1/2 chance to use a material relevant to their spheres.

|-
| pos_sphere_rcm
| populate_sphere_info()
| Temporary data storage for possible sphere RCM during ``populate_sphere_info()``.

|-
| sphere_rcm
| build_body_from_rcp()
| Forces the creature to be uniform and made of that ``random_creature_material``.

|-
| always_insubstantial
| build_body_from_rcp()
| If uniform, will always choose an insubstantial material from ``insubstantial_materials``.

|-
| never_uniform
| build_body_from_rcp()
| If ``options.r_class`` is UNIFORM, change it to FLESHY.

|-
| always_make_uniform
| build_body_from_rcp()
| Changes ``options.r_class`` to UNIFORM.

|-
| do_not_make_uniform
| build_body_from_rcp()
| Do not randomly change ``options.r_class`` to UNIFORM (normally there is a 1/20 chance), unless ``options.sphere_rcm`` is set.

|-
| walk_var
| build_body_from_rcp()
| A string for {{token|APPLY_CREATURE_VARIATION}}, ex: "STANDARD_WALKING_GAITS". Usually set by ``rcp.body_base``.

|-
| walk_speed
special_walk_speed
| build_body_from_rcp()
| The basic walking speed in a creature's [[gait]]. ``options.special_walk_speed`` will be used instead of ``options.walk_speed`` if both are present.
Crawling bodies use a ``options.walk_speed`` of 2900, walking bodies use 900.

|-
| add_fly_gaits
| build_body_from_rcp()
| Creature has a flying gait even if wings aren't added. ``local add_fly_gaits`` is used for creatures with wings.

|-
| intangible_flier
| build_body_from_rcp()
| If ``options.intangible`` (set by certain uniform materials), sets ``options.add_fly_gaits`` and adds {{token|FILER}}.

|-
| cannot_swim
| build_body_from_rcp()
| Will not add a [[swimming]] gait.

|-
| no_tweak
| build_body_from_rcp()
| Will not add any random tweaks (such as body parts or attacks) to the basic creature that aren't specified by the RCP.

|-
| always_glowing_eyes
| build_body_from_rcp()
| Will always add glowing eyes if the creature has ``options.eyes``.

|-
|
no_glowing_eyes 
cannot_have_antennae 
cannot_have_mandibles
| build_body_from_rcp()
| Will not add the listed body tweaks.

|-
| no_random_attack_tweak
| build_body_from_rcp()
| Will not add attack tweaks (or body parts that grant them) that aren't specified by the RCP.

|-
| strong_attack_tweak
| build_body_from_rcp()
| Enables access to attack tweaks. Will always gain an attack tweak, unless the RCP already specifies it.

|-
| experiment_attack_tweak
| build_body_from_rcp()
| Enables access to a limited set of attack tweaks 1/4 of the time.

|-
| sickness_name
| add_poison_bits()
| Determines the name of [[syndrome]]s caused by this creature.

|-
| poison_state
| add_poison_bits()
build_body_from_rcp()
| Accepts "LIQUID" (default), "GAS", or "SOLID_POWDER". Determines the state of this creature's [[venom]].

|-
| prioritize_bite
| post_attack_tweaks
| If true, non-bite attacks will have {{token|PRIORITY|c|SECOND}}. If untrue, non-bite attacks will have {{token|PRIORITY|c|MAIN}}.

|-
| bite_interaction
| post_attack_tweaks
| Adds {{token|SPECIALATTACK_INTERACTION}} to bite attacks.

|-
| can_bogey_polymorph
| post_gait_tweaks
| Allows the creature to use the [[bogeyman]] polymorph interaction.

|-
| rcp
| build_body_from_rcp()
build_description()
| Set in ``build_body_from_rcp()`` from the ``rcp`` argument.
Usually derived from ``random_creature_types``, passes information from the random creature profile.

|-
| r_class
| build_body_from_rcp()
| Set to a table in ``random_creature_class``. Describes the basic tissues/features a creature has, such as FLESHY, CHITIN_EXO, or UNIFORM.

|-
| surface
| build_body_from_rcp()
| The creature's exterior tissue. Set based on its ``random_creature_class`` and any tweaks.

|-
| rcm
| random_creature_class.UNIFORM.body_fun()
| Set by ``random_creature_class.UNIFORM.body_fun()``.
If ``options.sphere_rcm`` is supplied, will use that, otherwise will be randomly chosen based on ``options.is_evil``, ``options.is_good``, ``options.pick_sphere_rcm``, ``options.rcp.requires_flexible_material``, and ``options.always_insubstantial``.

|-
| post_mat_adj
| build_description()
| A string that says "composed of X", etc. Normally supplied by ``random_creature_material``.

|-
| matgloss
| random_creature_class.UNIFORM.body_fun()
| Temporary data storage when calling inorganic materials from ``random_creature_material``.

|-
| tok1
tok2
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|TISSUE_MATERIAL|tissue|options.tok1:options.tok2}}.
Must be supplied by ``random_creature_material``.

|-
| mat_temp1
mat_temp2
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|USE_MATERIAL_TEMPLATE|c|options.tok1:options.tok2}}.
Can be supplied by ``random_creature_material`` to add an organic material.

|-
| st_tok
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|TISSUE_MAT_STATE|tissue}}. Must be supplied by ``random_creature_material``.

|-
| fixed_temp
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|FIXED_TEMP|}}.
Can be supplied by ``random_creature_material``. If a material template is used, adds {{token|MAT_FIXED_TEMP|md}}.

|-
| intangible
| build_body_from_rcp()
| Flag normally supplied by ``random_creature_material``. Creature is non-solid, serves as the condition for ``options.intangible_flier``. Limits access to attack tweak.

|-
| fire_mat
| build_body_from_rcp()
| Flag normally supplied by ``random_creature_material``. Prevents a fire breath attack.

|-
| body_string
| build_body_from_rcp()
| An array of all {{token|BODY}} tokens used.

|-
| body_size
| build_description()
build_pcg_graphics()
| Set by ``body_size_properties()``. Stores the creature's volume for later use.

|-
| body_tweak_candidate
| build_body_from_rcp()
| Temporary data storage for assigning tweaks.

|-
| tweak
| ''quadruped_function_curry()''
| Temporary data storage for quadruped leg tweaks.

|-
|
attack_tweak 
btc 
btc2 
| build_body_from_rcp()
build_description()
| Strings used as a key to retrieve information about the chosen tweaks. Set by ``build_body_from_rcp()``

|-
|
eyes 
beak 
brain 
cheeks 
eyelids 
guts 
heart 
lips 
lungs 
mouth 
neck 
nose 
ribs 
skull 
spine 
teeth 
throat 
tongue
| build_body_from_rcp()
| Normally set by the creature's ``random_creature_class`` (MAMMAL, CHITIN_EXO, etc).
Adds the listed parts to the creature's body plan.

|-
|
blood 
ichor 
goo
| build_body_from_rcp()
| Normally set by the creature's ``random_creature_class`` (MAMMAL, CHITIN_EXO, etc).
Sets the creature's default {{token|BLOOD}} type.

|-
| force_goo
force_ichor
| build_body_from_rcp()
| If the creature is not uniform, overwrites the creature's default {{token|BLOOD}} type.

|-
| blood_color
| build_body_from_rcp()
| Expects a function that takes a color's HSV values and returns a boolean. Sets the creature's blood color to any color that returns true for this function.
Only works with standard [[blood]] from ``options.blood``.

|-
|
glowing_eyes 
fingers 
toes 
finger_claws 
toe_claws 
finger_nails 
toe_nails 
finger_talons 
toe_talons 
bat_wings 
lacy_wings 
feathered_wings 
has_proboscis 
do_webs

| build_procgen_creature()
| Set when building the body if the creature has those traits. Can be called by the description and when building graphics.
[[Nail]]s, claws, and talons are given attacks.

|-
| eye_count
| build_procgen_creature()
| The number of eyes the creature has. Set when building the body.

|-
| tail_count
| build_procgen_creature()
| The number of tails the creature has. Can be set before building the body.

|-
| clp
| build_procgen_creature()
| The creature's body color. Chosen randomly or based on material unless ``rcp.cannot_have_color`` is true.

|-
| eye_clp
| build_procgen_creature()
| The creature's eye color. Set when building the body.

|-
|
color_f 
color_b 
color_br
| build_body_from_rcp()
| Set based on ``options.clp`` unless ``options.forced_color`` is supplied. Adds {{token|COLOR|c|options.color_f:options.color_b:options.color_br}}.

|-
| forced_color
| build_body_from_rcp()
| Adds {{token|COLOR|c|options.forced_color.f:options.forced_color.b:options.forced_color.br}} and {{token|NO_UNIT_TYPE_COLOR}}.

|-
| animal_coloring_allowed
| build_body_from_rcp()
| Color must be a shade of brown.

|-
| experiment_colors
| build_body_from_rcp()
| Uses the set of colors assigned to [[experiment]]s.

|-
| exp_proc_surface_color
| build_pcg_graphics
| Stores the index of an experiment's color, for portraits.

|-
|
name_mat 
flavor_adj 
potential_end_phrase
| Custom names
| An array of names for a creature's material. Can be supplied by ``random_creature_material``.

|-
| feature_flavor_adj
| Custom names
| When ``build_description()`` is run, populates ``options.flavor_adj`` with strings based on the creature's tweaks and [[color]].

|-
| can_learn
| build_description()
| Enables certain description strings, such as "it knows and intones the names of all it encounters". Used by default intelligent creatures.

|-
| no_extra_description
| build_description()
| Will not add strings from ``default_desc_adds``/``good_desc_adds``/``evil_desc_adds`` to the end of the description.

|-
| custom_desc_func
| build_description()
| Adds the output of a string instead of ``default_desc_adds``/etc. Cannot have ``options.no_extra_description.``

|-
| end_phrase
| build_description()
| Adds a phrase after all other generated description pieces, such as [[Night creature|"Now you know why you fear the night."]]

|-
| and_add
| build_description()
| Temporary storage for description grammar.

|-
| pref_str
| build_description()
| A table of possible {{token|PREFSTRING}}s.

|-
| fallback_pref_str
| build_description()
| A string that is added to ``options.pref_str`` it is empty.

|-
| odor_string
odor_level
| build_body_from_rcp()
| Sets {{token|ODOR_STRING|}} and {{token|ODOR_LEVEL|}} respectively. Can be supplied by ``random_creature_material``.

|-
| forced_odor_string
forced_odor_level
forced_odor_chance
| build_body_from_rcp()
| Sets {{token|ODOR_STRING|}} and {{token|ODOR_LEVEL|}} (defaults to 90), 1 in ``options.forced_odor_chance`` of the time.

|-
| always_odor
| build_body_from_rcp()
| Can use the ``options.forced_odor_string`` even if creature is uniform.

|-
| pcg_layering
| build_pcg_graphics()
| A set of [[procedural graphics layer]]s. Set by ``build_pcg_graphics()``.

|-
| pcg_layering_base
| build_pcg_graphics()
| The basic PCG layer-set string, concatenated to form ``options.pcg_layering`` keys. Set by ``build_body_from_rcp()``.

|-
| pcg_layering_modifier
| build_pcg_graphics()
| A set of extra info for PCG layering, such as experiment skin types. Set by ``build_body_from_rcp()``.

|-
| use_werebeast_pcg
| build_pcg_graphics()
| If true, use the layers for [[werebeast]]s.

|-
| experiment_layering
| build_pcg_graphics()
| If true, use the layers for humanoid [[experiment]]s. Expects ``options.experiment_colors`` to be true.

|-
|
is_male_version
night_creature_strength_pref
night_creature_agile_pref
night_creature_strength_agile_pref
| night_troll_names
| Flags used by [[Night troll]]s.

|-
| no_default_werebeast_curse
| werebeast_origin_interactions.default()
| If this is true for a custom function in creatures.night_creature.werebeast, ``generate_from_list(werebeast_origin_interactions,tok,rcp.name_string,options)`` will not be able to use werebeast_origin_interactions.default. This allows [[mod]]s to better control access to [[werebeast]] curses.

|-
| amalgam_experiment
failed_experiment
| ''experiment_description()''
| Flags used for default [[experiment]]s.

|-
| experiment_name_type
| ''experiment_name_token''
| Array of nouns used instead of ``ropar.making_experiment`` for naming [[experiment]]s.

|-
| is_large
| ''make_failed_rcp()''
| Used for large failed [[experiment]]s. Capitalizes the creature tile.

|-
| eadj
fadj
| Custom names
| Temporary data storage for complex name generation.

|}

===RCP Parameters===

[[Category:Modding]]
[[Category:Lua|F]]

User:Putnam3145

2025-10-10T00:37:34Z

Putnam3145:

Second programmer. Is this even the same account? Oh man.

Attribute

2025-09-26T07:29:04Z

Putnam3145: I thought I'd edited the wiki to say what each attribute does but I didn't, whoops

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

[[File:attributes_v50_preview.png|thumb|262px|right|Attributes of a stoneworker.]]A creature has numerous '''attributes''' which affect its performance at various tasks, split into physical factors associated with the body, and mental factors associated with the [[soul]].

Body Attributes can be viewed in the creature's Health -> Description screen. Soul Attributes can be viewed in the creature's Personality -> Traits screen. Positive attributes are shown in green, negative attributes are shown in red, and average attributes are omitted. Said attributes may be listed as follows (may have to be highlighted to be seen): 
{{DFtext|He is slow to tire and agile, |2:0}}{{DFtext|but he is quite susceptible to disease.|4:0}}

On the Overview screen, a dwarf's top six most varied attributes and [[personality_trait|personality traits]] are summarized in order of how much they differ from the average dwarf. The adjectives used are more generalized than those used in the Traits screen and are limited to two per trait (Creative and Not creative, Strong and Weak, etc.). For example, "a boundless creative imagination" is merely listed as "Creative", while "unfathomably weak" is just listed as "Weak". Since some of the adjectives used in the Overview summary overlap with some used in the Traits screen, this can be somewhat misleading. However, average and one tier above/below average traits will never be listed in the Overview screen, so only a "very weak" or below dwarves will be listed as "Weak" in the overview.

Attributes are associated with skills, so that shield use will raise endurance as an attribute, but not attributes like memory. Different attributes raised by one skill may not be raised by the same amount. Attribute and skill gain and rust rates are moddable in the raws as a [[creature token]].

== Descriptions ==
In-game attribute descriptions are calculated based on the difference from the [[creature|species]] average. [[Human]]s' median attribute values are always 1000. Thus, if the median [[dwarf]] has higher than 1000 for an attribute, that means the median dwarf is better than the median human for that attribute (however, individual humans may be better than individual dwarves due to intraspecies variation). Likewise, if the median dwarf has below 1000 for an attribute, then the median human bests the median dwarf in that contest.

The tiers at which descriptions change are 250, 500, 750, and 1000 above or below the species median. Interestingly, if a species has an attribute with a median below 1000, such as dwarves' agility, the lowest tier will never be displayed.

These descriptions are not used in [[adventurer mode]].

== Body attributes ==
The attribute values given in the tables correspond to default racial averages for dwarves only. Modded dwarves or any other creature will report the same phrases, but the underlying numbers may be very different, as they are calculated based on the species average. In almost every case, a higher attribute value is better, as opposed to [[personality trait]]s where one may prefer higher or lower depending on the situation.

=== Strength ===
Alters the damage done in melee (increases velocity of weapon swings), increases muscle mass (a thicker muscle layer also resists damage more, and larger size makes one stronger in general), and increases how much a creature can carry. Higher strength also increases the speed of fast [[gait]]s in most creatures, including running, soaring, galloping, and fast swimming, however, proportionate gains in muscle mass can eventually reduce speed enough to overtake the gains (more so with larger creatures than dwarves). The dwarven median of 1250 is higher than average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || unbelievably strong
|-
| 2000–2249 || mighty
|-
| 1750–1999 || very strong
|-
| 1500–1749 || strong
|-
| 1001–1499 || (no description)
|-
| 751–1000 || weak
|-
| 501–750 || very weak
|-
| 251–500 || unquestionably weak
|-
| 0–250 || unfathomably weak
|}

===Agility===
This attribute affects the speed of a creature's fast-moving [[gait]]s in the same way as strength — a creature with maximum agility and strength can run faster than a creature with minimum agility and strength. The median dwarf agility of 900 is slightly below average.

Because dwarves in general have below-average agility, and because the descriptions are based on the difference from the racial average, no dwarves will ever display as "abysmally clumsy".

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 1900–5000 || amazingly agile
|-
| 1650–1899 || extremely agile
|-
| 1400–1649 || very agile
|-
| 1150–1399 || agile
|-
| 651–1149 || (no description)
|-
| 401–650 || clumsy
|-
| 151–400 || quite clumsy
|-
| 0–150 || totally clumsy
|-
| (never displayed) || abysmally clumsy
|}

===Toughness===
Increases time required to suffocate. The dwarf median of 1250 is higher than average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || basically unbreakable
|-
| 2000–2249 || incredibly tough
|-
| 1750–1999 || quite durable
|-
| 1500–1749 || tough
|-
| 1001–1499 || (no description)
|-
| 751–1000 || flimsy
|-
| 501–750 || very flimsy
|-
| 251–500 || remarkably flimsy
|-
| 0–250 || shockingly fragile
|}

===Endurance===
Reduces the rate at which creatures become exhausted, increases the rate of tiredness recovery, increases time required to suffocate, and, if both this and WILLPOWER are effectively above 1750, prevents falling over from exhaustion. The dwarven median endurance of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || absolutely inexhaustible
|-
| 1750–1999 || indefatigable
|-
| 1500–1749 || very slow to tire
|-
| 1250–1499 || slow to tire
|-
| 751–1249 || (no description)
|-
| 501–750 || quick to tire
|-
| 251–500 || very quick to tire
|-
| 1–250 || extremely quick to tire
|-
| 0 || truly quick to tire
|}

===Recuperation===
Increases the rate of wound healing and the speed at which fat is lost. The dwarven median recuperation of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || possessed of amazing recuperative powers
|-
| 1750–1999 || incredibly quick to heal
|-
| 1500–1749 || quite quick to heal
|-
| 1250–1499 || quick to heal
|-
| 751–1249 || (no description)
|-
| 501–750 || slow to heal
|-
| 251–500 || very slow to heal
|-
| 1–250 || really slow to heal
|-
| 0 || shockingly slow to heal
|}

===Disease resistance===
Reduces the effects of resistable syndromes, increases the speed at which one gains a resistance to resistable syndromes, and reduces the chance of wounds being infected. The dwarven median disease resistance of 1000 is exactly the human average. Having a disease resistance of 5000 does not grant immunities.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || virtually never sick
|-
| 1750–1999 || almost never sick
|-
| 1500–1749 || very rarely sick
|-
| 1250–1499 || rarely sick
|-
| 751–1249 || (no description)
|-
| 501–750 || susceptible to disease
|-
| 251–500 || quite susceptible to disease
|-
| 1–250 || really susceptible to disease
|-
| 0 || stunningly susceptible to disease
|}

== Skills by body attribute ==
{{SkillsByBodyAttribute}}

==Soul attributes==
The attribute values given in the tables correspond to default racial averages for dwarves only. Modded dwarves or any other creature will report the same phrases, but the underlying numbers may be very different. In almost every case, a higher attribute value is better, as opposed to [[personality trait]]s where one may prefer higher or lower depending on the situation.

From [http://www.bay12forums.com/smf/index.php?topic=60554.msg1413312#msg1413312 this post by Toady One]:
<blockquote>
With respect to skills: most of these attributes only affect duration, when that is the only available skill effect to begin with, but they are factored into outcomes when it applies.
</blockquote>

At the [[#Skills By Soul Attribute|bottom]] is a list of which attributes affect which skills. [[:Image:DFmental.PNG|This]] pair of charts provides an easier to read summary of the soul attributes that are useful for doctors and soldiers.

===Analytical ability===
The dwarven median analytical ability of 1250 is slightly above average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || awesome intellectual powers
|-
| 2000–2249 || great analytical abilities
|-
| 1750–1999 || a sharp intellect
|-
| 1500–1749 || a good intellect
|-
| 1001–1499 || (no description)
|-
| 751–1000 || poor analytical abilities
|-
| 501–750 || very bad analytical abilities
|-
| 251–500 || a lousy intellect
|-
| 0–250 || a stunning lack of analytical ability
|}

===Focus===
The dwarven median focus of 1500 is above average.

{| class=wikitable style="width:400px;"
! Value
! Description

|-
| 2500–5000 || unbreakable focus
|-
| 2250–2499 || a great ability to focus
|-
| 2000–2249 || very good focus
|-
| 1750–1999 || the ability to focus
|-
| 1251–1749 || (no description)
|-
| 1001–1250 || poor focus
|-
| 751–1000 || quite poor focus
|-
| 501–750 || really poor focus
|-
| 0–500 || the absolute inability to focus
|}

===Willpower===
If both this and ENDURANCE are effectively above 1750, prevents falling over from exhaustion. The dwarven median willpower of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an unbreakable will
|-
| 1750–1999 || an iron will
|-
| 1500–1749 || a lot of willpower
|-
| 1250–1499 || willpower
|-
| 751–1249 || (no description)
|-
| 501–750 || little willpower
|-
| 251–500 || a large deficit of willpower
|-
| 1–250 || next to no willpower
|-
| 0 || absolutely no willpower
|}

===Creativity===
The dwarven median creativity of 1250 is slightly above the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || a boundless creative imagination
|-
| 2000–2249 || great creativity
|-
| 1750–1999 || very good creativity
|-
| 1500–1749 || good creativity
|-
| 1001–1499 || (no description)
|-
| 751–1000 || meager creativity
|-
| 501–750 || poor creativity
|-
| 251–500 || lousy creativity
|-
| 0–250 || next to no creative talent
|}

===Intuition===
The dwarven median intuition of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || uncanny intuition
|-
| 1750–1999 || great intuition
|-
| 1500–1749 || very good intuition
|-
| 1250–1499 || good intuition
|-
| 751–1249 || (no description)
|-
| 501–750 || bad intuition
|-
| 251–500 || very bad intuition
|-
| 1–250 || lousy intuition
|-
| 0 || horrible intuition
|}

===Patience===
Some non-skill tasks are affected by Patience; for example, it directly impacts the rate at which a character in [[adventure mode]] will become impatient during a conversation, and thusly determines the length of the discussion.
The dwarven median patience of 1250 is slightly above the human average.
{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || absolutely boundless patience
|-
| 2000–2249 || a deep well of patience
|-
| 1750–1999 || a great deal of patience
|-
| 1500–1749 || a sum of patience
|-
| 1001–1499 || (no description)
|-
| 751–1000 || a shortage of patience
|-
| 501–750 || little patience
|-
| 251–500 || very little patience
|-
| 0–250 || no patience at all
|}

===Memory===
The dwarven median memory of 1250 is slightly above the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || an astonishing memory
|-
| 2000–2249 || an amazing memory
|-
| 1750–1999 || a great memory
|-
| 1500–1749 || a good memory
|-
| 1001–1499 || (no description)
|-
| 751–1000 || an iffy memory
|-
| 501–750 || a poor memory
|-
| 251–500 || a really bad memory
|-
| 0–250 || little memory to speak of
|}

===Linguistic ability===
The dwarven median linguistic ability of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an astonishing ability with languages and words
|-
| 1750–1999 || a great affinity for language
|-
| 1500–1749 || a natural inclination toward language
|-
| 1250–1499 || a way with words
|-
| 751–1249 || (no description)
|-
| 501–750 || a little difficulty with words
|-
| 251–500 || little linguistic ability
|-
| 1–250 || very little linguistic ability
|-
| 0 || difficulty with words and language
|}

===Spatial sense===
The dwarven median spatial sense of 1500 is above the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2500–5000 || a stunning feel for spatial relationships
|-
| 2250–2499 || an amazing spatial sense
|-
| 2000–2249 || a great feel for the surrounding space
|-
| 1750–1999 || a good spatial sense
|-
| 1251–1749 || (no description)
|-
| 1001–1250 || a questionable spatial sense
|-
| 751–1000 || poor spatial senses
|-
| 501–750 || an atrocious spatial sense
|-
| 0–500 || no sense for spatial relationships
|}

===Musicality===
The dwarven median musicality of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an astonishing knack for music
|-
| 1750–1999 || a great musical sense
|-
| 1500–1749 || a natural ability with music
|-
| 1250–1499 || a feel for music
|-
| 751–1249 || (no description)
|-
| 501–750 || an iffy sense for music
|-
| 251–500 || little natural inclination toward music
|-
| 1–250 || next to no natural musical ability
|-
| 0 || absolutely no feel for music at all
|}

===Kinesthetic sense===
No special effect, but it should be noted that it's the most important skill-governing mental attribute for combat. The dwarven median kinesthetic sense of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an astounding feel for the position of [his/her] own body
|-
| 1750–1999 || a great kinesthetic sense
|-
| 1500–1749 || a very good sense of the position of [his/her] own body
|-
| 1250–1499 || a good kinesthetic sense
|-
| 751–1249 || (no description)
|-
| 501–750 || a meager kinesthetic sense
|-
| 251–500 || a poor kinesthetic sense
|-
| 1–250 || a very clumsy kinesthetic sense
|-
| 0 || an unbelievably atrocious sense of the position of [his/her] own body
|}

===Empathy===
The dwarven median empathy of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an absolutely remarkable sense of others' emotions
|-
| 1750–1999 || a great sense of empathy
|-
| 1500–1749 || a very good sense of empathy
|-
| 1250–1499 || an ability to read emotions fairly well
|-
| 751–1249 || (no description)
|-
| 501–750 || poor empathy
|-
| 251–500 || a very bad sense of empathy
|-
| 1–250 || next to no empathy
|-
| 0 || the utter inability to judge others' emotions
|}

===Social awareness===
Along with the leadership skill, determines the max follower count in adventure mode. The dwarven median social awareness of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || a shockingly profound feel for social relationships
|-
| 1750–1999 || a great feel for social relationships
|-
| 1500–1749 || a very good feel for social relationships
|-
| 1250–1499 || a good feel for social relationships
|-
| 751–1249 || (no description)
|-
| 501–750 || a meager ability with social relationships
|-
| 251–500 || a poor ability to manage or understand social relationships
|-
| 1–250 || a lack of understanding of social relationships
|-
| 0 || an absolute inability to understand social relationships
|}

== Skills by soul attribute ==
{{SkillsBySoulAttribute}}

== Skills by associated attributes ==

{| border="1" cellpadding="2" style="border-spacing: 0; border-width: 1px; border-style: solid; text-align:center;"
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
!rowspan="144"|
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Miner]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Wood cutter]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Carpenter]] || {{X|A}} || {{X|B}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Engraver]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Mason]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Animal trainer]] || || {{X|A}} || {{X|B}} || {{X|C}} || || || || || {{X|C}} || {{X|B}} || || || || || || {{X|A}} ||
|-style="background:#f5f5f5;"
| [[Animal caretaker]] || || {{X|A}} || || || {{X|A}} || || || || || || {{X|B}} || || || || || {{X|C}} ||
|-
| [[Fish dissector]] || || {{X|A}} || || || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Animal dissector]] || || {{X|A}} || || || || || || || || || || || || || {{X|A}} || ||
|-
| [[Fish cleaner]] || || {{X|A}} || || {{X|B}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Butcher]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Trapper]] || || {{X|A}} || || || {{X|A}} || || || {{X|B}} || || || || || {{X|C}} || || || ||
|-style="background:#f5f5f5;"
| [[Tanner]] || || {{X|A}} || || || || || || || || || || || || || {{X|A}} || ||
|-
| [[Weaver]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Brewer]] || {{X|A}} || {{X|B}} || || || || || || || || || || || || || {{X|A}} || ||
|-
| [[Clothier]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Miller]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Thresher]] || {{X|B}} || {{X|A}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Cheese maker]] || {{X|B}} || {{X|A}} || || {{X|C}} || {{X|B}} || || || {{X|C}} || || || || || || || {{X|A}} || ||
|-
| [[Milker]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Cook]] || || {{X|A}} || || || {{X|B}} || || || {{X|C}} || || || || || || || {{X|A}} || ||
|-
| [[Planter]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Herbalist]] || || {{X|A}} || || || || || || || || || {{X|B}} || || || || {{X|A}} || ||
|-
| [[Fisherdwarf]] || {{X|B}} || {{X|A}} || || || || {{X|A}} || || || || {{X|B}} || || || || || {{X|C}} || ||
|-style="background:#f5f5f5;"
| [[Furnace operator]] || {{X|A}} || || {{X|B}} || {{X|C}} || {{X|B}} || || || || || || || || || || {{X|A}} || ||
|-
| [[Strand extractor]] || {{X|B}} || {{X|A}} || || {{X|C}} || {{X|B}} || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Weaponsmith]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Armorsmith]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Metalsmith]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Gem cutter]] || || {{X|A}} || || || {{X|C}} || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Gem setter]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Wood crafter]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Stone crafter]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Metal crafter]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Glassmaker]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Leatherworker]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Bone carver]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Axeman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Swordsman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Knife user]] || {{X|B}} || {{X|A}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Maceman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Hammerman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Spearman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Crossbowman]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-style="background:#f5f5f5;"
| [[Shield user]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Armor user]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || {{X|B}} || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Siege engineer]] || {{X|A}} || {{X|B}} || || {{X|C}} || {{X|A}} || || || {{X|B}} || || || || || {{X|C}} || || || ||
|-
| [[Siege operator]] || {{X|A}} || || {{X|B}} || {{X|C}} || {{X|B}} || {{X|C}} || || || || || || || {{X|A}} || || || ||
|-style="background:#f5f5f5;"
| [[Bowyer]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Pikeman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Lasher]] || {{X|B}} || {{X|A}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Bowman]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-style="background:#f5f5f5;"
| [[Blowgunner]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Thrower]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|A}} || || {{X|B}} || ||
|-style="background:#f5f5f5;"
| [[Mechanic]] || {{X|B}} || {{X|A}} || || {{X|C}} || {{X|A}} || || || {{X|B}} || || || || || {{X|C}} || || || ||
|-
| [[Druid]] || || {{X|B}} || {{X|C}} || {{X|A}} || || {{X|C}} || {{X|B}} || || || || || || || || || {{X|A}} ||
|-style="background:#f5f5f5;"
| [[Ambusher]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Wound dresser]] || || {{X|A}} || || || || || || || || || || || {{X|B}} || || {{X|A}} || {{X|C}} ||
|-style="background:#f5f5f5;"
| [[Diagnostician]] || || || || || {{X|A}} || || || || {{X|C}} || || {{X|B}} || || || || || ||
|-
| [[Surgeon]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|B}} || || {{X|A}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Bone doctor]] || {{X|B}} || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Suturer]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Crutch-walker]] || || {{X|A}} || || {{X|B}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Wood burner]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Lye maker]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Soaper]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Potash maker]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Dyer]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Pump operator]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || {{X|B}} || || || || || || || || {{X|A}} || ||
|-
| [[Swimmer]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Persuader]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Negotiator]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-style="background:#f5f5f5;"
| [[Judge of intent]] || || || || || || || || || {{X|C}} || || || || || || || {{X|A}} || {{X|B}}
|-
| [[Appraiser]] || || || || || {{X|A}} || || || || {{X|C}} || || {{X|B}} || || || || || ||
|-style="background:#f5f5f5;"
| [[Organizer]] || || || || || {{X|A}} || || || {{X|C}} || || || || || || || || || {{X|B}}
|-
| [[Record keeper]] || || || || || {{X|A}} || {{X|C}} || || || || || {{X|B}} || || || || || ||
|-style="background:#f5f5f5;"
| [[Liar]] || || || || || || || || {{X|C}} || || || || {{X|A}} || || || || || {{X|B}}
|-
| [[Intimidator]] || {{X|A}} || {{X|B}} || || || || || || || || || || {{X|A}} || || || {{X|B}} || ||
|-style="background:#f5f5f5;"
| [[Conversationalist]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Comedian]] || || {{X|A}} || || || || || || {{X|B}} || || || || {{X|A}} || || || {{X|C}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Flatterer]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Consoler]] || || || || || || || || || || || || {{X|B}} || || || || {{X|A}} || {{X|C}}
|-style="background:#f5f5f5;"
| [[Pacifier]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Tracker]] || || || || || {{X|A}} || || || || {{X|B}} || || || || {{X|C}} || || || ||
|-style="background:#f5f5f5;"
| [[Student]] || || || || || {{X|B}} || {{X|C}} || || || || || {{X|A}} || || || || || ||
|-
| [[Concentration]] || || || || || || {{X|A}} || {{X|C}} || || || {{X|B}} || || || || || || ||
|-style="background:#f5f5f5;"
| [[Discipline]] || || || || || || {{X|B}} || {{X|A}} || || || || || || || || || ||
|-
| [[Observer]] || || || || || || {{X|B}} || || || {{X|C}} || || || || {{X|A}} || || || ||
|-style="background:#f5f5f5;"
| [[Wordsmith]] || || || || || || || || {{X|B}} || {{X|C}} || || || {{X|A}} || || || || ||
|-
| [[Writer]] || || || || || || || || {{X|B}} || {{X|C}} || || || {{X|A}} || || || || ||
|-style="background:#f5f5f5;"
| [[Poet]] || || || || || || || || {{X|B}} || {{X|C}} || || || {{X|A}} || || || || ||
|-
| [[Reader]] || || || || || || {{X|B}} || || || || || {{X|C}} || {{X|A}} || || || || ||
|-style="background:#f5f5f5;"
| [[Speaker]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Coordination]] || || {{X|A}} || || || || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Balance]] || {{X|B}} || {{X|A}} || || || || || || || || || || || || || {{X|A}} || ||
|-
| [[Leader]] || || || || || || || || || || || || {{X|C}} || || || || {{X|A}} || {{X|B}}
|-style="background:#f5f5f5;"
| [[Teacher]] || || || || || || || || || || || || {{X|C}} || || || || {{X|A}} || {{X|B}}
|-
| [[Fighter]] || {{X|B}} || {{X|A}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Archer]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Wrestler]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Biter]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Striker]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Kicker]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Dodger]] || || {{X|A}} || {{X|B}} || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Misc. object user]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Knapper]] || {{X|B}} || {{X|A}} || || || {{X|B}} || || || || || || || || {{X|A}} || || {{X|C}} || ||
|-style="background:#f5f5f5;"
| [[Tactician]] || || || || || {{X|A}} || || || {{X|B}} || {{X|C}} || || || || || || || ||
|-
| [[Shearer]] || {{X|B}} || {{X|A}} || || {{X|C}} || || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Spinner]] || {{X|B}} || {{X|A}} || || {{X|C}} || || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Potter]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Glazer]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Presser]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Beekeeper]] || {{X|B}} || {{X|A}} || || {{X|C}} || {{X|A}} || || || || || || || || {{X|B}} || || {{X|C}} || ||
|-
| [[Wax worker]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Climber]] || {{X|B}} || {{X|C}} || || {{X|A}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Gelder]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Dancer]] || {{X|C}} || {{X|A}} || || {{X|B}} || || || || || || || || || {{X|B}} || {{X|C}} || {{X|A}} || ||
|-
| [[Musician]] || || || || || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-style="background:#f5f5f5;"
| [[Singer]] || || || || || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-
| [[Keyboardist]] || || {{X|A}} || || || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Stringed instrumentalist]] || || {{X|A}} || || || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-
| [[Wind instrumentalist]] || || {{X|A}} || || {{X|B}} || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-style="background:#f5f5f5;"
| [[Percussionist]] || {{X|C}} || {{X|A}} || || {{X|B}} || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-
| [[Critical thinker]] || || || || || {{X|A}} || || || || || || || || || || || ||
|-style="background:#f5f5f5;"
| [[Logician]] || || || || || {{X|A}} || || || || || || || || || || || ||
|-
| [[Mathematician]] || || || || || {{X|A}} || || || || || || {{X|C}} || || {{X|B}} || || || ||
|-style="background:#f5f5f5;"
| [[Astronomer]] || || || || || {{X|A}} || || || || || || {{X|C}} || || {{X|B}} || || || ||
|-
| [[Chemist]] || || || || || {{X|A}} || {{X|B}} || || || || || {{X|C}} || || || || || ||
|-style="background:#f5f5f5;"
| [[Geographer]] || || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || || || ||
|-
| [[Optics engineer]] || || || || || {{X|B}} || {{X|C}} || || || || || || || {{X|A}} || || || ||
|-style="background:#f5f5f5;"
| [[Fluid engineer]] || || || || || {{X|B}} || {{X|C}} || || || || || || || {{X|A}} || || || ||
|-
| [[Papermaker]] || {{X|A}} || {{X|B}} || || || || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Bookbinder]] || || {{X|A}} || || || || || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Schemer]] || || || || || || || || {{X|C}} || {{X|B}} || || || || || || || || {{X|A}}
|-style="background:#f5f5f5;"
| [[Rider]] || || {{X|A}} || || || || || {{X|C}} || || || || || || || || {{X|A}} || {{X|B}} ||
|-
| [[Stonecutter]] || {{X|A}} || {{X|B}} || || || || || || || || {{X|C}} || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Stone carver]] || {{X|B}} || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|}

Notes:
*Skills have both Primary attributes (labeled "A") and Secondary attributes (labeled "B" and "C"). Primary attributes give a bonus for every 100 points, while secondary attributes give a bonus for every 250 points.
*Spatial Sense and Kinesthetic Sense are almost everywhere
*Nothing trains Disease Resistance or Recuperation
*Intimidator and Comedian, both social skills, raise Agility. Dwarven comedy is slapstick/clowning, not stand-up.
*Student skill doesn't boost skill gain except for teacher-student relations in a barracks
*Choose high-volume labors that train useful attributes for militia day-jobs/bootcamp
*Fishing, Siege Operating, and Record Keeping are useful for marksdwarves as they train the Focus attribute
*Hunting (ambusher/sneak) has identical attribute gain to Crossbow and Archer skills

== Dwarf attributes ==

Each attribute is a number between 0 and 5000, but in dwarven terms anything below 200 is rare [http://dffd.bay12games.com/file.php?id=5882] and anything above 2500 is extraordinary. In the default raws (/raw/objects/creature_standard.txt), dwarven attributes come in four levels.

Focus and Spatial Sense are referred to as "++", or two steps above default. Their range is defined as [700:1200:1400:1500:1600:1800:2500], which sets out six ranges: 700-1200, 1200-1400, etc. Dwarves have an equal chance of dropping into any of these ranges, and an equal probability again of getting any number in that range. So the bottom one-sixth of your dwarves will be really low, the top one-sixth really high, and the two-thirds in the middle huddled around average. This also means that the median and the mean are slightly different: the mean for ++ is 1516.66... while median is 1500.

Strength, Toughness, Analytical Ability, Creativity, Patience, and Memory are +, or one step above default. Their ranges are [450:950:1150:1250:1350:1550:2250], and their mean is 1266.66...

Endurance, Disease Resistance, Recuperation, Intuition, Willpower, Kinesthetic Sense, Linguistic Ability, Musicality, Empathy, and Social Awareness are AVG, or the default. Their ranges are not specified in the raws, but they are [200:700:900:1000:1100:1300:2000] for Physical and [200:800:900:1000:1100:1300:2000] for Mental.

Agility is "-", the only attribute to be below default. Its ranges are [150:600:800:900:1000:1100:1500], mean 870.83..., median 900.

== Training attributes ==

It would seem that various skills train various attributes at different rates. For physical attributes and Willpower, military training works best - it relatively quickly gives a dwarf some extra Agility and Strength, making them walk and work faster in all areas (According to [http://www.bay12forums.com/smf/index.php?topic=121573.msg3944723#msg3944723] speed is a factor in determining how fast a labor is completed).

According to [https://www.reddit.com/r/dwarffortress/comments/zquv8f/psa_you_can_build_a_gym_for_your_military_with/] Reddit post, strength and stamina can be trained via screw pumps reasonably quickly. The pumps don't have to be adjacent to any liquids, and dwarves will still operate them, pumping air.

Plant gathering trains Agility, Kinesthetic Sense, and Memory to a lesser degree. After a couple of years, plant gatherers become the faster dwarves in the fortress and are generally suitable for transfer to any demanding job.

All attribute values are capped based on their initial value, the attribute's {{token|MENT_ATT_CAP_PERC}} or {{token|PHYS_ATT_CAP_PERC}} value (which defaults to 200), and the attribute's ''median'' value (i.e. the middle value in {{token|PHYS_ATT_RANGE}} or {{token|MENT_ATT_RANGE}}) - the exact cap is either ``(starting_value * ATT_CAP_PERC) / 100`` or ``starting_value + ATT_RANGE.MEDIAN``, whichever is higher.

The speed of learning attributes is governed by "cost to improve" in {{token|PHYS_ATT_RATES}} and {{token|MENT_ATT_RATES}}. By default CTI for attributes is 500, which means the counter for using that attribute has to be incremented 500 times for the dwarf to gain 1 in that attribute. The lower the CTI, the faster an attribute increases. According to [http://www.bay12forums.com/smf/index.php?topic=66525.msg3993120#msg3993120] the counter is incremented every ten ticks a skill using that attribute is in use. This means it takes 5000 TUs or just over 4 in-game days of continuous labor to improve an attribute by 1. The improved attribute gain from military training may stem from the fact that sparring and individual combat drills train multiple skills at the same time.

==Standard ranges==

The game comes pre-stocked with several sets of attribute ranges, some better than others. The signs that come after the numeral ranges indicate what level that range represents, but have no effect in and of themselves.

{|
|[0:0:0:0:0:0:0] || unattainable
|-
|[0:100:200:300:400:450:500] || ---
|-
|[0:400:600:750:800:900:1100] || --
|-
|[150:600:800:900:1000:1100:1500] || -
|-
|[200:700:900:1000:1100:1300:2000] || Default
|-
|[450:950:1150:1250:1350:1550:2250] || +
|-
|[700:1200:1400:1500:1600:1800:2500] || ++
|-
|[1250:1500:1750:2000:2500:3000:5000]|| +++
|-
|[5000:5000:5000:5000:5000:5000:5000]|| max
|}

{{Category|Game mechanics}}
[[ru:Attribute]]

Ambusher

2025-09-20T19:45:03Z

Putnam3145:

{{Quality|Exceptional|14:15, 12 February 2023 (CST)}}
{{v50_skill
| color = 2:0
| graphic = [[File:hunter_sprite.png]]
| skill = Ambusher
| specialty = Hunter
| profession = [[Ranger]]
| job name = [[Hunting]]
| tasks =
* Hunt
| attributes =
* Agility
* Focus
* Spatial Sense
* Kinesthetic Sense}}
{{av}}
''Not to be confused with [[Ambush]].''

The '''ambusher''' skill is what determines how well a unit can sneak without being caught. In fortress mode, [[dwarves]] with the '''hunting''' [[labor]] enabled automatically use the '''ambusher''' skill while hunting outside of the fortress, which allows them to sneak up on their prey. Players need a crossbow, a [[quiver]], and [[bolt]]s to successfully hunt. The ambusher skill is listed among the 'misc' skills, the higher the character skill, the closer they can get. Dwarves using the ambush skill move more slowly, but, if successful, cannot be seen by enemies. Once close enough, the ambusher skill is no longer relevant, and the hunter will engage in standard [[combat]] with their prey, using their [[crossbow]]. The skill is also used by enemy [[thief|thieves]] and [[ambush]]ers raiding your fortress or when you return the favor [[raid]]ing their sites.

The standard load for embarking includes 3 quivers, and any [[immigration|immigrating]] hunters arrive with a full set of proper equipment: a metal crossbow, a quiver, and some bolts. A hunter armed with a crossbow will increase their [[Crossbowman|marksdwarf]], ambusher, and [[archery]] [[skill]]s. Graphically, ambushers will wear green clothes with brown underclothing, gloves and shoes.

Since hunting is employed by players with varying success, and your military will go after any game that looks at them funny anyway, you might be safer doing the good old 'hunt with your military'. After all, your military can be told to pick a specific target, and, more conveniently, to ''stop'', too - one must remove the hunting labor from a hunter to get them to stop. The downside is that your military will often mangle the corpse in the process, making it unfit for butchering.

== Caveats ==
A dwarf with the hunting labor enabled will sleep outside, causing unhappy thoughts. It may thus be necessary to watch the mood of a full-time hunter and take them off the job in time.

[[Creature|Animals]] suitable to the biome will appear randomly on the edge of a map on each layer. By default, the layers are the surface and each cavern layer; dwarves can hunt wild animals on each of these layers. Only one group of animals will appear at any given time, and as soon as one group leaves another will take its place. This can result in your [[hoary marmot|marmot]] hunter suddenly having an unpleasant chitchat with an [[elephant]], [[giant eagle]], or [[cave dragon|worse]]. However, a seasoned and well-equipped hunter is more than a match for a giant eagle, and can be a good preemptive defense for your above-ground workers.

An unskilled hunter will crawl in ambush mode, making the hunter unable to reach fast animals like badgers. Fortunately, an experienced one will be able to rapidly bring down even swift prey.

Ten novice hunters working together can take down even very large, very fast animals. A highly skilled and agile hunter will be able to single-handedly take down nearly anything.

If you have access to other ranged [[weapon]]s, [[bow]]s and [[blowgun]]s are not considered valid for hunting. Only weapons that use the [[crossbow]]/marksdwarf [[Weapon skill|skill]] work.

== Hunting ==
A hunter picks a mark at random, which they then pursue. Hunters seem to switch marks under certain circumstances. As an ambusher gets closer to their prey, there is a greater and greater chance they will be spotted by the animal and stop ambushing. Higher skill allows dwarves to get closer before being spotted, and also increases the speed at which a dwarf can move while sneaking. Generally, when the dwarf is within shooting range the dwarf will move to engage. From there, the ambusher skill has no effect, and only combat skills are used.

You can assign animals [[Animal trainer|trained]] for hunting, like [[dog]]s, to your hunters, which can sneak alongside their masters and attack the hunter's prey. You can also assign war beasts, which are much stronger and can help take down bigger game, but cannot sneak and may rush into combat early.

Upon killing the prey, a hunter will usually carry it home to the [[butcher's shop]] from where a [[butcher]] will then take over, and process the game animal to create many byproducts. The hunter may kill other creatures that are closer to them than the fleeing mark they are intent on catching. They will ignore the accidental carcasses, only bringing home the carcasses they have marked beforehand. This means that sometimes multiple dead critters per hunt will be lying about and start rotting around the map, if you do not set the refuse orders to 'gather refuse from outside' ([[corpse]]s count as refuse). If you do this and have a good system of [[stockpile|stockpiles]], available dwarf [[hauling|haulers]] and a map free of menacing critters (like with calm [[surroundings]]), then you should have the outside of your fort just as tidy as the inside, and will be able to salvage the corpses. If you do that on the wrong map, you will see some dwarf carcasses added instead.

Hunters will shoot bolts at carp and other water creatures in a river. They won't recover the dead fish, though.

After a period of time, most hunters will eventually cause the mass [[extinction]] of the wild animals in the biomes where your fort is located. There are two ways to prevent this: The first is to ensure that some animals always escape; many animals spawn on the map in groups or herds, and as long as at least one member of this group survives to leave the map later, the population of that creature will not decrease. The second method is to capture the wild animals, breed them, and then either release them back into the biome, or hunt the offspring.

Necromancer hunters will sometimes raise the corpses of their prey, which they then get attacked by.

== Weapons and tactics ==
You should consider training hunters in [[wrestling]] in order for them to defend themselves - it will help them to break the jaw-grips that the enemy critter places on them, and will help the dwarf wrestle on their own, and even to place their own jaw grips if both of their hands are incapacitated - the only option if a weapon is dropped or stuck in the animal. You should also consider training them in the [[hammerdwarf]] skill, as a crossbow is used with this skill if an animal engages in melee against a marksdwarf. Hunters will fight to the death if engaged, but get a job cancellation if they run out of bolts, which will cause them to run away from their target as fast as they can. Without bolts assigned, they may fight with the butt of the crossbow, which functions similarly to a [[war hammer]].

Using your military to hunt can be safer than using mere civilian hunters, particularly if they are agile enough to simply outrun the creatures. Military dwarves will typically be much better protected thanks to their [[armor]], and using them comes with the benefit of training their [[combat skill]]s when they fight their mark. However, this often mangles the corpse of the hunted creature making them unfit to be butchered.

Be warned that hunters will not stop their current hunt if you disable their hunting labor; hence, your dwarf may end up hunting whatever creatures spawn next, with potentially-suicidal results. This may be avoidable by disabling the labor while hunting or returning the kill.

== Adventurer mode ==
[[File:sneak_button_preview.png|right]]In [[adventurer mode]], ambusher skill is gained by moving around while {{Adv menu icon|S}} sneaking is toggled on. Sneak mode will automatically toggle off during sleep/wait and on the first move from fast travel, so in order to ambush random encounters, you should remember to toggle it back on before continuing.

A sneaking character can remain undetected by others so long as they remain out of the other creatures' scope of perception, which varies by sensory organs and [[observer]] skill. Until the character is detected, no [[level of conflict]] is generated between the character and an enemy or timid creature. Entering a friendly creature's scope of perception will generate some social discomfort toward your character. You will be unable to conceal yourself from any creature who detects you, but you will not automatically be revealed to others.

Movement rates at normal or slower [[gait]] are unmodified by stealth, but reduced at gaits faster than walk. Ambushing success is also sharply reduced by quicker gaits. Ambushing skill offsets the sneak penalty for faster gaits, but not the movement rate penalty.

== Raids ==
When sending your dwarves on raid [[missions]] (not pillaging or razing), the ambusher skill will affect their chances of success in relation to being spotted. Additionally, raiders may gain ambusher experience.

== Bugs ==
* Weapons of hunters might not be assigned properly. Even if a hunter has a quiver and bow and assigned ammo, they may not have the ''right'' bow. Disable their hunting skill so they stockpile their equipment, then re-enable hunting when they're done.
* Having the Hunter labor toggled on will stop the dwarf from [[sleep]]ing in their [[bedroom]], making them accumulate negative [[thought]]s from having to sleep on the floor (if unsmoothed, apparently). Toggling the Hunter labor off allows them to use their bedrooms properly.

{{Skills}}

Material definition token

2025-09-06T22:31:33Z

Putnam3145: /* Material properties */ From the source code.

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

The following [[token]]s can be used in creating new [[:Category:material template raw pages|material templates]], as well as in [[material]] definitions (whether for inorganics or those within plants and creatures).

Material templates are used to define broad classes of materials (eg. "stone", or "milk"), the properties of which can be imported into other more specific material definitions (eg. "granite", or "llama milk") using the <code>[USE_MATERIAL_TEMPLATE:template_name]</code> token. When creating material templates, the <code>[OBJECT:MATERIAL_TEMPLATE]</code> [[token]] begins the definition of a material template [[raw file]]. Following this, each new material template definition begins with the <code>[MATERIAL_TEMPLATE:template_name]</code> token, where <code>template_name</code> is a unique identifier for the template, and that material's properties are then defined using the tokens listed below.

{{Urist asks|q=Materials use specific, often bespoke, units. Are there any tools to help convert from real-world values?|a=
Here are some web-based [[utilities]] designed for raw authoring.

For [[material science|yield]] and [[strain at yield|elasticity]]: https://putnam3145.github.io/helper

For [[temperature]]: https://jose96xd.github.io/DF_Tools/Modules/TemperatureConverter.html
}}

__TOC__
{{clear}}

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

|-
| {{text_anchor|USE_MATERIAL_TEMPLATE}}
|
* <template name>
| Resets all material tokens back to their default values, then imports the tokens of the specified preexisting material template (overriding any tokens defined prior to itself in the material). This means USE_MATERIAL_TEMPLATE should be the first token present in any material using it. It cannot be used inside of a [MATERIAL_TEMPLATE:X] which prevents the creation of nested material template structures.

|-
| {{text_anchor|PREFIX}}
|
* <prefix> or NONE
| Applies a prefix to all items made from the material. For PLANT and CREATURE materials, this defaults to the plant/creature name. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|STONE_NAME}}
|
* <name>
| Overrides the name of [[Item token#BOULDER|BOULDER]] items (i.e. mined-out stones) made of the material (used for native copper/silver/gold/platinum to make them be called "nuggets" instead of "boulders").

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

|-
| {{text_anchor|TEMP_DIET_INFO}}
|
* <type>
| Specifies what the material should be treated as when drinking water contaminated by it, for generating unhappy [[thought]]s. Valid values are BLOOD, SLIME, VOMIT, ICHOR, PUS, GOO, GRIME, and FILTH.

|-
| {{text_anchor|POWDER_DYE}}
|
*<[[Color#Color tokens|color token]]>
| Allows the material to be used as [[dye]], and defines color of dyed items.

|-
| {{text_anchor|TILE}}
|
*<[[Main:Character table|tile value or character]]>
| Specifies the tile that will be used to represent unmined tiles made of this material. Generally only used with stones. Defaults to 219 ('█').

|-
| {{text_anchor|ITEM_SYMBOL}}
|
*<[[Main:Character table|tile value or character]]>
| Specifies the tile that will be used to represent [[Item token#BOULDER|BOULDER]] items made of this material. Generally only used with stones. Defaults to 7 ('•').

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

|-
| {{text_anchor|BUILD_COLOR}}
|
*<[[Color#Color values|foreground color]]>
*<[[Color#Color values|background color]]>
*<[[Color#Color values|foreground brightness]]>
| The color of objects made of this material which use both the foreground and background color: [[door]]s, [[floodgate]]s, [[hatch cover]]s, [[bin]]s, [[barrel]]s, and [[cage]]s. Defaults to 7:7:1 (white).

|-
| {{text_anchor|TILE_COLOR}}
|
*<[[Color#Color values|foreground color]]>
*<[[Color#Color values|background color]]>
*<[[Color#Color values|foreground brightness]]>
| The color of unmined tiles containing this material (for stone and soil), as well as [[engraving]]s in this material. Defaults to 7:7:1 (white).

|-
| {{text_anchor|BASIC_COLOR}}
|
*<[[Color#Color values|foreground color]]>
*<[[Color#Color values|foreground brightness]]>
| The color of objects made of this material which use only the foreground color, including workshops, floors and boulders, and smoothed walls. Defaults to 7:1 (white).

|-
| {{text_anchor|STATE_COLOR}}
|
*<[[#Material states|material state]]>
*<[[Color#Color tokens|color token]]>
| Determines the color of the material at the specified state. Color comes from descriptor_color_standard.txt. The nearest color value is used to display contaminants and body parts made of this material in ASCII and to color items and constructions made from this material with graphics. Example:
[STATE_COLOR:ALL_SOLID:GRAY]

|-
| {{text_anchor|STATE_NAME}}
|
*<[[#Material states|material state]]>
*<name>
| Determines the name of the material at the specified state, as displayed in-game.
[STATE_NAME:ALL_SOLID:stone]

|-
| {{text_anchor|STATE_ADJ}}
|
*<[[#Material states|material state]]>
*<adjective>
| Like [[#STATE_NAME|STATE_NAME]], but used in different situations. Equipment made from the material uses the state adjective and not the state name.

|-
| {{text_anchor|STATE_NAME_ADJ}}
|
*<[[#Material states|material state]]>
*<name>
*<adjective>
| Sets both [[#STATE_NAME|STATE_NAME]] and [[#STATE_ADJ|STATE_ADJ]] at the same time.

|-
| {{text_anchor|ABSORPTION}}
|
*<value>
| The material's tendency to absorb liquids. Containers made of materials with nonzero absorption cannot hold liquids unless they have been [[glaze]]d. Defaults to 0.

|-
| {{text_anchor|IMPACT_YIELD}}
|
*<pressure>
| Specifies how hard of an impact (in kPa) the material can withstand before it will start deforming permanently. Used for blunt-force combat. Defaults to 10000.

|-
| {{text_anchor|IMPACT_FRACTURE}}
|
*<pressure>
| Specifies how hard of an impact the material can withstand before it will fail entirely. Used for blunt-force combat. Defaults to 10000.

|-
| {{text_anchor|IMPACT_STRAIN_AT_YIELD}} or {{text_anchor|IMPACT_ELASTICITY}}
|
*<[[Strain at yield|strain]]>
| Specifies how much the material will have given (in parts-per-100000) when the yield point is reached. Used for blunt-force combat. Defaults to 0. Apparently affects in combat whether the corresponding tissue is bruised (value >= 50000), torn (value between 25000 and 49999), or fractured (value <= 24999)

|-
| {{text_anchor|COMPRESSIVE_YIELD}}
|
*<pressure>
| Specifies how hard the material can be compressed before it will start deforming permanently. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 10000.

|-
| {{text_anchor|COMPRESSIVE_FRACTURE}}
|
*<pressure>
| Specifies how hard the material can be compressed before it will fail entirely. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 10000.

|-
| {{text_anchor|COMPRESSIVE_STRAIN_AT_YIELD}} or {{text_anchor|COMPRESSIVE_ELASTICITY}}
|
*<[[Strain at yield|strain]]>
| Specifies how much the material will have given when it has been compressed to its yield point. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 0.

|-
| {{text_anchor|TENSILE_YIELD}}
|
*<pressure>
| Specifies how hard the material can be stretched before it will start deforming permanently. Determines a tissue's resistance to latching and shaking (50% chance, with torsion the other 50%). Defaults to 10000.

|-
| {{text_anchor|TENSILE_FRACTURE}}
|
*<pressure>
| Specifies how hard the material can be stretched before it will fail entirely. Determines a tissue's resistance to latching and shaking (50% chance). Defaults to 10000.

|-
| {{text_anchor|TENSILE_STRAIN_AT_YIELD}} or {{text_anchor|TENSILE_ELASTICITY}}
|
*<[[Strain at yield|strain]]>
| Specifies how much the material will have given when it is stretched to its yield point. Determines a tissue's resistance to to latching and shaking (50% chance). Defaults to 0.

|-
| {{text_anchor|TORSION_YIELD}}
|
*<pressure>
| Specifies how hard the material can be twisted before it will start deforming permanently. Used for latching and shaking (50% chance). Defaults to 10000.

|-
| {{text_anchor|TORSION_FRACTURE}}
|
*<pressure>
| Specifies how hard the material can be twisted before it will fail entirely. Used for latching and shaking (50% chance). Defaults to 10000.

|-
| {{text_anchor|TORSION_STRAIN_AT_YIELD}} or {{text_anchor|TORSION_ELASTICITY}}
|
*<[[Strain at yield|strain]]>
| Specifies how much the material will have given when it is twisted to its yield point. Used for latching and shaking (50% chance). Defaults to 0.

|-
| {{text_anchor|SHEAR_YIELD}}
|
*<pressure>
| Specifies how hard the material can be sheared before it will start deforming permanently. Used for cutting calculations. Defaults to 10000.

|-
| {{text_anchor|SHEAR_FRACTURE}}
|
*<pressure>
| Specifies how hard the material can be sheared before it will fail entirely. Used for cutting calculations. Defaults to 10000.

|-
| {{text_anchor|SHEAR_STRAIN_AT_YIELD}} or {{text_anchor|SHEAR_ELASTICITY}}
|
*<[[Strain at yield|strain]]>
| Specifies how much the material will have given when sheared to its yield point. Used for cutting calculations. Defaults to 0.

|-
| {{text_anchor|BENDING_YIELD}}
|
*<pressure>
| Specifies how hard the material can be bent before it will start deforming permanently. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 10000.

|-
| {{text_anchor|BENDING_FRACTURE}}
|
*<pressure>
| Specifies how hard the material can be bent before it will fail entirely. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 10000.

|-
| {{text_anchor|BENDING_STRAIN_AT_YIELD}} or {{text_anchor|BENDING_ELASTICITY}}
|
*<[[Strain at yield|strain]]>
| Specifies how much the material will have given when bent to its yield point. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 0.

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

|-
| {{text_anchor|MATERIAL_VALUE}}
|
*<[[item value]]>
| Value modifier for the material. Defaults to 1. This number can be made negative by placing a "-" in front, resulting in things that you are paid to buy and must pay to sell.

|-
| {{text_anchor|MULTIPLY_VALUE}}
|
*<[[item value]]>
| Multiplies the value of the material. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|SPEC_HEAT}}
|
*<specific heat capacity>
| Rate at which the material heats up or cools down (in J⋅kg−1⋅K−1.). If set to NONE, the temperature will be fixed at its initial value. See [[Temperature]] for more information. Defaults to NONE.

|-
| {{text_anchor|HEATDAM_POINT}}
|
*<[[temperature]]>
| Temperature above which the material takes damage from heat. May be set to NONE. If the material has an ignite point but no heatdam point, it will burn for a very long time (9 months and 16.8 days). Defaults to NONE.

|-
| {{text_anchor|COLDDAM_POINT}}
|
*<[[temperature]]>
| Temperature below which the material takes damage from cold. Defaults to NONE.

|-
| {{text_anchor|IGNITE_POINT}}
|
*<[[temperature]]>
| Temperature at which the material will catch fire. Defaults to NONE.

|-
| {{text_anchor|MELTING_POINT}}
|
*<[[temperature]]>
| Temperature at which the material melts. Defaults to NONE.

|-
| {{text_anchor|BOILING_POINT}}
|
*<[[temperature]]>
| Temperature at which the material boils. Defaults to NONE.

|-
| {{text_anchor|MAT_FIXED_TEMP}}
|
*<[[temperature]]>
| Items composed of this material will initially have this temperature. Used in conjunction with <code>[SPEC_HEAT:NONE]</code> to make material's temperature fixed at the specified value. Defaults to NONE.

|-
| {{text_anchor|IF_EXISTS_SET_HEATDAM_POINT}}
|
*<[[temperature]]>
| Changes a material's HEATDAM_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_COLDDAM_POINT}}
|
*<[[temperature]]>
| Changes a material's COLDDAM_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_IGNITE_POINT}}
|
*<[[temperature]]>
| Changes a material's IGNITE_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_MELTING_POINT}}
|
*<[[temperature]]>
| Changes a material's MELTING_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_BOILING_POINT}}
|
*<[[temperature]]>
| Changes a material's BOILING_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_MAT_FIXED_TEMP}}
|
*<[[temperature]]>
| Changes a material's MAT_FIXED_TEMP, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|SOLID_DENSITY}}
|
*<[[density]]>
| Specifies the density (in kg/m³) of the material when in solid form. Also affects combat calculations; affects blunt-force damage and ability of weak-in-impact-yield blunt attacks to pierce armor. Defaults to NONE.

|-
| {{text_anchor|LIQUID_DENSITY}}
|
*<[[density]]>
| Specifies the density of the material when in liquid form. Defaults to NONE. Also affects combat calculations; affects blunt force damage like SOLID_DENSITY, but only for attacks made by liquids (e.g. forgotten beasts made of water).

|-
| {{text_anchor|MOLAR_MASS}}
|
*<value>
| Specifies (in kg/mol) the molar mass of the material in gaseous form. Only affects combat calculations like the densities, and only for attacks made by gases (e.g. forgotten beasts made of steam).

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

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

|-
| {{text_anchor|MEAT_NAME}}
|
*<prefix>
*<name>
*<adjective>
| When a creature is butchered, meat yielded from organs made from this material will be named via this token. If this token is not specified, meat objects will be called "chops" instead.

|-
| {{text_anchor|BLOCK_NAME}}
|
*<singular>
*<plural>
| Specifies the name of [[block]]s made from this material.

|-
| {{text_anchor|WAFERS}}
|
| The material forms "wafers" instead of "[[bar]]s".

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

|-
| {{text_anchor|ITEM_REACTION_PRODUCT}}
|
*<item reference>
*<[[item token]]>
*<[[material token]]>
| Used with reaction raws to associate a reagent material with a complete item. The first argument is used by HAS_ITEM_REACTION_PRODUCT and GET_ITEM_DATA_FROM_REAGENT in reaction raws. The rest refers to the type of item, then its material.
[ITEM_REACTION_PRODUCT:BAG_ITEM:PLANT_GROWTH:LEAVES:LOCAL_PLANT_MAT:LEAF]

|-
| {{text_anchor|REACTION_CLASS}}
|
*<reaction class name>
| Used to classify all items made of the material, so that reactions can use them as generic reagents.
In default raws, the following are used:
* FAT, TALLOW, SOAP, PARCHMENT, PAPER_PLANT, PAPER_SLURRY, MILK, CHEESE, WAX
* CAN_GLAZE - items made from this material can be glazed.
* FLUX - can be used as [[flux]] in pig iron and steel making.
* GYPSUM - can be processed into [[gypsum plaster]].
* CALCIUM_CARBONATE - can be used in production of [[quicklime]].

The TALLOW reaction class also flags the material to be stored in "rendered fat" containers. Other default reaction classes might affect storage, too, but testing is needed.
|-
| {{text_anchor|METAL_ORE}}
|
* <inorganic material name e.g. [[lead|LEAD]]>
* <chance>
| Makes BOULDER items made of the material acceptable for [[Smelter|smelting]] into metal [[bar]]s, as well as [[Reactions#Reagents|reagents]] in reactions that require [[Item token#Related Tokens|"METAL_ORE:MATERIAL_NAME"]]. Places the material under "Metal Ores" in Stone stockpiles. The chance determines the probability of yielding bars of the specified material (see [[Tetrahedrite]] or [[Galena]] for details).

|-
| {{text_anchor|THREAD_METAL}}
|
* <inorganic material name e.g. [[Raw adamantine|RAW_ADAMANTINE]]>
* <chance>
| Makes BOULDER items made of the material acceptable for [[Strand extractor|strand extraction]] into threads; see also STOCKPILE_THREAD_METAL. The chance determines the probability of yielding strands of the specified material.

|-
| {{text_anchor|HARDENS_WITH_WATER}}
|
* <[[material token]]>
| Allows the material to be used to make [[healthcare|casts]].

|-
| {{text_anchor|SOAP_LEVEL}}
|
*<value>
| Determines effectiveness of soap - if the amount of grime on a body part is more than 3-SOAP_LEVEL, it sets it to 3-SOAP_LEVEL; as such setting it above 3 is bad. [[Soap]] has [SOAP_LEVEL:2]. Defaults to 0.

|-
| {{text_anchor|SYNDROME}}
|
| Begins defining a [[syndrome]] applied by the material. Multiple syndromes can be specified. See [[Syndrome token]].

|-
| {{text_anchor|ANTLER}}
|
| Found in the raws of several antler-wielding animals. It is used to show an antler as bodypart.
|

|-
| {{text_anchor|HAIR}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|FEATHER}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|SCALE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|HOOF}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|CHITIN}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|CARTILAGE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|NERVOUS_TISSUE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|MEAT_CATEGORY}}
| category
| Probably used in graphics. The following values for "category" are used in the vanilla raws: STANDARD, EYE, LUNG, HEART, INTESTINES, LIVER, STOMACH, PANCREAS, SPLEEN, KIDNEY, BRAIN, GIZZARD.
|}

===Material states===

The following is a list of valid material states:

{| {{prettytable}}
|-
|'''SOLID'''
|-
|'''LIQUID'''
|-
|'''GAS'''
|-
|'''POWDER''' (or '''SOLID_POWDER''')
|-
|'''PASTE''' (or '''SOLID_PASTE''')
|-
|'''PRESSED''' (or '''SOLID_PRESSED''')
|}

The following can be specified within tokens such as [[#STATE_NAME|STATE_NAME]], [[#STATE_NAME_ADJ|STATE_NAME_ADJ]] and [[#STATE_ADJ|STATE_ADJ]] to make them apply to several of the above material states simultaneously:

{| {{prettytable}}
|- bgcolor="#C0C0C0"
!Value
!Description
|-
|'''ALL'''
|Denotes all possible material states.
|-
|'''ALL_SOLID'''
|Denotes 'SOLID', 'POWDER', 'PASTE' and 'PRESSED'.
|}

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

|-
| {{text_anchor|IMPLIES_ANIMAL_KILL}}
|
| Lets the game know that an animal was likely killed in the production of this item. Entities opposed to killing animals ([[elf|Elves]] in vanilla) will refuse to accept these items in trade.

|-
| {{text_anchor|ALCOHOL_PLANT}}
|
| Classifies the material as plant-based alcohol, allowing its storage in food stockpiles under "Drink (Plant)".

|-
| {{text_anchor|ALCOHOL_CREATURE}}
|
| Classifies the material as animal-based alcohol, allowing its storage in food stockpiles under "Drink (Animal)".

|-
| {{text_anchor|ALCOHOL}}
|
| Classifies the material as generic alcohol. Implied by both ALCOHOL_PLANT and ALCOHOL_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|CHEESE_PLANT}}
|
| Classifies the material as plant-based cheese, allowing its storage in food stockpiles under "Cheese (Plant)".

|-
| {{text_anchor|CHEESE_CREATURE}}
|
| Classifies the material as animal-based cheese, allowing its storage in food stockpiles under "Cheese (Animal)".

|-
| {{text_anchor|CHEESE}}
|
| Classifies the material as generic cheese. Implied by both CHEESE_PLANT and CHEESE_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|POWDER_MISC_PLANT}}
|
| Classifies the material as plant powder, allowing its storage in food stockpiles under "Milled Plant".

|-
| {{text_anchor|POWDER_MISC_CREATURE}}
|
| Classifies the material as creature powder, allowing its storage in food stockpiles under "Bone Meal". Unlike milled plants, such as sugar and flour, "Bone Meal" barrels or pots may not contain bags. Custom reactions using this product better use buckets or jugs instead.

|-
| {{text_anchor|POWDER_MISC}}
|
| Classifies the material as generic powder. Implied by both POWDER_MISC_PLANT and POWDER_MISC_CREATURE. Exact behavior unknown, possibly vestigial.

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

|-
| {{text_anchor|STOCKPILE_GLOB_PASTE}}
|
| Classifies the material as milled paste, allowing its storage in food stockpiles under "Paste".

|-
| {{text_anchor|STOCKPILE_GLOB_PRESSED}}
|
| Classifies the material as pressed goods, allowing its storage in food stockpiles under "Pressed Material".

|-
| {{text_anchor|STOCKPILE_PLANT_GROWTH}}
|
| Classifies the material as a plant growth (e.g. fruits, leaves), allowing its storage in food stockpiles under Plant Growth/Fruit.

|-
| {{text_anchor|LIQUID_MISC_PLANT}}
|
| Classifies the material as a plant extract, allowing its storage in food stockpiles under "Extract (Plant)".

|-
| {{text_anchor|LIQUID_MISC_CREATURE}}
|
| Classifies the material as a creature extract, allowing its storage in food stockpiles under "Extract (Animal)".

|-
| {{text_anchor|LIQUID_MISC_OTHER}}
|
| Classifies the material as a miscellaneous liquid, allowing its storage in food stockpiles under "Misc. Liquid" along with [[lye]].

|-
| {{text_anchor|LIQUID_MISC}}
|
| Classifies the material as a generic liquid. Implied by LIQUID_MISC_PLANT, LIQUID_MISC_CREATURE, and LIQUID_MISC_OTHER. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|STRUCTURAL_PLANT_MAT}}
|
| Classifies the material as a plant, allowing its storage in food stockpiles under "Plants".

|-
| {{text_anchor|SEED_MAT}}
|
| Classifies the material as a plant seed, allowing its storage in food stockpiles under "Seeds".

|-
| {{text_anchor|BONE}}
|
| Classifies the material as bone, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|WOOD}}
|
| Classifies the material as wood, allowing its use for carpenters and storage in wood stockpiles. Entities opposed to killing plants (i.e. [[Elf|Elves]]) will refuse to accept these items in trade.

|-
| {{text_anchor|THREAD_PLANT}}
|
| Classifies the material as plant fiber, allowing its use for clothiers and storage in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".

|-
| {{text_anchor|TOOTH}}
|
| Classifies the material as tooth, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|HORN}}
|
| Classifies the material as horn, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|HAIR}}
|
| Classifies the material as hair, allowing for its use for spinners and restriction from refuse stockpiles by material.

|-
| {{text_anchor|PEARL}}
|
| Classifies the material as pearl, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|SHELL}}
|
| Classifies the material as shell, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|LEATHER}}
|
| Classifies the material as leather, allowing its use for leatherworkers and storage in leather stockpiles.

|-
| {{text_anchor|SILK}}
|
| Classifies the material as silk, allowing its use for clothiers and storage in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".

|-
| {{text_anchor|SOAP}}
|
| Classifies the material as soap, allowing it to be used as a bath detergent and stored in bar/block stockpiles under "Bars: Other Materials".{{verify}}

|-
| {{text_anchor|GENERATES_MIASMA}}
|
| Material generates miasma when it rots.

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

|-
| {{text_anchor|ROTS}}
|
| Material will rot if not stockpiled appropriately. Currently only affects [[food]] and [[refuse]], other items made of this material will not rot.

|-
| {{text_anchor|NERVOUS_TISSUE}}
|
| In most living creatures, it controls many bodily functions and movements by sending signals around the body. See: [[Nervous tissue]]

|-
| {{text_anchor|BLOOD_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "blood" in Adventurer mode tile descriptions ("Here we have a Dwarf in a slurry of blood.").

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

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

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

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

|-
| {{text_anchor|SWEAT_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "sweat".

|-
| {{text_anchor|TEARS_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "tears".

|-
| {{text_anchor|SPIT_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "spit".

|-
| {{text_anchor|EVAPORATES}}
|
| Contaminants composed of this material evaporate over time, slowly disappearing from the map. Used internally by water.

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

|-
| {{text_anchor|EDIBLE_VERMIN}}
|
| Can be eaten by vermin.

|-
| {{text_anchor|EDIBLE_RAW}}
|
| Can be eaten raw.

|-
| {{text_anchor|EDIBLE_COOKED}}
|
| Can be cooked and then eaten.

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

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

|-
| {{text_anchor|ITEMS_METAL}}
|
| The material can be made into minecarts, wheelbarrows, and stepladders at the metalsmith's forge.

|-
| {{text_anchor|ITEMS_BARRED}}
|
| Theoretically allows the item to be made into {{token|BARRED|ar}} armor, but doesn't actually work (game checks for {{token|BONE|md}} instead). Given to [[bone]].

|-
| {{text_anchor|ITEMS_SCALED}}
|
| Theoretically allows the item to be made into {{token|SCALED|ar}} armor, but doesn't actually work (game checks for {{token|SHELL|md}} instead). Given to [[shell]].

|-
| {{text_anchor|ITEMS_LEATHER}}
|
| Theoretically allows the item to be made into {{token|LEATHER|ar}} armor, but doesn't actually work (game checks for {{token|LEATHER|md}} instead). Given to [[leather]].

|-
| {{text_anchor|ITEMS_SOFT}}
|
| The material can be made into clothing, amulets, bracelets, earrings, backpacks, and quivers, contingent on which workshops accept the material. Given to [[plant fiber]], [[silk]] and [[wool]].

|-
| {{text_anchor|ITEMS_HARD}}
|
| The material can be made into furniture, crafts, mechanisms, and blocks, contingent on which workshops accept the material. Random [[finished goods|crafts]] made from this material include all seven items. Given to [[stone]], [[wood]], [[bone]], [[shell]], [[chitin]], [[nail|claws]], [[tooth|teeth]], [[horn|horns]], [[horn|hooves]] and [[wax|beeswax]]. [[Hair]], [[pearl|pearls]] and eggshells also have the tag.

|-
| {{text_anchor|IS_STONE}}
|
| Used to define that the material is a stone. Allows its usage in [[masonry]] and [[stonecrafting]] and storage in stone stockpiles, among other effects.

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

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

|-
| {{text_anchor|YARN}}
|
| Classifies the material as yarn, allowing its use for clothiers and its storage in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".

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

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

|-
| {{text_anchor|IS_GLASS}}
|
| Used internally by green glass, clear glass, and crystal glass. Appears to only affect the [[Reaction#GLASS_MATERIAL|[GLASS_MATERIAL]]] reaction token. Does not cause the game to treat the material like glass, i.e being referred to as "raw" instead of "rough" in its raw form or being displayed in the "glass" trade/embark category.

|-
| {{text_anchor|IS_CERAMIC}}
|
| Defines the material as a ceramic. Examples include CERAMIC_EARTHENWARE, CERAMIC_STONEWARE and CERAMIC_PORCELAIN.

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

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

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

|-
| {{text_anchor|ITEMS_ANVIL}}
|
| [[Anvil]]s can be made out of this material.

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

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

|-
| {{text_anchor|ITEMS_ARMOR}}
|
| [[Armor]] can be made out of this material.

|-
| {{text_anchor|ITEMS_DELICATE}}
|
| Used internally by amber and coral. Functionally equivalent to ITEMS_HARD.

|-
| {{text_anchor|ITEMS_SIEGE_ENGINE}}
|
| Theoretically, siege engine parts can be made out of this material. Does not appear to work (game checks for {{token|WOOD|md}} or {{token|IS_METAL|md}}+{{token|ITEMS_SOFT|md}} instead).

|-
| {{text_anchor|ITEMS_QUERN}}
|
| Theoretically, querns and millstones can be made out of this material. Does not appear to work (game checks for {{token|ITEMS_HARD|md}} instead).
|}

==Syndrome tokens==
Below is a table with some of the tokens you can use when declaring a [SYNDROME] token. For all the tokens you can use, see the [[Syndrome token]] page.

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

|-
| {{text_anchor|SYN_NAME
|
* text
| Defines the name of the syndrome

|-
| {{text_anchor|SYN_INJECTED}}
|
| Syndrome can be contracted by injection (by a creature)

|-
| {{text_anchor|SYN_CONTACT}}
|
| Syndrome can be contracted on contact (e.g. poison dust or liquid)

|-
| {{text_anchor|SYN_INHALED}}
|
| Syndrome can be contracted by inhalation (e.g. poison vapor or gas)

|-
| {{text_anchor|SYN_INGESTED}}
|
| Syndrome can be contracted by ingestion (when the material is eaten in solid or liquid form)

|-
| {{text_anchor|SYN_AFFECTED_CLASS}}
|
* creature class name
| Adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| {{text_anchor|SYN_IMMUNE_CLASS}}
|
* creature class name
| Makes the class of creatures immune to the syndrome

|-
| {{text_anchor|SYN_AFFECTED_CREATURE}}
|
* creature name
* caste name or ALL
| Adds a specific creature to those affected.

|-
| {{text_anchor|SYN_IMMUNE_CREATURE}}
|
* creature name
* caste name or ALL
| Makes the creature immune to the syndrome

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

|}

==See also==
* [[Inorganic material definition token]]
* [[Syndrome]]
* [[Hardcoded material]]

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

Orientation

2025-08-29T02:05:58Z

Putnam3145:

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

'''Orientation''' mediates how intelligent [[creatures]] are romantically attracted to one another, which, along with characters' [[Personality facet|personalities]] and time spent together, may build to a romantically involved [[relationship]] or [[marriage]]. Such relationships do not need to be opposite-sex, same-sex marriages and love affairs can in fact happen, both in world-gen and gameplay, albeit more rarely than opposite-sex romance. Orientation is controlled by the {{token|ORIENTATION|c}} creature token, and defaults to 95%, of all creatures being interested in heterosexual relationships.

__TOC__

== Mechanic ==
The orientation token takes 4 arguments: {{token|ORIENTATION|c|<male/female>:<disinterested chance>:<lover-possible chance>:<commitment-possible chance>}}. A one-time check is made for each creature to determine orientation, by "rolling a die" once for each sex, against the total of the three chances for that sex. Disinterested means that they will not form romantic relationships.

The orientation token is omitted from most creature definitions, and in its absence, the game uses some default settings:
* {{token|ORIENTATION|c|MALE:5:20:75}} and {{token|ORIENTATION|c|FEMALE:75:20:5}} for a caste which has the {{token|FEMALE}} token under it.
* {{token|ORIENTATION|c|MALE:75:20:5}} and {{token|ORIENTATION|c|FEMALE:5:20:75}} for a caste which has the {{token|MALE}} token under it.
This pair of default settings generates all populations as 71.2% strictly heterosexual, 23.8% bisexual, 3.8% aromantic/asexual, and 1.2% strictly homosexual; for animals, this in practice can be boiled down to 95% opposite-sex interested and 5% not, meaning there is a 9.75% chance that a breeding pair of only one male and one female will breed properly (adding a second one of each reduces this to a 0.5% chance). Intelligent creatures require marriage to breed. If this behavior is undesirable, it can be fixed with DFHack's `fix-ster` script.

== Modifying orientation ==
For more information about how modifying ''Dwarf Fortress'' files works, and specifically creature castes, see [[Modding#Creature_castes]].

In order to correctly add a custom orientation to any creature, the {{token|ORIENTATION|c}} token with its 4 arguments must be placed beneath at least one of the {{token|CASTE|c}} tokens of that creature. Each caste only needs ''one'' orientation token to function correctly (and the game will indeed only use one per caste). Any orientation change to that caste is then effective immediately upon reloading a saved game (if the save file raws were edited) or generating a new world (if the base game raws were edited). Any previously formed relationships in a currently running game world remain intact, however any new relationship interactions are informed by the new orientation settings for that creature caste.

* Adding the tokens {{token|ORIENTATION|c|MALE:0:0:100}}{{token|ORIENTATION|c|FEMALE:100:0:0}} beneath the {{token|CASTE:FEMALE}} token and {{token|ORIENTATION|c|FEMALE:0:0:100}}{{token|ORIENTATION|c|MALE:100:0:0}} beneath the {{token|CASTE:MALE}} token would effectively make each caste (and if only those two castes exist, the whole creature) behave exclusively heterosexually with no interest whatsoever toward the same sex, like they did in old versions. Keep in mind that the chance of none of your dwarves being capable of marrying is, at most, 2.7%, and as of 0.47 there are out-of-wedlock children anyway, so it's actually 0.0125%. That this modification is required to have more children is a myth at best.
* To make the entire creature or just one caste of the creature exclusively homosexual, simply apply the {{token|ORIENTATION}} token paired with the desired commitment-possible chances to the matching sex. In effect, apply the heterosexual-only change in reverse.
* Adding {{token|ORIENTATION|c|MALE:0:0:100}}{{token|ORIENTATION|c|FEMALE:0:0:100}} to ''just one'' caste would effectively make that caste behave bisexually, with every interest in partnering up with anyone. The other unmodified castes would still use their own orientation token setting, or the default if there was no {{token|ORIENTATION}} token. Changing the ''ratio'' within the tokens from 0:0:100 to ''0:100:0'' would result in mostly only lovers with rare marriages.
* Adding {{token|ORIENTATION|c|MALE:100:0:0}}{{token|ORIENTATION|c|FEMALE:100:0:0}} to all castes would effectively make the creature behave asexually, with no interest in partnering up and having children (although non-hist fig populations will still marry and have children as normal, and may even arrive already-married with children as migrants). Gameplay-wise, if the player doesn't want their fortress involved with any children, it would be simpler just to edit the [[d_init.txt|baby/child cap]].

A small reminder: As stated on the [[creature token]] page regarding {{token|ORIENTATION}} the values used are just a ratio, and not an actual percentage. The numbers do not need to add up to any specific number; a setting of 750:200:50 will provide the same effect as 75:20:5 and a setting of 99:99:99 the same as 1:1:1.

== Adventure mode ==
[[Adventure mode|Adventurer]]s have a special "indeterminate" orientation which has no behavior, instead acting identically to asexuality (partially, because a {{token|SLOW_LEARNER}} with that orientation does not count as sterile and will breed in [[Fortress mode]]), and thus cannot ever marry or have children in vanilla, even after retiring them to a [[site]]. This can be changed with DFHack's ``fix-ster`` script, though you will have little control over your retired adventurer's partner choices once they're off-map.

{{Category|Dwarves}}
{{Category|Relationships}}

Game folders and files

2025-07-23T02:25:07Z

Putnam3145: /* Game folder */ i dunno if someone who was using windows vista or something wrote this whole article but a lot of this is very strange

{{av}}
Dwarf Fortress's default '''game folder''' location depends on the game version, platform or operating system. It is possible that users will change the install drive or directory, thus these locations may vary.

Non-portable (AppData) game folders were added in version 52.01.



==Game folder==
The game's installation folder is where all the game's content is stored. You might want to go to this folder to browse [[raw file]]s or to check logs.

* '''Dwarf Fortress Classic''' is [[Installation|distributed]] in a zip archive. Depending on the operating system the game folder is either <code>df_##_##_win</code> (with the version number, or the name chosen for the folder during extraction), <code>df_osx</code> or <code>df_linux</code> and will be located where you choose to [[installation|extract it]]. Essentially its where you run the game from. For example: <code>C:\Games\Dwarf Fortress\</code>

* '''Steam''': The default locations are listed below. You can also find it through the app by right-click Dwarf Fortress in the Steam library and choose Properties, then go to the Local files tab and click Browse local files.
:* '''Windows''': <code>C:\Program Files (x86)\Steam\steamapps\common\Dwarf Fortress\</code>
:* '''Linux (via proton)''': <code>~/.steam/debian-installation/steamapps/common/Dwarf Fortress</code>
* '''Itch.io''': The default location is <code>%APPDATA%\itch\apps\Dwarf Fortress\</code> {{Verify}}

Note: On Windows, <code>%APPDATA%</code> is a hidden folder that points to <code>C:\Users\(Username)\AppData\Roaming</code>. You can use winkey+R and type 'appdata' to quickly jump there.

== Savegame folder ==
:''Further information: [[Saved game folder]]''
The savegame folder contains the saved games, and backup saves from the game. The location of this depends on the settings, defaulting to non-portable{{v|52.01}}. Adding ``portable.txt`` to ``\(gamefolder)\data\prefs\`` (or setting the corresponding option in-game) makes the game save files to the installation directory.

* '''Non-Portable''':
**Windows: <code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\save</code>
**Linux: <code>/home/(Your username)/.local/share/Steam/steamapps/common/Dwarf Fortress/save</code>.
* '''Portable''':
**The folder is located within the Dwarf Fortress gamefolder <code>(gamefolder)\saves\</code>.

== Mod folder ==
:''Further information: [[Modding]]''
The mod folders are where mods are stored. It is in the same game directory as the saves folder.

* '''Non-portable''':
**<code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\mods</code>
**<code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\data\installed_mods</code>
* '''Portable''':
**<code>(gamefolder)\mods\</code>
**<code>(gamefolder)\data\installed_mods\</code>

== Key ==
{|
| [[File:Folder-orange.svg|20px|link=]] Dwarf Fortress
| : Game folder
|-
| &emsp;● [[File:Folder.svg|20px|link=]] data
| : Contains game content.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] art
| : Any images not loaded from vanilla graphics modules, primarily for the main menu.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] init
| : Default versions of the settings.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] installed_mods
| : Folder of mod copies used when loading a world.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] sound
| : Contains all audio and music files used in the game.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] vanilla
| : Contains all the vanilla modules and raw files.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] mods
| : Folder for mods before being loaded.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] mod_upload
| : Folder for uploading mods to Steam.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] prefs
| : Contains all game setting files.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] save
| : Contains all save game files.
|}

{{files}}
[[ru:Game folders and files]]

Game folders and files

2025-07-23T02:23:42Z

Putnam3145: /* Savegame folder */

{{av}}
Dwarf Fortress's default '''game folder''' location depends on the game version, platform or operating system. It is possible that users will change the install drive or directory, thus these locations may vary.

Non-portable (AppData) game folders were added in version 52.01.



==Game folder==
The game's installation folder is where all the game's content is stored. You might want to go to this folder to browse [[raw file]]s or to check logs.

* '''Dwarf Fortress Classic''' is [[Installation|distributed]] in a zip archive. Depending on the operating system the game folder is either <code>df_##_##_win</code> (with the version number, or the name chosen for the folder during extraction), <code>df_osx</code> or <code>df_linux</code> and will be located where you choose to [[installation|extract it]]. Essentially its where you run the game from. For example: <code>C:\Games\Dwarf Fortress\</code>

* '''Steam''': The default locations are listed below. You can also find it through the app by right-click Dwarf Fortress in the Steam library and choose Properties, then go to the Local files tab and click Browse local files.
:* '''Windows x86''': <code>C:\Program Files\Steam\steamapps\Dwarf Fortress\</code>
:* '''Windows x86 (alt Windows 10)''': <code>C:\Program Files (x86)\Steam\steamapps\common\Dwarf Fortress\</code>
:* '''Windows x64''': <code>C:\Program Files (x86)\Steam\steamapps\Dwarf Fortress\</code>
:* '''Linux (via proton)''': <code>~/.steam/debian-installation/steamapps/common/Dwarf Fortress</code>
* '''Itch.io''': The default location is <code>%APPDATA%\itch\apps\Dwarf Fortress\</code> {{Verify}}

Note: On Windows, <code>%APPDATA%</code> is a hidden folder that points to <code>C:\Users\(Username)\AppData\Roaming</code>. You can use winkey+R and type 'appdata' to quickly jump there.

== Savegame folder ==
:''Further information: [[Saved game folder]]''
The savegame folder contains the saved games, and backup saves from the game. The location of this depends on the settings, defaulting to non-portable{{v|52.01}}. Adding ``portable.txt`` to ``\(gamefolder)\data\prefs\`` (or setting the corresponding option in-game) makes the game save files to the installation directory.

* '''Non-Portable''':
**Windows: <code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\save</code>
**Linux: <code>/home/(Your username)/.local/share/Steam/steamapps/common/Dwarf Fortress/save</code>.
* '''Portable''':
**The folder is located within the Dwarf Fortress gamefolder <code>(gamefolder)\saves\</code>.

== Mod folder ==
:''Further information: [[Modding]]''
The mod folders are where mods are stored. It is in the same game directory as the saves folder.

* '''Non-portable''':
**<code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\mods</code>
**<code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\data\installed_mods</code>
* '''Portable''':
**<code>(gamefolder)\mods\</code>
**<code>(gamefolder)\data\installed_mods\</code>

== Key ==
{|
| [[File:Folder-orange.svg|20px|link=]] Dwarf Fortress
| : Game folder
|-
| &emsp;● [[File:Folder.svg|20px|link=]] data
| : Contains game content.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] art
| : Any images not loaded from vanilla graphics modules, primarily for the main menu.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] init
| : Default versions of the settings.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] installed_mods
| : Folder of mod copies used when loading a world.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] sound
| : Contains all audio and music files used in the game.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] vanilla
| : Contains all the vanilla modules and raw files.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] mods
| : Folder for mods before being loaded.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] mod_upload
| : Folder for uploading mods to Steam.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] prefs
| : Contains all game setting files.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] save
| : Contains all save game files.
|}

{{files}}
[[ru:Game folders and files]]

Game folders and files

2025-07-23T02:18:28Z

Putnam3145: /* Game folder */

{{av}}
Dwarf Fortress's default '''game folder''' location depends on the game version, platform or operating system. It is possible that users will change the install drive or directory, thus these locations may vary.

Non-portable (AppData) game folders were added in version 52.01.



==Game folder==
The game's installation folder is where all the game's content is stored. You might want to go to this folder to browse [[raw file]]s or to check logs.

* '''Dwarf Fortress Classic''' is [[Installation|distributed]] in a zip archive. Depending on the operating system the game folder is either <code>df_##_##_win</code> (with the version number, or the name chosen for the folder during extraction), <code>df_osx</code> or <code>df_linux</code> and will be located where you choose to [[installation|extract it]]. Essentially its where you run the game from. For example: <code>C:\Games\Dwarf Fortress\</code>

* '''Steam''': The default locations are listed below. You can also find it through the app by right-click Dwarf Fortress in the Steam library and choose Properties, then go to the Local files tab and click Browse local files.
:* '''Windows x86''': <code>C:\Program Files\Steam\steamapps\Dwarf Fortress\</code>
:* '''Windows x86 (alt Windows 10)''': <code>C:\Program Files (x86)\Steam\steamapps\common\Dwarf Fortress\</code>
:* '''Windows x64''': <code>C:\Program Files (x86)\Steam\steamapps\Dwarf Fortress\</code>
:* '''Linux (via proton)''': <code>~/.steam/debian-installation/steamapps/common/Dwarf Fortress</code>
* '''Itch.io''': The default location is <code>%APPDATA%\itch\apps\Dwarf Fortress\</code> {{Verify}}

Note: On Windows, <code>%APPDATA%</code> is a hidden folder that points to <code>C:\Users\(Username)\AppData\Roaming</code>. You can use winkey+R and type 'appdata' to quickly jump there.

== Savegame folder ==
:''Further information: [[Saved game folder]]''
The savegame folder contains the saved games, and backup saves from the game. The location of this depends on the settings, defaulting to non-portable{{v|52.01}}. Adding ``portable.txt`` to ``\(gamefolder)\data\prefs\`` (or setting the corresponding option in-game) makes the game save files to the installation directory.

* '''Non-Portable''': <code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\save</code>.
* '''Portable''':
**The folder is located within the Dwarf Fortress gamefolder <code>(gamefolder)\saves\</code>.
**On a Windows system, if the game was installed in the 'Program Files' subdirectory, the folder is instead located at <code>C:\Users\(Your username)\AppData\Local\VirtualStore\Program Files\Dwarf Fortress\save</code>.{{verify}}
**'''Steam Deck''': <code>/home/deck/.local/share/Steam/steamapps/common/Dwarf Fortress/save</code>

== Mod folder ==
:''Further information: [[Modding]]''
The mod folders are where mods are stored. It is in the same game directory as the saves folder.

* '''Non-portable''':
**<code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\mods</code>
**<code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\data\installed_mods</code>
* '''Portable''':
**<code>(gamefolder)\mods\</code>
**<code>(gamefolder)\data\installed_mods\</code>

== Key ==
{|
| [[File:Folder-orange.svg|20px|link=]] Dwarf Fortress
| : Game folder
|-
| &emsp;● [[File:Folder.svg|20px|link=]] data
| : Contains game content.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] art
| : Any images not loaded from vanilla graphics modules, primarily for the main menu.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] init
| : Default versions of the settings.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] installed_mods
| : Folder of mod copies used when loading a world.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] sound
| : Contains all audio and music files used in the game.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] vanilla
| : Contains all the vanilla modules and raw files.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] mods
| : Folder for mods before being loaded.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] mod_upload
| : Folder for uploading mods to Steam.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] prefs
| : Contains all game setting files.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] save
| : Contains all save game files.
|}

{{files}}
[[ru:Game folders and files]]

Game folders and files

2025-07-23T02:18:15Z

Putnam3145:

{{av}}
Dwarf Fortress's default '''game folder''' location depends on the game version, platform or operating system. It is possible that users will change the install drive or directory, thus these locations may vary.

Non-portable (AppData) game folders were added in version 52.01.



==Game folder==
The game's installation folder is where all the game's content is stored. You might want to go to this folder to browse [[raw file]]s or to check logs.

* '''Dwarf Fortress Classic''' is [[Installation|distributed]] in a zip archive. Depending on the operating system the game folder is either <code>df_##_##_win</code> (with the version number, or the name chosen for the folder during extraction), <code>df_osx</code> or <code>df_linux</code> and will be located where you choose to [[installation|extract it]]. Essentially its where you run the game from. For example: <code>C:\Games\Dwarf Fortress\</code>

* '''Steam''': The default locations are listed below. You can also find it through the app by right-click Dwarf Fortress in the Steam library and choose Properties, then go to the Local files tab and click Browse local files.
:* '''Windows x86''': <code>C:\Program Files\Steam\steamapps\Dwarf Fortress\</code>
:* '''Windows x86 (alt Windows 10)''': <code>C:\Program Files (x86)\Steam\steamapps\common\Dwarf Fortress\</code>
:* '''Windows x64''': <code>C:\Program Files (x86)\Steam\steamapps\Dwarf Fortress\</code>
:* '''Linux (via proton)''': <code>~/.steam/debian-installation/steamapps/common/Dwarf Fortress</code>
* '''Itch.io''': The default location is <code>%APPDATA%\itch\apps\Dwarf Fortress\</code> {{Verify}}

Note: On Windows, <code>%APPDATA%</code> is a hidden folder that points to <code>C:\Users\(Username)\AppData</code>. You can use winkey+R and type 'appdata' to quickly jump there.

== Savegame folder ==
:''Further information: [[Saved game folder]]''
The savegame folder contains the saved games, and backup saves from the game. The location of this depends on the settings, defaulting to non-portable{{v|52.01}}. Adding ``portable.txt`` to ``\(gamefolder)\data\prefs\`` (or setting the corresponding option in-game) makes the game save files to the installation directory.

* '''Non-Portable''': <code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\save</code>.
* '''Portable''':
**The folder is located within the Dwarf Fortress gamefolder <code>(gamefolder)\saves\</code>.
**On a Windows system, if the game was installed in the 'Program Files' subdirectory, the folder is instead located at <code>C:\Users\(Your username)\AppData\Local\VirtualStore\Program Files\Dwarf Fortress\save</code>.{{verify}}
**'''Steam Deck''': <code>/home/deck/.local/share/Steam/steamapps/common/Dwarf Fortress/save</code>

== Mod folder ==
:''Further information: [[Modding]]''
The mod folders are where mods are stored. It is in the same game directory as the saves folder.

* '''Non-portable''':
**<code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\mods</code>
**<code>C:\Users\(Your username)\AppData\Roaming\Bay 12 Games\Dwarf Fortress\data\installed_mods</code>
* '''Portable''':
**<code>(gamefolder)\mods\</code>
**<code>(gamefolder)\data\installed_mods\</code>

== Key ==
{|
| [[File:Folder-orange.svg|20px|link=]] Dwarf Fortress
| : Game folder
|-
| &emsp;● [[File:Folder.svg|20px|link=]] data
| : Contains game content.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] art
| : Any images not loaded from vanilla graphics modules, primarily for the main menu.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] init
| : Default versions of the settings.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] installed_mods
| : Folder of mod copies used when loading a world.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] sound
| : Contains all audio and music files used in the game.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] vanilla
| : Contains all the vanilla modules and raw files.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] mods
| : Folder for mods before being loaded.
|-
| &emsp;&emsp;&emsp;● [[File:Folder.svg|20px|link=]] mod_upload
| : Folder for uploading mods to Steam.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] prefs
| : Contains all game setting files.
|-
| &emsp;● [[File:Folder.svg|20px|link=]] save
| : Contains all save game files.
|}

{{files}}
[[ru:Game folders and files]]

Lua functions

2025-05-14T20:25:00Z

Putnam3145: ditto

{{Modding}}

Dwarf Fortress defines a number of functions in addition to those standard for [https://www.lua.org/manual/5.4/ Lua 5.4].

==C++ Function Calls==

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''int'' {{text anchor|trandom}}(''int'' n)
| Returns a 32-bit integer from {{Tooltip|0 to n-1|Lua arrays start at 1, C++ arrays start at 0, hence the discrepancy.}}. Uses DF's internal RNG system instead of ``math.random()``.

|-
| ''str'' {{text anchor|capitalize_string_words}}(''str'' s)
| Capitalizes every word in a string.

|-
| ''str'' {{text anchor|capitalize_string_first_word}}(''str'' s)
| Capitalizes the first word in a string.

|-
| ''str'' {{text anchor|utterance}}()
| Returns a word from the [[kobold language]].

|-
| ''void'' {{text anchor|lua_log}}(''str'' s)
| Prints a string to ``Dwarf Fortress/lualog.txt``. The ``log()`` function is more robust and should be used instead.

|-
|
''void'' {{text anchor|raws.register_creatures}}(''table'' lines) 
''void'' {{text anchor|raws.register_entities}}(''table'' lines) 
''void'' {{text anchor|raws.register_inorganics}}(''table'' lines) 
''void'' {{text anchor|raws.register_interactions}}(''table'' lines) 
''void'' {{text anchor|raws.register_items}}(''table'' lines) 
''void'' {{text anchor|raws.register_languages}}(''table'' lines) 
''void'' {{text anchor|raws.register_plants}}(''table'' lines){{verify}}
| Takes a table of [[token]]s and reads them as that type of [[raw file]]. It is not necessary to add a header.

|}

==Globals==
Helper functions are defined in ``init/globals.lua``, and can be accessed by any script even if ``vanilla_procedural`` is not loaded.

===Generation===
This function is defined in ``init/generators.lua``.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''table'' {{text anchor|add_generated_info}}(''table'' tbl)
| Adds {{token|GENERATED}} to the input table, and {{token|SOURCE_HFID}}/{{token|SOURCE_ENID}} if IDs are defined. Necessary for generated raws to be saved properly.

|}

===Randomization===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''value'' {{text anchor|pick_random}}(''table'' t)
| Returns a random value from a table.

|-
| ''value'' {{text anchor|pick_random_no_replace}}(''table'' t)
| Returns a random value from a table, then removes it from the table.

|-
| ''value'' {{text anchor|pick_random_conditional}}(''table'' t, ''function'' cond,...)
| Returns a random value from a table that satisfies ``cond(...)``.

|-
| ''bool'' {{text anchor|one_in}}(''num'' x)
| Returns true with a one in x chance.

|-
| ''value'' {{text anchor|pick_random_pairs}}(''table'' tbl)
| Returns a random key from a table. For example, ``pick_random_pairs( {WATER = true} )`` returns "WATER".

|-
| ''value'' {{text anchor|pick_weighted_from_table}}(''table'' tbl)
| Requires a table of tables with ``weight`` keys. Returns a weighted random value.
At debug level >=4, logs the roll.

|-
| ''value'' {{text anchor|generate_from_list}}(''table'' tbl,...)
| Requires a table of functions that return a ``weight`` key. Runs each function and returns a weighted random output. Used by [[werebeast]]s to generate an interaction and link to options from it.

|}

===Tables===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description
|-
| ''table'' {{text anchor|split_to_lines}}(''table'' tbl,''string'' str)
| Adds a string into a table, with each line being a separate key.

|-
| ''table'' {{text anchor|map_merge}}(''table'' tbl1, ''table'' tbl2)
| Combines two tables. If ``tbl1`` already has a value for a given key, it will not be overwritten. Used for sets such as ``{ WATER = true }``.

|-
| ''table'' {{text anchor|table_merge}}(''table'' tbl1, ''table'' tbl2)
| Adds each value from ``tbl2`` onto the end of ``tbl1``.

|-
| ''bool'' {{text anchor|find_in_array_part}}(''table'' tbl, ''value'' item)
| Returns true if ``item`` is a value in ``tbl``.

|-
| ''void'' {{text anchor|convert_array_to_set}}(''table'' tbl)
| For each key in a table, sets the value to true.

|-
| ''void'' {{text anchor|add_unique}}(''table'' tbl, ''value'' item)
| Adds ``item`` to the end of ``tbl`` if not already present.

|-
| ''void'' {{text anchor|remove_item}}(''table'' tbl, ''value'' item)
| Removes all instances of ``item`` from ``tbl``.

|-
| ''table'' {{text anchor|shallow_copy}}(''table'' tbl)
| Returns a table copied from all values in the input table.

|-
| ''table'' {{text anchor|deep_copy}}(''table'' tbl)
| Returns a table recursively copied from all values in the input table.

|}

===Debug===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Description
|-
| ''void'' {{text anchor|log}}(...)
| Logs the input to ``Dwarf Fortress/lualog.txt``. Used for most cases.

|-
| ''string'' {{text anchor|get_caller_loc_string}}()
| Returns the debug source info and the current line.

|-
| ''string'' {{text anchor|get_debug_logger}}(''num'' level=1,...)
| Logs ``get_caller_loc_string()`` and any overloads if the ``debug_level`` is at least ``level``. ``debug_level`` is a global variable that defaults to 0.

|-
| ''function'' {{text anchor|partial_function}}(''function'' f, arg,...)
| Returns ``f(arg,...)``.

|-
| ''function'' {{text anchor|log_table}}(''table'' tbl, ''num'' debug_level=0, ''num'' nest_level=0, ''num'' added_debug_from_nest=0)
| Logs a table if the global ``debug_level`` is at least the input ``debug_level``. ``nest_level`` starts at 0 and adds ``added_debug_from_nest`` for each nesting to the input debug level.

|-
| ''function'' {{text anchor|print_table}}(''table'' tbl, ''num'' nest_level=0)
| Logs a table, regardless of debug level.

|}

===Spheres===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="45%" | Function
! width="55%" | Description

|-
| ''string'' {{text anchor|get_random_sphere_adjective}}(''string'' [[Sphere#Sphere tokens|sphere]])
| Returns a random string from global table ``random_sphere_adjective[sph]``.

|-
| ''table'' {{text anchor|get_random_sphere_noun}}(''string'' [[Sphere#Sphere tokens|sphere]])
| Returns a random table ``tbl`` from global table ``random_sphere_nouns[sphere]``.
``tbl`` has two members: ``tbl.str``, which is a string; and ``tbl.flags``, which defaults to ``{OF=true,PREPOS=true,PRE=true}``, for grammar.

|-
| ''table'' {{text anchor|add_sphere_mpp}}(''table'' sphere_list, ''string'' [[Sphere#Sphere tokens|new_s]], ''table'' available_sphere, ''table'' available_sphere_cur)
| Adds ``new_s`` to ``sphere_list`` and all parents and children. Sets the added spheres in ``available_sphere`` and ``available_sphere_cur`` to false, and sets all enemies in ``available_sphere_cur`` to false.
At debug level >= 2, will be logged.
|}

==Generation Tables==
The ``generate()`` function is defined in ``init/generators.lua``, and is called to generate objects.

Each type of random object is defined through a function that generates a table of raws. To generate objects for specific purposes, ``generate()`` can call functions from a table and provide inputs such as ``tok`` (unique token string).
For example, [[forgotten beast]]s are unique and generated for each cave region. If multiple functions are defined in ``creatures.fb``, such as both ``creatures.fb.default`` and a modded forgotten beast, the game uses the ``weight`` output to influence which one will be randomly chosen.

By default, objects are generated in this order: unittests{{Tooltip|*|if debug_level is at least 0}}, preprocess, do_once, materials, items, languages, creatures, interactions, entities, and postprocess. Do note that you can register raws at any step. For example, each [[vault]] entity generates a set of [[divine equipment]] during the entity step, and [[werebeast]]s generate a curse interaction during the creature step.

===Custom===

All functions in these tables are run each tick, but global variable ``random_object_parameters`` is only ever populated with values once per generation. Functions called through these tables are not supplied with arguments.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="80%" | Description

|-
| preprocess
| Runs once the world's terrain has been finalized and before history can begin.
Includes two functions by default: 
``preprocess.demon()``, which populates the distribution of ``demon_type`` string inputs 
``preprocess.bogeyman_polymorph()``, which generates the [[bogeyman]]'s polymorph interaction if bogeymen exist 

|-
| do_once
| Runs immediately after all functions in preprocess, and before all other generation steps. Only runs if ``random_object_parameters.main_world_randoms = true``, for added safety.
Recommended for generating custom objects.

|-
| postprocess
| Runs after all other generation steps are finished.

|-
| unittests
| Runs before preprocess if the global ``debug_level`` is greater than 0. Expects a boolean output.

|-
| languages
| For each function in this table, registers a language. Expects table of key-value pairs where the key is the [[Language token#WORD|word token]] and the value is the translated string.

|}

===Creatures===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Table
! width="40%" | Inputs
! width="60%" | Article

|-
|
creatures.angel.great_beast 
creatures.angel.humanoid_generic 
creatures.angel.humanoid_warrior
| function(tok)
| [[Angel]] (see [[Angel#Angel types|types]])

|-
| creatures.demon
| function(demon_type,difficulty,tok)
| [[Demon]]

|-
|
creatures.experiment.beast_large 
creatures.experiment.beast_small 
creatures.experiment.failed_large 
creatures.experiment.failed_small 
creatures.experiment.humanoid_giant 
creatures.experiment.humanoid 
| function(tok)
| [[Experiment]]

|-
| creatures.fb
| function(layer_type,tok)
| [[Forgotten beast]]

|-
| creatures.night_creature.bogeyman
| function(tok)
| [[Bogeyman]]

|-
| creatures.night_creature.nightmare
| function(tok)
| [[Nightmare]]

|-
| creatures.night_creature.troll
| function(tok)
| [[Night troll]]

|-
| creatures.night_creature.werebeast
werebeast_origin_interactions{{Tooltip|*|Called by vanilla_procedural, not by init/generators}}
| function(tok)
function(tok,name,options)
| [[Werebeast]]

|-
| creatures.titan
| function(subregion,tok)
| [[Titan]]

|}

===Entities===

Generated entities are supplied with the ``idx`` parameter, which is a number that starts at 1 and increments by 1 for each entity of that type. It can be used to give a unique ID to [[divine equipment]].

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Table
! width="20%" | Inputs
! width="60%" | Articles

|-
| entities.vault_guardian
| function(idx,tok)
| [[Vault]] ([[angel]]s)

|-
| entities.mythical_guardian
| function(idx,tok)
| [[Mysterious dungeon]] ([[dungeon guardian]]s)

|}

===Interactions===

====World====
World interactions are generated in the ``generate_random_interactions()`` step of ``generators.lua``.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Table
! width="30%" | Inputs
! width="60%" | Examples

|-
|
interactions.blessing.minor 
interactions.blessing.medium
| function(idx)
| [[Die]] roll effects: luck, holy item, healing, etc

|-
|
interactions.curse.minor 
interactions.curse.medium
| function(idx)
| [[Die]] roll effects: week of curse

|-
| interactions.curse.major
| function(idx,tok)
| [[Vampire]]

|-
| interactions.disturbance
| function(idx)
| [[Mummy]]

|-
| interactions.mythical
| function(idx,power_level,[[sphere]])
| [[Dungeon guardian]]

|-
| interactions.mythical_item_power
| spheres={}, interaction=function()
| [[Primordial remnant#List of powers]]

|-
| interactions.regional
| function(idx)
| Reanimating [[Surroundings#Evil|evil biomes]]

|-
| interactions.secrets
| function(idx,[[sphere]])
| [[Necromancer]]

|}

====Powers====
Powers are stored in the ``interactions.powers`` table and can be generated by other interactions. The structure of each power entry contains several keys that determine how it can be added to an interaction's syndrome.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="15%" | Key
! width="30%" | Inputs
! width="60%" | Notes

|-
| tags
| ''table''
| A table of user-defined values that can be checked by other functions.

|-
| tags.lieutenant
| ''bool''
| If true, available to [[intelligent undead]].

|-
| rarity
| ''number'' n
| Higher is rarer. An [[intelligent undead]] has a 1 in n chance to receive this power.

|-
| gen
| ''table'' ``tbl``, ''table'' ``end_tbl`` function(name)
| Generates and returns lines of raws.
* ``tbl`` consists of [[syndrome]] lines comprising {{token|CE_CAN_DO_INTERACTION|syndrome}} and ``[[Interaction token#Usage|CDI]]``.
* ``end_tbl`` consists of lines that define the [[interaction]].

|}

====Interaction helpers====

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| ''table'' ``tbl``, ''table'' ``end_tbl`` basic_lieutenant(''string'' name, ''string'' name_plural, ''string'' token)
| Generates an interaction that raises an [[intelligent undead]] and calls ``basic_lieutenant_powers(token)``.

|-
| ''table'' ``tbl``, ''table'' ``end_tbl`` basic_lieutenant_powers(''string'' token)
| Adds any number of powers (chosen from among ``interaction.powers``) and 0-5 sicken effects (from ``add_curses()``) to the current definition.

|-
| ''table'' ``tbl``, ''table'' ``end_tbl``, ''int'' ``idx`` add_curses(''table'' tbl, ''table'' end_tbl, ''string'' token, ''int'' num, ''int'' start_idx, ''int'' sev, ''table'' good_effects)
| Adds ``num`` curses/afflictions to the current definition. ``good_effects`` lists the possible curses that can be chosen from ``default_curse_effects``, and ``sev`` is the syndrome's severity. Basic lieutenants use a ``sev`` of 500.

|-
| ''string'' get_abstract_gesture()
| Returns a random string from either ``gestures`` or ``gestures_abstract``, used for {{token|VERB|interaction}}.

|}

===Items===

====Instruments====

The default [[instrument]] system is not currently open to Lua, but ``generators.lua`` defines tables for each token.
{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Table
! width="30%" | Inputs
! width="40%" | Token

|-
| items.instruments.keyboard
| N/A
| {{token|GENERATE_KEYBOARD_INSTRUMENTS|e}}

|-
| items.instruments.stringed
| N/A
| {{token|GENERATE_STRINGED_INSTRUMENTS|e}}

|-
| items.instruments.wind
| N/A
| {{token|GENERATE_WIND_INSTRUMENTS|e}}

|-
| items.instruments.percussion
| N/A
| {{token|GENERATE_PERCUSSION_INSTRUMENTS|e}}

|}

====Divine equipment====
{{Main|Divine equipment}}
``entities.vault_guardian.default`` generates from the list ``angel_item_gens``, the default function of which then calls functions from ``angel_item_info``. Unless otherwise stated, the '''Behavior''' column refers to the behavior of how ``angel_item_gens.default`` generates from these lists.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="20%" | Inputs
! width="60%" | Behavior

|-
| angel_item_gens
| function(prefix,tokens)
| Called by ``entities.vault_guardian.default``, which supplies a unique ``prefix`` and doesn't provide ``tokens``.

|-
|
angel_item_info.armor.pants.gen 
angel_item_info.armor.armor.gen 
angel_item_info.armor.helm.gen 
angel_item_info.armor.gloves.gen 
angel_item_info.armor.shoes.gen 
angel_item_info.shield.gen
| function(i,prefix)
| Generates 1 piece of [[armor]] for each slot and 1 [[shield]].

|-
|
angel_item_info.clothing.pants.gen 
angel_item_info.clothing.armor.gen 
angel_item_info.clothing.helm.gen 
angel_item_info.clothing.gloves.gen 
angel_item_info.clothing.shoes.gen
| function(i,prefix)
| Generates 1 piece of [[clothing]] for each slot.

|-
|
angel_item_info.weapon.PIKE.gen 
angel_item_info.weapon.WHIP.gen 
angel_item_info.weapon.BOW.gen 
angel_item_info.weapon.BLOWGUN.gen 
angel_item_info.weapon.AXE.gen 
angel_item_info.weapon.SWORD.gen 
angel_item_info.weapon.DAGGER.gen 
angel_item_info.weapon.MACE.gen 
angel_item_info.weapon.HAMMER.gen 
angel_item_info.weapon.SPEAR.gen 
angel_item_info.weapon.CROSSBOW.gen
| function(i,prefix)
| Generates 5 [[weapon]]s. The tables correspond to [[combat skill]]s, and are not repeated. For example, a vault can't generate two types of swords.

|-
|
angel_item_info.ammo.ARROW 
angel_item_info.ammo.BOLT 
angel_item_info.ammo.BLOWDART
| function()
| When a ranged weapon is generated, it will also generate a random subtype of the proper ammunition.

|}

===Materials===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="15%" | Inputs
! width="15%" | Article
! width="60%" | Notes

|-
| materials.clouds
materials.rain
| function()
| [[Evil weather]]
| Associated regional [[interaction]]s are automatically written by ``init/generators.lua``.

|-
| materials.divine.metal
materials.divine.silk
| function([[sphere]])
| [[Divine metal]]
[[Divine fabric]]
| The list of potential spheres is determined by the individual function. See [[Lua script examples#New divine metal]].
{{token|DIVINE|inorganic}} and {{token|SPHERE|inorganic}} are added by ``generators.lua`` rather than in the individual function.

|-
| materials.mythical_remnant
| function([[sphere]])
| [[Primordial remnant]]
| Possible spheres are determined by ``random_object_parameters.mythical_sphere``.

|-
| materials.mythical_healing
| function()
| [[Mythical substance]]
|

|}

==Random Creatures==

Creatures generated by ``vanilla_procedural`` use a number of shared functions to determine their attributes. The local ``options`` table stores most of the data used by these steps.

===RCP Functions===
The random creature profile determines the basic body of a generated creature, such as "humanoid" or "[[toad]]", and provides options and data to later build the proper creature definition.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| ''table'' get_random_creature_profile(options,blacklist)
| Makes a weighted random choice of options from ``random_creature_types`` that satisfy arguments set in ``options`` (``options.do_water``, etc) and ``blacklist``. Falls back to ``random_creature_types.GENERAL_BLOB``.
At debug_level >= 3, will log failures. At debug_level >= 4, will also log successes.

|-
| ''bool'' is_valid_random_creature(''string'' creature, ''bool'' do_water, ''bool'' humanoid_only, ''bool'' is_good, ''bool'' beast_only)
| Checks if ``creature`` is a valid key in certain tables depending on the arguments: aquatic (``do_water``), can be "twisted into humanoid form" (``humanoid_only``), isn't an "evil" species (``is_good``), and is an animal species (``beast_only``)
At debug_level >= 3, will be logged.

|-
| ''void'' finalize_random_creature_types()
| If ``random_creature_types_finalized`` is false: sets it to true and iterates over ``random_creature_types`` to sanitize certain inputs.

|}

===Shared Functions===

Default creatures use ``add_regular_tokens()``, ``populate_sphere_info()``, ``get_random_creature_profile()``, ``add_body_size()`` and ``build_procgen_creature()`` as the main steps in generating raws.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| add_regular_tokens(tbl,options)
| Adds tokens to ``tbl``. Sets {{token|PETVALUE|2000}}, calculates material weaknesses (if ``options.material_weakness``), and adds a few immunity tokens depending on ``options.normal_biological``.

|-
| tile_string(arg)
| Returns a string usable for {{token|CREATURE_TILE}}. Encloses number arguments in ``'`` characters.

|-
| add_body_size(tbl,size,options)
| Adds {{token|BODY_SIZE|0:0:size}} and sets ``options.body_size``. Calls ``body_size_properties()``.

|-
| body_size_properties(tbl,size,options)
| Adds {{token|BUILDINGDESTROYER|2}} if size > 80,000; adds {{token|GRASSTRAMPLE|20}} and {{token|TRAPAVOID}} if size > 100,000.

|-
| populate_sphere_info(tbl,options)
| Adds {{token|SPHERE}} tokens from ``options.spheres``. If ``options.do_sphere_rcm``, 1/2 chance to set ``options.sphere_rcm``.

|-
| add_poison_bits(tbl,options)
| Generates a [[Venom|poison material]] based on ``options.poison_state`` and ``options.sickness_name``.

|-
| build_procgen_creature(rcp,tbl,options)
| Calls ``build_body_from_rcp()``, ``build_description()``, and ``build_pcg_graphics()``.

|-
| build_body_from_rcp(rcp,tbl,options)
| Generates based on ``rcp`` and ``options``, assigns tweaks (mutations from the base body), tissues, organs, special attacks.

|-
| build_description(tbl,options)
| Writes the {{token|DESCRIPTION}} and any {{token|PREFSTRING}}s.

|-
| build_pcg_graphics(tbl,options)
| Assigns [[procedural graphics layer]]s based on ``options.pcg_layering`` keys set by ``build_body_from_rcp()``.

|}

===Options===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="15%" | Key
! width="20%" | Usage
! width="80%" | Notes

|-
| token
| add_poison_bits()
build_body_from_rcp()
| The creature's token.

|-
| do_water
| get_random_creature_profile()
| Use an aquatic RCP (``water_based_random_creature``)

|-
| humanoid_only
| get_random_creature_profile()
| Use a RCP that can be turned into a humanoid form (``humanoidable_random_creature``)

|-
| beast_only
| get_random_creature_profile()
| Forbids generic humanoid/blob/quadruped RCPs (``not_beast_random_creature``).

|-
| normal_biological
| add_regular_tokens()
| If false, adds {{token|AMPHIBIOUS}}, {{token|SWIMS_INNATE}}, {{token|NONAUSEA}}, {{token|NOEXERT}}, {{token|NO_DIZZINESS}}, {{token|NOPAIN}}, {{token|NOSTUN}}. Used by [[experiment]]s.

|-
| always_nobreathe
| build_body_from_rcp()
| Adds {{token|NOBREATHE}}, even if not uniform.

|-
| no_general_poison
| build_body_from_rcp()
| If false and the creature has blood or ichor, adds {{token|CREATURE_CLASS|c|GENERAL_POISON}}.

|-
| fire_immune
| build_body_from_rcp()
| Adds {{token|FIREIMMUNE}}. Does not affect materials. Set if the creature has a fire interaction.

|-
| material_weakness
| add_regular_tokens()
| Will gain a 10x {{token|MATERIAL_FORCE_MULTIPLIER}} to a random weapon [[metal]] and a {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c|1:2}}.

|-
| is_good
|
get_random_creature_profile() 
build_body_from_rcp() 
build_description()
| Forbids "evil" RCPs (``cannot_be_good_random_creature``).
Affects options for materials, tweaks, description. Cannot have attack tweaks unless the RCP forces it.

|-
| is_evil
| build_body_from_rcp()
build_description()
| Affects options for materials, tweaks, description.

|-
| spheres
| populate_sphere_info()
color_picker_functions 
build_description()
| A set of the creature's spheres.

|-
| do_sphere_rcm
| populate_sphere_info()
| Adds a 1/2 chance to set ``options.sphere_rcm`` to a material relevant to their spheres.

|-
| pick_sphere_rcm
| random_creature_class.UNIFORM.body_fun()
| If uniform, adds an additional 1/2 chance to use a material relevant to their spheres.

|-
| pos_sphere_rcm
| populate_sphere_info()
| Temporary data storage for possible sphere RCM during ``populate_sphere_info()``.

|-
| sphere_rcm
| build_body_from_rcp()
| Forces the creature to be uniform and made of that ``random_creature_material``.

|-
| always_insubstantial
| build_body_from_rcp()
| If uniform, will always choose an insubstantial material from ``insubstantial_materials``.

|-
| never_uniform
| build_body_from_rcp()
| If ``options.r_class`` is UNIFORM, change it to FLESHY.

|-
| always_make_uniform
| build_body_from_rcp()
| Changes ``options.r_class`` to UNIFORM.

|-
| do_not_make_uniform
| build_body_from_rcp()
| Do not randomly change ``options.r_class`` to UNIFORM (normally there is a 1/20 chance), unless ``options.sphere_rcm`` is set.

|-
| walk_var
| build_body_from_rcp()
| A string for {{token|APPLY_CREATURE_VARIATION}}, ex: "STANDARD_WALKING_GAITS". Usually set by ``rcp.body_base``.

|-
| walk_speed
special_walk_speed
| build_body_from_rcp()
| The basic walking speed in a creature's [[gait]]. ``options.special_walk_speed`` will be used instead of ``options.walk_speed`` if both are present.
Crawling bodies use a ``options.walk_speed`` of 2900, walking bodies use 900.

|-
| add_fly_gaits
| build_body_from_rcp()
| Creature has a flying gait even if wings aren't added. ``local add_fly_gaits`` is used for creatures with wings.

|-
| intangible_flier
| build_body_from_rcp()
| If ``options.intangible`` (set by certain uniform materials), sets ``options.add_fly_gaits`` and adds {{token|FILER}}.

|-
| cannot_swim
| build_body_from_rcp()
| Will not add a [[swimming]] gait.

|-
| no_tweak
| build_body_from_rcp()
| Will not add any random tweaks (such as body parts or attacks) to the basic creature that aren't specified by the RCP.

|-
| always_glowing_eyes
| build_body_from_rcp()
| Will always add glowing eyes if the creature has ``options.eyes``.

|-
|
no_glowing_eyes 
cannot_have_antennae 
cannot_have_mandibles
| build_body_from_rcp()
| Will not add the listed body tweaks.

|-
| no_random_attack_tweak
| build_body_from_rcp()
| Will not add attack tweaks (or body parts that grant them) that aren't specified by the RCP.

|-
| strong_attack_tweak
| build_body_from_rcp()
| Enables access to attack tweaks. Will always gain an attack tweak, unless the RCP already specifies it.

|-
| experiment_attack_tweak
| build_body_from_rcp()
| Enables access to a limited set of attack tweaks 1/4 of the time.

|-
| sickness_name
| add_poison_bits()
| Determines the name of [[syndrome]]s caused by this creature.

|-
| poison_state
| add_poison_bits()
build_body_from_rcp()
| Accepts "LIQUID" (default), "GAS", or "SOLID_POWDER". Determines the state of this creature's [[venom]].

|-
| prioritize_bite
| post_attack_tweaks
| If true, non-bite attacks will have {{token|PRIORITY|c|SECOND}}. If false, non-bite attacks will have {{token|PRIORITY|c|MAIN}}.

|-
| bite_interaction
| post_attack_tweaks
| Adds {{token|SPECIALATTACK_INTERACTION}} to bite attacks.

|-
| can_bogey_polymorph
| post_gait_tweaks
| Allows the creature to use the [[bogeyman]] polymorph interaction.

|-
| rcp
| build_body_from_rcp()
build_description()
| Set in ``build_body_from_rcp()`` from the ``rcp`` argument.
Usually derived from ``random_creature_types``, passes information from the random creature profile.

|-
| r_class
| build_body_from_rcp()
| Set to a table in ``random_creature_class``. Describes the basic tissues/features a creature has, such as FLESHY, CHITIN_EXO, or UNIFORM.

|-
| surface
| build_body_from_rcp()
| The creature's exterior tissue. Set based on its ``random_creature_class`` and any tweaks.

|-
| rcm
| random_creature_class.UNIFORM.body_fun()
| Set by ``random_creature_class.UNIFORM.body_fun()``.
If ``options.sphere_rcm`` is supplied, will use that, otherwise will be randomly chosen based on ``options.is_evil``, ``options.is_good``, ``options.pick_sphere_rcm``, ``options.rcp.requires_flexible_material``, and ``options.always_insubstantial``.

|-
| post_mat_adj
| build_description()
| A string that says "composed of X", etc. Normally supplied by ``random_creature_material``.

|-
| matgloss
| random_creature_class.UNIFORM.body_fun()
| Temporary data storage when calling inorganic materials from ``random_creature_material``.

|-
| tok1
tok2
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|TISSUE_MATERIAL|tissue|options.tok1:options.tok2}}.
Must be supplied by ``random_creature_material``.

|-
| mat_temp1
mat_temp2
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|USE_MATERIAL_TEMPLATE|c|options.tok1:options.tok2}}.
Can be supplied by ``random_creature_material`` to add an organic material.

|-
| st_tok
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|TISSUE_MAT_STATE|tissue}}. Must be supplied by ``random_creature_material``.

|-
| fixed_temp
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|FIXED_TEMP|}}.
Can be supplied by ``random_creature_material``. If a material template is used, adds {{token|MAT_FIXED_TEMP|md}}.

|-
| intangible
| build_body_from_rcp()
| Flag normally supplied by ``random_creature_material``. Creature is non-solid, serves as the condition for ``options.intangible_flier``. Limits access to attack tweak.

|-
| fire_mat
| build_body_from_rcp()
| Flag normally supplied by ``random_creature_material``. Prevents a fire breath attack.

|-
| body_string
| build_body_from_rcp()
| An array of all {{token|BODY}} tokens used.

|-
| body_size
| build_description()
build_pcg_graphics()
| Set by ``body_size_properties()``. Stores the creature's volume for later use.

|-
| body_tweak_candidate
| build_body_from_rcp()
| Temporary data storage for assigning tweaks.

|-
| tweak
| ''quadruped_function_curry()''
| Temporary data storage for quadruped leg tweaks.

|-
|
attack_tweak 
btc 
btc2 
| build_body_from_rcp()
build_description()
| Strings used as a key to retrieve information about the chosen tweaks. Set by ``build_body_from_rcp()``

|-
|
beak 
brain 
cheeks 
eyelids 
guts 
heart 
lips 
lungs 
mouth 
neck 
nose 
ribs 
skull 
spine 
teeth 
throat 
tongue
| build_body_from_rcp()
| Normally set by the creature's ``random_creature_class`` (MAMMAL, CHITIN_EXO, etc).
Adds the listed parts to the creature's body plan.

|-
|
blood 
ichor 
goo
| build_body_from_rcp()
| Normally set by the creature's ``random_creature_class`` (MAMMAL, CHITIN_EXO, etc).
Sets the creature's default {{token|BLOOD}} type.

|-
| force_goo
force_ichor
| build_body_from_rcp()
| If the creature is not uniform, overwrites the creature's default {{token|BLOOD}} type.

|-
| blood_color
| build_body_from_rcp()
| Expects a function that takes a color's HSV values and returns a boolean. Sets the creature's blood color to any color that returns true for this function.
Only works with standard [[blood]] from ``options.blood``.

|-
|
eyes 
glowing_eyes 
fingers 
toes 
finger_claws 
toe_claws 
finger_nails 
toe_nails 
finger_talons 
toe_talons 
bat_wings 
lacy_wings 
feathered_wings 
has_proboscis 
do_webs

| build_procgen_creature()
| Set when building the body if the creature has those traits. Can be called by the description and when building graphics.
[[Nail]]s, claws, and talons are given attacks.

|-
| eye_count
| build_procgen_creature()
| The number of eyes the creature has. Set when building the body.

|-
| tail_count
| build_procgen_creature()
| The number of tails the creature has. Can be set before building the body.

|-
| clp
| build_procgen_creature()
| The creature's body color. Chosen randomly or based on material unless ``rcp.cannot_have_color`` is true.

|-
| eye_clp
| build_procgen_creature()
| The creature's eye color. Set when building the body.

|-
|
color_f 
color_b 
color_br
| build_body_from_rcp()
| Set based on ``options.clp`` unless ``options.forced_color`` is supplied. Adds {{token|COLOR|c|options.color_f:options.color_b:options.color_br}}.

|-
| forced_color
| build_body_from_rcp()
| Adds {{token|COLOR|c|options.forced_color.f:options.forced_color.b:options.forced_color.br}} and {{token|NO_UNIT_TYPE_COLOR}}.

|-
| animal_coloring_allowed
| build_body_from_rcp()
| Color must be a shade of brown.

|-
| experiment_colors
| build_body_from_rcp()
| Uses the set of colors assigned to [[experiment]]s.

|-
| exp_proc_surface_color
| build_pcg_graphics
| Stores the index of an experiment's color, for portraits.

|-
|
name_mat 
flavor_adj 
potential_end_phrase
| Custom names
| An array of names for a creature's material. Can be supplied by ``random_creature_material``.

|-
| feature_flavor_adj
| Custom names
| When ``build_description()`` is run, populates ``options.flavor_adj`` with strings based on the creature's tweaks and [[color]].

|-
| can_learn
| build_description()
| Enables certain description strings, such as "it knows and intones the names of all it encounters". Used by default intelligent creatures.

|-
| no_extra_description
| build_description()
| Will not add strings from ``default_desc_adds``/``good_desc_adds``/``evil_desc_adds`` to the end of the description.

|-
| custom_desc_func
| build_description()
| Adds the output of a string instead of ``default_desc_adds``/etc. Cannot have ``options.no_extra_description.``

|-
| end_phrase
| build_description()
| Adds a phrase after all other generated description pieces, such as [[Night creature|"Now you know why you fear the night."]]

|-
| and_add
| build_description()
| Temporary storage for description grammar.

|-
| pref_str
| build_description()
| A table of possible {{token|PREFSTRING}}s.

|-
| fallback_pref_str
| build_description()
| A string that is added to ``options.pref_str`` it is empty.

|-
| odor_string
odor_level
| build_body_from_rcp()
| Sets {{token|ODOR_STRING|}} and {{token|ODOR_LEVEL|}} respectively. Can be supplied by ``random_creature_material``.

|-
| forced_odor_string
forced_odor_level
forced_odor_chance
| build_body_from_rcp()
| Sets {{token|ODOR_STRING|}} and {{token|ODOR_LEVEL|}} (defaults to 90), 1 in ``options.forced_odor_chance`` of the time.

|-
| always_odor
| build_body_from_rcp()
| Can use the ``options.forced_odor_string`` even if creature is uniform.

|-
| pcg_layering
| build_pcg_graphics()
| A set of [[procedural graphics layer]]s. Set by ``build_pcg_graphics()``.

|-
| pcg_layering_base
| build_pcg_graphics()
| The basic PCG layer-set string, concatenated to form ``options.pcg_layering`` keys. Set by ``build_body_from_rcp()``.

|-
| pcg_layering_modifier
| build_pcg_graphics()
| A set of extra info for PCG layering, such as experiment skin types. Set by ``build_body_from_rcp()``.

|-
| use_werebeast_pcg
| build_pcg_graphics()
| If true, use the layers for [[werebeast]]s.

|-
| experiment_layering
| build_pcg_graphics()
| If true, use the layers for humanoid [[experiment]]s. Expects ``options.experiment_colors`` to be true.

|-
|
is_male_version
night_creature_strength_pref
night_creature_agile_pref
night_creature_strength_agile_pref
| night_troll_names
| Flags used by [[Night troll]]s.

|-
| no_default_werebeast_curse
| werebeast_origin_interactions.default()
| If this is true for a custom function in creatures.night_creature.werebeast, ``generate_from_list(werebeast_origin_interactions,tok,rcp.name_string,options)`` will not be able to use werebeast_origin_interactions.default. This allows [[mod]]s to better control access to [[werebeast]] curses.

|-
| amalgam_experiment
failed_experiment
| ''experiment_description()''
| Flags used for default [[experiment]]s.

|-
| experiment_name_type
| ''experiment_name_token''
| Array of nouns used instead of ``ropar.making_experiment`` for naming [[experiment]]s.

|-
| is_large
| ''make_failed_rcp()''
| Used for large failed [[experiment]]s. Capitalizes the creature tile.

|-
| eadj
fadj
| Custom names
| Temporary data storage for complex name generation.

|}

===RCP Parameters===

[[Category:Modding]]
[[Category:Lua|F]]

Lua functions

2025-05-14T20:24:24Z

Putnam3145: /* Randomization */ "userdata" is a specific term for a specific thing being pushed to Lua, it's a bit confusing to call it that

{{Modding}}

Dwarf Fortress defines a number of functions in addition to those standard for [https://www.lua.org/manual/5.4/ Lua 5.4].

==C++ Function Calls==

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''int'' {{text anchor|trandom}}(''int'' n)
| Returns a 32-bit integer from {{Tooltip|0 to n-1|Lua arrays start at 1, C++ arrays start at 0, hence the discrepancy.}}. Uses DF's internal RNG system instead of ``math.random()``.

|-
| ''str'' {{text anchor|capitalize_string_words}}(''str'' s)
| Capitalizes every word in a string.

|-
| ''str'' {{text anchor|capitalize_string_first_word}}(''str'' s)
| Capitalizes the first word in a string.

|-
| ''str'' {{text anchor|utterance}}()
| Returns a word from the [[kobold language]].

|-
| ''void'' {{text anchor|lua_log}}(''str'' s)
| Prints a string to ``Dwarf Fortress/lualog.txt``. The ``log()`` function is more robust and should be used instead.

|-
|
''void'' {{text anchor|raws.register_creatures}}(''table'' lines) 
''void'' {{text anchor|raws.register_entities}}(''table'' lines) 
''void'' {{text anchor|raws.register_inorganics}}(''table'' lines) 
''void'' {{text anchor|raws.register_interactions}}(''table'' lines) 
''void'' {{text anchor|raws.register_items}}(''table'' lines) 
''void'' {{text anchor|raws.register_languages}}(''table'' lines) 
''void'' {{text anchor|raws.register_plants}}(''table'' lines){{verify}}
| Takes a table of [[token]]s and reads them as that type of [[raw file]]. It is not necessary to add a header.

|}

==Globals==
Helper functions are defined in ``init/globals.lua``, and can be accessed by any script even if ``vanilla_procedural`` is not loaded.

===Generation===
This function is defined in ``init/generators.lua``.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''table'' {{text anchor|add_generated_info}}(''table'' tbl)
| Adds {{token|GENERATED}} to the input table, and {{token|SOURCE_HFID}}/{{token|SOURCE_ENID}} if IDs are defined. Necessary for generated raws to be saved properly.

|}

===Randomization===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description

|-
| ''value'' {{text anchor|pick_random}}(''table'' t)
| Returns a random value from a table.

|-
| ''value'' {{text anchor|pick_random_no_replace}}(''table'' t)
| Returns a random value from a table, then removes it from the table.

|-
| ''value'' {{text anchor|pick_random_conditional}}(''table'' t, ''function'' cond,...)
| Returns a random value from a table that satisfies ``cond(...)``.

|-
| ''bool'' {{text anchor|one_in}}(''num'' x)
| Returns true with a one in x chance.

|-
| ''value'' {{text anchor|pick_random_pairs}}(''table'' tbl)
| Returns a random key from a table. For example, ``pick_random_pairs( {WATER = true} )`` returns "WATER".

|-
| ''value'' {{text anchor|pick_weighted_from_table}}(''table'' tbl)
| Requires a table of tables with ``weight`` keys. Returns a weighted random value.
At debug level >=4, logs the roll.

|-
| ''value'' {{text anchor|generate_from_list}}(''table'' tbl,...)
| Requires a table of functions that return a ``weight`` key. Runs each function and returns a weighted random output. Used by [[werebeast]]s to generate an interaction and link to options from it.

|}

===Tables===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Function
! width="70%" | Description
|-
| ''table'' {{text anchor|split_to_lines}}(''table'' tbl,''string'' str)
| Adds a string into a table, with each line being a separate key.

|-
| ''table'' {{text anchor|map_merge}}(''table'' tbl1, ''table'' tbl2)
| Combines two tables. If ``tbl1`` already has a value for a given key, it will not be overwritten. Used for sets such as ``{ WATER = true }``.

|-
| ''table'' {{text anchor|table_merge}}(''table'' tbl1, ''table'' tbl2)
| Adds each value from ``tbl2`` onto the end of ``tbl1``.

|-
| ''bool'' {{text anchor|find_in_array_part}}(''table'' tbl, ''userdata'' item)
| Returns true if ``item`` is a value in ``tbl``.

|-
| ''void'' {{text anchor|convert_array_to_set}}(''table'' tbl)
| For each key in a table, sets the value to true.

|-
| ''void'' {{text anchor|add_unique}}(''table'' tbl, ''userdata'' item)
| Adds ``item`` to the end of ``tbl`` if not already present.

|-
| ''void'' {{text anchor|remove_item}}(''table'' tbl, ''userdata'' item)
| Removes all instances of ``item`` from ``tbl``.

|-
| ''table'' {{text anchor|shallow_copy}}(''table'' tbl)
| Returns a table copied from all values in the input table.

|-
| ''table'' {{text anchor|deep_copy}}(''table'' tbl)
| Returns a table recursively copied from all values in the input table.

|}

===Debug===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Description
|-
| ''void'' {{text anchor|log}}(...)
| Logs the input to ``Dwarf Fortress/lualog.txt``. Used for most cases.

|-
| ''string'' {{text anchor|get_caller_loc_string}}()
| Returns the debug source info and the current line.

|-
| ''string'' {{text anchor|get_debug_logger}}(''num'' level=1,...)
| Logs ``get_caller_loc_string()`` and any overloads if the ``debug_level`` is at least ``level``. ``debug_level`` is a global variable that defaults to 0.

|-
| ''function'' {{text anchor|partial_function}}(''function'' f, arg,...)
| Returns ``f(arg,...)``.

|-
| ''function'' {{text anchor|log_table}}(''table'' tbl, ''num'' debug_level=0, ''num'' nest_level=0, ''num'' added_debug_from_nest=0)
| Logs a table if the global ``debug_level`` is at least the input ``debug_level``. ``nest_level`` starts at 0 and adds ``added_debug_from_nest`` for each nesting to the input debug level.

|-
| ''function'' {{text anchor|print_table}}(''table'' tbl, ''num'' nest_level=0)
| Logs a table, regardless of debug level.

|}

===Spheres===

{| {{prettytable}}
|- style='background-color:#ddd'
! width="45%" | Function
! width="55%" | Description

|-
| ''string'' {{text anchor|get_random_sphere_adjective}}(''string'' [[Sphere#Sphere tokens|sphere]])
| Returns a random string from global table ``random_sphere_adjective[sph]``.

|-
| ''table'' {{text anchor|get_random_sphere_noun}}(''string'' [[Sphere#Sphere tokens|sphere]])
| Returns a random table ``tbl`` from global table ``random_sphere_nouns[sphere]``.
``tbl`` has two members: ``tbl.str``, which is a string; and ``tbl.flags``, which defaults to ``{OF=true,PREPOS=true,PRE=true}``, for grammar.

|-
| ''table'' {{text anchor|add_sphere_mpp}}(''table'' sphere_list, ''string'' [[Sphere#Sphere tokens|new_s]], ''table'' available_sphere, ''table'' available_sphere_cur)
| Adds ``new_s`` to ``sphere_list`` and all parents and children. Sets the added spheres in ``available_sphere`` and ``available_sphere_cur`` to false, and sets all enemies in ``available_sphere_cur`` to false.
At debug level >= 2, will be logged.
|}

==Generation Tables==
The ``generate()`` function is defined in ``init/generators.lua``, and is called to generate objects.

Each type of random object is defined through a function that generates a table of raws. To generate objects for specific purposes, ``generate()`` can call functions from a table and provide inputs such as ``tok`` (unique token string).
For example, [[forgotten beast]]s are unique and generated for each cave region. If multiple functions are defined in ``creatures.fb``, such as both ``creatures.fb.default`` and a modded forgotten beast, the game uses the ``weight`` output to influence which one will be randomly chosen.

By default, objects are generated in this order: unittests{{Tooltip|*|if debug_level is at least 0}}, preprocess, do_once, materials, items, languages, creatures, interactions, entities, and postprocess. Do note that you can register raws at any step. For example, each [[vault]] entity generates a set of [[divine equipment]] during the entity step, and [[werebeast]]s generate a curse interaction during the creature step.

===Custom===

All functions in these tables are run each tick, but global variable ``random_object_parameters`` is only ever populated with values once per generation. Functions called through these tables are not supplied with arguments.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="80%" | Description

|-
| preprocess
| Runs once the world's terrain has been finalized and before history can begin.
Includes two functions by default: 
``preprocess.demon()``, which populates the distribution of ``demon_type`` string inputs 
``preprocess.bogeyman_polymorph()``, which generates the [[bogeyman]]'s polymorph interaction if bogeymen exist 

|-
| do_once
| Runs immediately after all functions in preprocess, and before all other generation steps. Only runs if ``random_object_parameters.main_world_randoms = true``, for added safety.
Recommended for generating custom objects.

|-
| postprocess
| Runs after all other generation steps are finished.

|-
| unittests
| Runs before preprocess if the global ``debug_level`` is greater than 0. Expects a boolean output.

|-
| languages
| For each function in this table, registers a language. Expects table of key-value pairs where the key is the [[Language token#WORD|word token]] and the value is the translated string.

|}

===Creatures===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Table
! width="40%" | Inputs
! width="60%" | Article

|-
|
creatures.angel.great_beast 
creatures.angel.humanoid_generic 
creatures.angel.humanoid_warrior
| function(tok)
| [[Angel]] (see [[Angel#Angel types|types]])

|-
| creatures.demon
| function(demon_type,difficulty,tok)
| [[Demon]]

|-
|
creatures.experiment.beast_large 
creatures.experiment.beast_small 
creatures.experiment.failed_large 
creatures.experiment.failed_small 
creatures.experiment.humanoid_giant 
creatures.experiment.humanoid 
| function(tok)
| [[Experiment]]

|-
| creatures.fb
| function(layer_type,tok)
| [[Forgotten beast]]

|-
| creatures.night_creature.bogeyman
| function(tok)
| [[Bogeyman]]

|-
| creatures.night_creature.nightmare
| function(tok)
| [[Nightmare]]

|-
| creatures.night_creature.troll
| function(tok)
| [[Night troll]]

|-
| creatures.night_creature.werebeast
werebeast_origin_interactions{{Tooltip|*|Called by vanilla_procedural, not by init/generators}}
| function(tok)
function(tok,name,options)
| [[Werebeast]]

|-
| creatures.titan
| function(subregion,tok)
| [[Titan]]

|}

===Entities===

Generated entities are supplied with the ``idx`` parameter, which is a number that starts at 1 and increments by 1 for each entity of that type. It can be used to give a unique ID to [[divine equipment]].

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Table
! width="20%" | Inputs
! width="60%" | Articles

|-
| entities.vault_guardian
| function(idx,tok)
| [[Vault]] ([[angel]]s)

|-
| entities.mythical_guardian
| function(idx,tok)
| [[Mysterious dungeon]] ([[dungeon guardian]]s)

|}

===Interactions===

====World====
World interactions are generated in the ``generate_random_interactions()`` step of ``generators.lua``.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Table
! width="30%" | Inputs
! width="60%" | Examples

|-
|
interactions.blessing.minor 
interactions.blessing.medium
| function(idx)
| [[Die]] roll effects: luck, holy item, healing, etc

|-
|
interactions.curse.minor 
interactions.curse.medium
| function(idx)
| [[Die]] roll effects: week of curse

|-
| interactions.curse.major
| function(idx,tok)
| [[Vampire]]

|-
| interactions.disturbance
| function(idx)
| [[Mummy]]

|-
| interactions.mythical
| function(idx,power_level,[[sphere]])
| [[Dungeon guardian]]

|-
| interactions.mythical_item_power
| spheres={}, interaction=function()
| [[Primordial remnant#List of powers]]

|-
| interactions.regional
| function(idx)
| Reanimating [[Surroundings#Evil|evil biomes]]

|-
| interactions.secrets
| function(idx,[[sphere]])
| [[Necromancer]]

|}

====Powers====
Powers are stored in the ``interactions.powers`` table and can be generated by other interactions. The structure of each power entry contains several keys that determine how it can be added to an interaction's syndrome.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="15%" | Key
! width="30%" | Inputs
! width="60%" | Notes

|-
| tags
| ''table''
| A table of user-defined values that can be checked by other functions.

|-
| tags.lieutenant
| ''bool''
| If true, available to [[intelligent undead]].

|-
| rarity
| ''number'' n
| Higher is rarer. An [[intelligent undead]] has a 1 in n chance to receive this power.

|-
| gen
| ''table'' ``tbl``, ''table'' ``end_tbl`` function(name)
| Generates and returns lines of raws.
* ``tbl`` consists of [[syndrome]] lines comprising {{token|CE_CAN_DO_INTERACTION|syndrome}} and ``[[Interaction token#Usage|CDI]]``.
* ``end_tbl`` consists of lines that define the [[interaction]].

|}

====Interaction helpers====

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| ''table'' ``tbl``, ''table'' ``end_tbl`` basic_lieutenant(''string'' name, ''string'' name_plural, ''string'' token)
| Generates an interaction that raises an [[intelligent undead]] and calls ``basic_lieutenant_powers(token)``.

|-
| ''table'' ``tbl``, ''table'' ``end_tbl`` basic_lieutenant_powers(''string'' token)
| Adds any number of powers (chosen from among ``interaction.powers``) and 0-5 sicken effects (from ``add_curses()``) to the current definition.

|-
| ''table'' ``tbl``, ''table'' ``end_tbl``, ''int'' ``idx`` add_curses(''table'' tbl, ''table'' end_tbl, ''string'' token, ''int'' num, ''int'' start_idx, ''int'' sev, ''table'' good_effects)
| Adds ``num`` curses/afflictions to the current definition. ``good_effects`` lists the possible curses that can be chosen from ``default_curse_effects``, and ``sev`` is the syndrome's severity. Basic lieutenants use a ``sev`` of 500.

|-
| ''string'' get_abstract_gesture()
| Returns a random string from either ``gestures`` or ``gestures_abstract``, used for {{token|VERB|interaction}}.

|}

===Items===

====Instruments====

The default [[instrument]] system is not currently open to Lua, but ``generators.lua`` defines tables for each token.
{| {{prettytable}}
|- style='background-color:#ddd'
! width="30%" | Table
! width="30%" | Inputs
! width="40%" | Token

|-
| items.instruments.keyboard
| N/A
| {{token|GENERATE_KEYBOARD_INSTRUMENTS|e}}

|-
| items.instruments.stringed
| N/A
| {{token|GENERATE_STRINGED_INSTRUMENTS|e}}

|-
| items.instruments.wind
| N/A
| {{token|GENERATE_WIND_INSTRUMENTS|e}}

|-
| items.instruments.percussion
| N/A
| {{token|GENERATE_PERCUSSION_INSTRUMENTS|e}}

|}

====Divine equipment====
{{Main|Divine equipment}}
``entities.vault_guardian.default`` generates from the list ``angel_item_gens``, the default function of which then calls functions from ``angel_item_info``. Unless otherwise stated, the '''Behavior''' column refers to the behavior of how ``angel_item_gens.default`` generates from these lists.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="20%" | Inputs
! width="60%" | Behavior

|-
| angel_item_gens
| function(prefix,tokens)
| Called by ``entities.vault_guardian.default``, which supplies a unique ``prefix`` and doesn't provide ``tokens``.

|-
|
angel_item_info.armor.pants.gen 
angel_item_info.armor.armor.gen 
angel_item_info.armor.helm.gen 
angel_item_info.armor.gloves.gen 
angel_item_info.armor.shoes.gen 
angel_item_info.shield.gen
| function(i,prefix)
| Generates 1 piece of [[armor]] for each slot and 1 [[shield]].

|-
|
angel_item_info.clothing.pants.gen 
angel_item_info.clothing.armor.gen 
angel_item_info.clothing.helm.gen 
angel_item_info.clothing.gloves.gen 
angel_item_info.clothing.shoes.gen
| function(i,prefix)
| Generates 1 piece of [[clothing]] for each slot.

|-
|
angel_item_info.weapon.PIKE.gen 
angel_item_info.weapon.WHIP.gen 
angel_item_info.weapon.BOW.gen 
angel_item_info.weapon.BLOWGUN.gen 
angel_item_info.weapon.AXE.gen 
angel_item_info.weapon.SWORD.gen 
angel_item_info.weapon.DAGGER.gen 
angel_item_info.weapon.MACE.gen 
angel_item_info.weapon.HAMMER.gen 
angel_item_info.weapon.SPEAR.gen 
angel_item_info.weapon.CROSSBOW.gen
| function(i,prefix)
| Generates 5 [[weapon]]s. The tables correspond to [[combat skill]]s, and are not repeated. For example, a vault can't generate two types of swords.

|-
|
angel_item_info.ammo.ARROW 
angel_item_info.ammo.BOLT 
angel_item_info.ammo.BLOWDART
| function()
| When a ranged weapon is generated, it will also generate a random subtype of the proper ammunition.

|}

===Materials===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Table
! width="15%" | Inputs
! width="15%" | Article
! width="60%" | Notes

|-
| materials.clouds
materials.rain
| function()
| [[Evil weather]]
| Associated regional [[interaction]]s are automatically written by ``init/generators.lua``.

|-
| materials.divine.metal
materials.divine.silk
| function([[sphere]])
| [[Divine metal]]
[[Divine fabric]]
| The list of potential spheres is determined by the individual function. See [[Lua script examples#New divine metal]].
{{token|DIVINE|inorganic}} and {{token|SPHERE|inorganic}} are added by ``generators.lua`` rather than in the individual function.

|-
| materials.mythical_remnant
| function([[sphere]])
| [[Primordial remnant]]
| Possible spheres are determined by ``random_object_parameters.mythical_sphere``.

|-
| materials.mythical_healing
| function()
| [[Mythical substance]]
|

|}

==Random Creatures==

Creatures generated by ``vanilla_procedural`` use a number of shared functions to determine their attributes. The local ``options`` table stores most of the data used by these steps.

===RCP Functions===
The random creature profile determines the basic body of a generated creature, such as "humanoid" or "[[toad]]", and provides options and data to later build the proper creature definition.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| ''table'' get_random_creature_profile(options,blacklist)
| Makes a weighted random choice of options from ``random_creature_types`` that satisfy arguments set in ``options`` (``options.do_water``, etc) and ``blacklist``. Falls back to ``random_creature_types.GENERAL_BLOB``.
At debug_level >= 3, will log failures. At debug_level >= 4, will also log successes.

|-
| ''bool'' is_valid_random_creature(''string'' creature, ''bool'' do_water, ''bool'' humanoid_only, ''bool'' is_good, ''bool'' beast_only)
| Checks if ``creature`` is a valid key in certain tables depending on the arguments: aquatic (``do_water``), can be "twisted into humanoid form" (``humanoid_only``), isn't an "evil" species (``is_good``), and is an animal species (``beast_only``)
At debug_level >= 3, will be logged.

|-
| ''void'' finalize_random_creature_types()
| If ``random_creature_types_finalized`` is false: sets it to true and iterates over ``random_creature_types`` to sanitize certain inputs.

|}

===Shared Functions===

Default creatures use ``add_regular_tokens()``, ``populate_sphere_info()``, ``get_random_creature_profile()``, ``add_body_size()`` and ``build_procgen_creature()`` as the main steps in generating raws.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="40%" | Function
! width="60%" | Notes

|-
| add_regular_tokens(tbl,options)
| Adds tokens to ``tbl``. Sets {{token|PETVALUE|2000}}, calculates material weaknesses (if ``options.material_weakness``), and adds a few immunity tokens depending on ``options.normal_biological``.

|-
| tile_string(arg)
| Returns a string usable for {{token|CREATURE_TILE}}. Encloses number arguments in ``'`` characters.

|-
| add_body_size(tbl,size,options)
| Adds {{token|BODY_SIZE|0:0:size}} and sets ``options.body_size``. Calls ``body_size_properties()``.

|-
| body_size_properties(tbl,size,options)
| Adds {{token|BUILDINGDESTROYER|2}} if size > 80,000; adds {{token|GRASSTRAMPLE|20}} and {{token|TRAPAVOID}} if size > 100,000.

|-
| populate_sphere_info(tbl,options)
| Adds {{token|SPHERE}} tokens from ``options.spheres``. If ``options.do_sphere_rcm``, 1/2 chance to set ``options.sphere_rcm``.

|-
| add_poison_bits(tbl,options)
| Generates a [[Venom|poison material]] based on ``options.poison_state`` and ``options.sickness_name``.

|-
| build_procgen_creature(rcp,tbl,options)
| Calls ``build_body_from_rcp()``, ``build_description()``, and ``build_pcg_graphics()``.

|-
| build_body_from_rcp(rcp,tbl,options)
| Generates based on ``rcp`` and ``options``, assigns tweaks (mutations from the base body), tissues, organs, special attacks.

|-
| build_description(tbl,options)
| Writes the {{token|DESCRIPTION}} and any {{token|PREFSTRING}}s.

|-
| build_pcg_graphics(tbl,options)
| Assigns [[procedural graphics layer]]s based on ``options.pcg_layering`` keys set by ``build_body_from_rcp()``.

|}

===Options===
{| {{prettytable}}
|- style='background-color:#ddd'
! width="15%" | Key
! width="20%" | Usage
! width="80%" | Notes

|-
| token
| add_poison_bits()
build_body_from_rcp()
| The creature's token.

|-
| do_water
| get_random_creature_profile()
| Use an aquatic RCP (``water_based_random_creature``)

|-
| humanoid_only
| get_random_creature_profile()
| Use a RCP that can be turned into a humanoid form (``humanoidable_random_creature``)

|-
| beast_only
| get_random_creature_profile()
| Forbids generic humanoid/blob/quadruped RCPs (``not_beast_random_creature``).

|-
| normal_biological
| add_regular_tokens()
| If false, adds {{token|AMPHIBIOUS}}, {{token|SWIMS_INNATE}}, {{token|NONAUSEA}}, {{token|NOEXERT}}, {{token|NO_DIZZINESS}}, {{token|NOPAIN}}, {{token|NOSTUN}}. Used by [[experiment]]s.

|-
| always_nobreathe
| build_body_from_rcp()
| Adds {{token|NOBREATHE}}, even if not uniform.

|-
| no_general_poison
| build_body_from_rcp()
| If false and the creature has blood or ichor, adds {{token|CREATURE_CLASS|c|GENERAL_POISON}}.

|-
| fire_immune
| build_body_from_rcp()
| Adds {{token|FIREIMMUNE}}. Does not affect materials. Set if the creature has a fire interaction.

|-
| material_weakness
| add_regular_tokens()
| Will gain a 10x {{token|MATERIAL_FORCE_MULTIPLIER}} to a random weapon [[metal]] and a {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c|1:2}}.

|-
| is_good
|
get_random_creature_profile() 
build_body_from_rcp() 
build_description()
| Forbids "evil" RCPs (``cannot_be_good_random_creature``).
Affects options for materials, tweaks, description. Cannot have attack tweaks unless the RCP forces it.

|-
| is_evil
| build_body_from_rcp()
build_description()
| Affects options for materials, tweaks, description.

|-
| spheres
| populate_sphere_info()
color_picker_functions 
build_description()
| A set of the creature's spheres.

|-
| do_sphere_rcm
| populate_sphere_info()
| Adds a 1/2 chance to set ``options.sphere_rcm`` to a material relevant to their spheres.

|-
| pick_sphere_rcm
| random_creature_class.UNIFORM.body_fun()
| If uniform, adds an additional 1/2 chance to use a material relevant to their spheres.

|-
| pos_sphere_rcm
| populate_sphere_info()
| Temporary data storage for possible sphere RCM during ``populate_sphere_info()``.

|-
| sphere_rcm
| build_body_from_rcp()
| Forces the creature to be uniform and made of that ``random_creature_material``.

|-
| always_insubstantial
| build_body_from_rcp()
| If uniform, will always choose an insubstantial material from ``insubstantial_materials``.

|-
| never_uniform
| build_body_from_rcp()
| If ``options.r_class`` is UNIFORM, change it to FLESHY.

|-
| always_make_uniform
| build_body_from_rcp()
| Changes ``options.r_class`` to UNIFORM.

|-
| do_not_make_uniform
| build_body_from_rcp()
| Do not randomly change ``options.r_class`` to UNIFORM (normally there is a 1/20 chance), unless ``options.sphere_rcm`` is set.

|-
| walk_var
| build_body_from_rcp()
| A string for {{token|APPLY_CREATURE_VARIATION}}, ex: "STANDARD_WALKING_GAITS". Usually set by ``rcp.body_base``.

|-
| walk_speed
special_walk_speed
| build_body_from_rcp()
| The basic walking speed in a creature's [[gait]]. ``options.special_walk_speed`` will be used instead of ``options.walk_speed`` if both are present.
Crawling bodies use a ``options.walk_speed`` of 2900, walking bodies use 900.

|-
| add_fly_gaits
| build_body_from_rcp()
| Creature has a flying gait even if wings aren't added. ``local add_fly_gaits`` is used for creatures with wings.

|-
| intangible_flier
| build_body_from_rcp()
| If ``options.intangible`` (set by certain uniform materials), sets ``options.add_fly_gaits`` and adds {{token|FILER}}.

|-
| cannot_swim
| build_body_from_rcp()
| Will not add a [[swimming]] gait.

|-
| no_tweak
| build_body_from_rcp()
| Will not add any random tweaks (such as body parts or attacks) to the basic creature that aren't specified by the RCP.

|-
| always_glowing_eyes
| build_body_from_rcp()
| Will always add glowing eyes if the creature has ``options.eyes``.

|-
|
no_glowing_eyes 
cannot_have_antennae 
cannot_have_mandibles
| build_body_from_rcp()
| Will not add the listed body tweaks.

|-
| no_random_attack_tweak
| build_body_from_rcp()
| Will not add attack tweaks (or body parts that grant them) that aren't specified by the RCP.

|-
| strong_attack_tweak
| build_body_from_rcp()
| Enables access to attack tweaks. Will always gain an attack tweak, unless the RCP already specifies it.

|-
| experiment_attack_tweak
| build_body_from_rcp()
| Enables access to a limited set of attack tweaks 1/4 of the time.

|-
| sickness_name
| add_poison_bits()
| Determines the name of [[syndrome]]s caused by this creature.

|-
| poison_state
| add_poison_bits()
build_body_from_rcp()
| Accepts "LIQUID" (default), "GAS", or "SOLID_POWDER". Determines the state of this creature's [[venom]].

|-
| prioritize_bite
| post_attack_tweaks
| If true, non-bite attacks will have {{token|PRIORITY|c|SECOND}}. If false, non-bite attacks will have {{token|PRIORITY|c|MAIN}}.

|-
| bite_interaction
| post_attack_tweaks
| Adds {{token|SPECIALATTACK_INTERACTION}} to bite attacks.

|-
| can_bogey_polymorph
| post_gait_tweaks
| Allows the creature to use the [[bogeyman]] polymorph interaction.

|-
| rcp
| build_body_from_rcp()
build_description()
| Set in ``build_body_from_rcp()`` from the ``rcp`` argument.
Usually derived from ``random_creature_types``, passes information from the random creature profile.

|-
| r_class
| build_body_from_rcp()
| Set to a table in ``random_creature_class``. Describes the basic tissues/features a creature has, such as FLESHY, CHITIN_EXO, or UNIFORM.

|-
| surface
| build_body_from_rcp()
| The creature's exterior tissue. Set based on its ``random_creature_class`` and any tweaks.

|-
| rcm
| random_creature_class.UNIFORM.body_fun()
| Set by ``random_creature_class.UNIFORM.body_fun()``.
If ``options.sphere_rcm`` is supplied, will use that, otherwise will be randomly chosen based on ``options.is_evil``, ``options.is_good``, ``options.pick_sphere_rcm``, ``options.rcp.requires_flexible_material``, and ``options.always_insubstantial``.

|-
| post_mat_adj
| build_description()
| A string that says "composed of X", etc. Normally supplied by ``random_creature_material``.

|-
| matgloss
| random_creature_class.UNIFORM.body_fun()
| Temporary data storage when calling inorganic materials from ``random_creature_material``.

|-
| tok1
tok2
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|TISSUE_MATERIAL|tissue|options.tok1:options.tok2}}.
Must be supplied by ``random_creature_material``.

|-
| mat_temp1
mat_temp2
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|USE_MATERIAL_TEMPLATE|c|options.tok1:options.tok2}}.
Can be supplied by ``random_creature_material`` to add an organic material.

|-
| st_tok
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|TISSUE_MAT_STATE|tissue}}. Must be supplied by ``random_creature_material``.

|-
| fixed_temp
| random_creature_class.UNIFORM.body_fun()
| A uniform creature's {{token|FIXED_TEMP|}}.
Can be supplied by ``random_creature_material``. If a material template is used, adds {{token|MAT_FIXED_TEMP|md}}.

|-
| intangible
| build_body_from_rcp()
| Flag normally supplied by ``random_creature_material``. Creature is non-solid, serves as the condition for ``options.intangible_flier``. Limits access to attack tweak.

|-
| fire_mat
| build_body_from_rcp()
| Flag normally supplied by ``random_creature_material``. Prevents a fire breath attack.

|-
| body_string
| build_body_from_rcp()
| An array of all {{token|BODY}} tokens used.

|-
| body_size
| build_description()
build_pcg_graphics()
| Set by ``body_size_properties()``. Stores the creature's volume for later use.

|-
| body_tweak_candidate
| build_body_from_rcp()
| Temporary data storage for assigning tweaks.

|-
| tweak
| ''quadruped_function_curry()''
| Temporary data storage for quadruped leg tweaks.

|-
|
attack_tweak 
btc 
btc2 
| build_body_from_rcp()
build_description()
| Strings used as a key to retrieve information about the chosen tweaks. Set by ``build_body_from_rcp()``

|-
|
beak 
brain 
cheeks 
eyelids 
guts 
heart 
lips 
lungs 
mouth 
neck 
nose 
ribs 
skull 
spine 
teeth 
throat 
tongue
| build_body_from_rcp()
| Normally set by the creature's ``random_creature_class`` (MAMMAL, CHITIN_EXO, etc).
Adds the listed parts to the creature's body plan.

|-
|
blood 
ichor 
goo
| build_body_from_rcp()
| Normally set by the creature's ``random_creature_class`` (MAMMAL, CHITIN_EXO, etc).
Sets the creature's default {{token|BLOOD}} type.

|-
| force_goo
force_ichor
| build_body_from_rcp()
| If the creature is not uniform, overwrites the creature's default {{token|BLOOD}} type.

|-
| blood_color
| build_body_from_rcp()
| Expects a function that takes a color's HSV values and returns a boolean. Sets the creature's blood color to any color that returns true for this function.
Only works with standard [[blood]] from ``options.blood``.

|-
|
eyes 
glowing_eyes 
fingers 
toes 
finger_claws 
toe_claws 
finger_nails 
toe_nails 
finger_talons 
toe_talons 
bat_wings 
lacy_wings 
feathered_wings 
has_proboscis 
do_webs

| build_procgen_creature()
| Set when building the body if the creature has those traits. Can be called by the description and when building graphics.
[[Nail]]s, claws, and talons are given attacks.

|-
| eye_count
| build_procgen_creature()
| The number of eyes the creature has. Set when building the body.

|-
| tail_count
| build_procgen_creature()
| The number of tails the creature has. Can be set before building the body.

|-
| clp
| build_procgen_creature()
| The creature's body color. Chosen randomly or based on material unless ``rcp.cannot_have_color`` is true.

|-
| eye_clp
| build_procgen_creature()
| The creature's eye color. Set when building the body.

|-
|
color_f 
color_b 
color_br
| build_body_from_rcp()
| Set based on ``options.clp`` unless ``options.forced_color`` is supplied. Adds {{token|COLOR|c|options.color_f:options.color_b:options.color_br}}.

|-
| forced_color
| build_body_from_rcp()
| Adds {{token|COLOR|c|options.forced_color.f:options.forced_color.b:options.forced_color.br}} and {{token|NO_UNIT_TYPE_COLOR}}.

|-
| animal_coloring_allowed
| build_body_from_rcp()
| Color must be a shade of brown.

|-
| experiment_colors
| build_body_from_rcp()
| Uses the set of colors assigned to [[experiment]]s.

|-
| exp_proc_surface_color
| build_pcg_graphics
| Stores the index of an experiment's color, for portraits.

|-
|
name_mat 
flavor_adj 
potential_end_phrase
| Custom names
| An array of names for a creature's material. Can be supplied by ``random_creature_material``.

|-
| feature_flavor_adj
| Custom names
| When ``build_description()`` is run, populates ``options.flavor_adj`` with strings based on the creature's tweaks and [[color]].

|-
| can_learn
| build_description()
| Enables certain description strings, such as "it knows and intones the names of all it encounters". Used by default intelligent creatures.

|-
| no_extra_description
| build_description()
| Will not add strings from ``default_desc_adds``/``good_desc_adds``/``evil_desc_adds`` to the end of the description.

|-
| custom_desc_func
| build_description()
| Adds the output of a string instead of ``default_desc_adds``/etc. Cannot have ``options.no_extra_description.``

|-
| end_phrase
| build_description()
| Adds a phrase after all other generated description pieces, such as [[Night creature|"Now you know why you fear the night."]]

|-
| and_add
| build_description()
| Temporary storage for description grammar.

|-
| pref_str
| build_description()
| A table of possible {{token|PREFSTRING}}s.

|-
| fallback_pref_str
| build_description()
| A string that is added to ``options.pref_str`` it is empty.

|-
| odor_string
odor_level
| build_body_from_rcp()
| Sets {{token|ODOR_STRING|}} and {{token|ODOR_LEVEL|}} respectively. Can be supplied by ``random_creature_material``.

|-
| forced_odor_string
forced_odor_level
forced_odor_chance
| build_body_from_rcp()
| Sets {{token|ODOR_STRING|}} and {{token|ODOR_LEVEL|}} (defaults to 90), 1 in ``options.forced_odor_chance`` of the time.

|-
| always_odor
| build_body_from_rcp()
| Can use the ``options.forced_odor_string`` even if creature is uniform.

|-
| pcg_layering
| build_pcg_graphics()
| A set of [[procedural graphics layer]]s. Set by ``build_pcg_graphics()``.

|-
| pcg_layering_base
| build_pcg_graphics()
| The basic PCG layer-set string, concatenated to form ``options.pcg_layering`` keys. Set by ``build_body_from_rcp()``.

|-
| pcg_layering_modifier
| build_pcg_graphics()
| A set of extra info for PCG layering, such as experiment skin types. Set by ``build_body_from_rcp()``.

|-
| use_werebeast_pcg
| build_pcg_graphics()
| If true, use the layers for [[werebeast]]s.

|-
| experiment_layering
| build_pcg_graphics()
| If true, use the layers for humanoid [[experiment]]s. Expects ``options.experiment_colors`` to be true.

|-
|
is_male_version
night_creature_strength_pref
night_creature_agile_pref
night_creature_strength_agile_pref
| night_troll_names
| Flags used by [[Night troll]]s.

|-
| no_default_werebeast_curse
| werebeast_origin_interactions.default()
| If this is true for a custom function in creatures.night_creature.werebeast, ``generate_from_list(werebeast_origin_interactions,tok,rcp.name_string,options)`` will not be able to use werebeast_origin_interactions.default. This allows [[mod]]s to better control access to [[werebeast]] curses.

|-
| amalgam_experiment
failed_experiment
| ''experiment_description()''
| Flags used for default [[experiment]]s.

|-
| experiment_name_type
| ''experiment_name_token''
| Array of nouns used instead of ``ropar.making_experiment`` for naming [[experiment]]s.

|-
| is_large
| ''make_failed_rcp()''
| Used for large failed [[experiment]]s. Capitalizes the creature tile.

|-
| eadj
fadj
| Custom names
| Temporary data storage for complex name generation.

|}

===RCP Parameters===

[[Category:Modding]]
[[Category:Lua|F]]

Path

2025-05-09T01:50:11Z

Putnam3145:

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

[[File:pathing_preview.png|right]]'''Pathing''' is a videogame concept that refers to the path the AI selected to route from point A to B. It has important implications for [[workshop design|fortress design]], [[security design]] and [[framerate]] management.

== Basic movement ==
Creatures can move in the four cardinal directions (north, south, east, and west), and four diagonal directions (northeast, southeast, southwest, northwest), as long as the target space is not blocked. This means creatures can path through diagonal gaps. For example, this rat (<tt>r</tt>) can reach the cheese (<tt>%</tt>):

<diagram>
r░
░%
</diagram>

Creatures can move directly up or down, as long as the target space is not blocked and the movement is possible (via flying, climbing, swimming, stairs, etc.). Creatures can move diagonally across Z-levels only when both lateral and vertical movement are simultaneously possible (e.g., when using a ramp), with one exception[http://www.bay12forums.com/smf/index.php?topic=144364.msg5705256#msg5705256] (see below). For example, this giant sparrow (<tt>S</tt>) can not attack the cat (<tt>c</tt>):

<diagram>
<frame type=level level=0>

S░░

This diagram has multiple z-levels! Press
< to go up one z-level.
</frame>

<frame type=level level=1>
░░░░
░ c░
░░░░

This diagram has multiple z-levels! Press
> to go down one z-level.
</frame>

<frame type=level level=2>

░░

This diagram has multiple z-levels! Press
> to go down one z-level.
</frame>
</diagram>

=== Exception for diagonal movement between Z levels ===

Diagonal movement between Z-levels is possible when the floor is missing from the space above the wall, which would otherwise block movement. Flying and swimming creatures can pass through the gap caused by the missing floor. Common causes for a missing floor include building an up-down or down stair (without the matching up staircase below it), or constructing a wall underneath tree branches.[http://www.bay12games.com/dwarves/mantisbt/view.php?id=7130#c26072] For example, this giant sparrow ''can'' attack the cat, because the down stairs (<tt>></tt>) on level 2 has removed the floor, creating a hidden gap:

<diagram>
<frame type=level level=0>

S░░

This diagram has multiple z-levels! Press
< to go up one z-level.
</frame>

<frame type=level level=1>
░░░░
░>c░
░░░░

This diagram has multiple z-levels! Press
> to go down one z-level.
</frame>

<frame type=level level=2>

░░

This diagram has multiple z-levels! Press
> to go down one z-level.
</frame>
</diagram>

== Path finding method ==
''Dwarf Fortress'' uses the [[wikipedia:A* search algorithm|A* search algorithm]] ([http://qiao.github.io/PathFinding.js/visual/ a nice demo]) ([http://www.gamasutra.com/view/feature/131954/interview_the_making_of_dwarf_.php?page=8 confirmation]), which quickly calculates the ideal path between points. Despite what this wiki has previously said, the heuristic used in Dwarf Fortress is admissible, and thus the ideal path is always found; whether your dwarf actually picks the right point B to go to is a different question.

Choosing the nearest raw materials uses the shortcut of checking the [[wikipedia:Manhattan distance|Manhattan distance]] from the [[dwarf]]'s current position, rather than an actual search. Thus, when constructing things, the valid materials list will be ordered from nearest to farthest; this, however, ignores any walls or obstacles in the way. An important part of fortress design is to be as open as possible, as more doorways will result in quicker paths (and thus better performance) as well as avoiding the hurdles of cross-map walks to find something the metric says is a short distance away. Workshops automatically path to the nearest valid raw materials; building things allows you to choose what to grab.

== Applications ==

For workshop jobs, the closest available valid material is used for the job. The simplest way to use pathing to your advantage is to surround a workshop with a stockpile accepting only specific raw materials that you want it to be using. While this is usually better handled by using linked stockpiles, it remains useful when trying to understand why, instead of decorating some beds in your furniture stockpile, your [[gem setter]] decides to fancify some commoners' [[coffin]]s in the next-door [[mason's workshop]].

The way pathing is handled should influence the way you design your fortress. An important part of fortress design is to be as closed as possible (again, the exact opposite of what the wiki has previously said), to reduce the amount of tiles searched overall; A*, in edge cases, will search every single tile on the map, so making sure there are simply fewer tiles will speed up the game in those edge cases. Those edge cases are, generally, the only place where pathfinding actually has any major effect on performance.

[[File:Pathing.jpg|thumb|right|300px|Applications of pathing (aka pathing abuse). Note that they do see every path, so if the green bottom bridge is raised, they will take the caravan entrance instead.]]
Implications in security design are a bit more thorough. Hostile creatures and dwarves running errands are able to consider the entire map when making pathing choices, and their A* pathfinding will mean that they will always take the shortest route, if there is a choice. This is a point separating trading [[caravan]]s, which path to your [[trade depot]], from [[goblin]] [[siege]]s, which look for the shortest path in instead. One clever exploit of this behavior is demonstrated at right; caravans will always take the winding, clean-top path, because that is where the trading post is, while incoming enemies will prefer the shorter, trapped bottom entrance.

===Doing the Calculation===
Each tile will have a value, this value is in some way based on how close it brings us to the item and that tile's [[traffic|traffic value]]. Thus the procedure is something like this:
# First, we check all the tiles next to the target and mark their values.
# From there, repeatedly check all accessible tiles from the target until we reach the dwarf.
# From the dwarf, pick recursively the tiles with the lowest value, and you have a path.
#Now the dwarf will follow this path to get to the target.

Things that are wandering (Animals, wandering invaders) may use a combination of the above method with some random movement. For jobs that require chasing a moving thing, this procedure may be done over and over, or a different algorithm may be used.

Additionally, the following variations have been suggested, but nothing is certain:
*Dwarves may remember paths that have worked before and try them before anything else.
*Inaccessible items may be invisibly considered forbidden for a certain amount of time after a dwarf discovers it is inaccessible, and therefore not considered in pathing.

===Optimizations===
To improve pathing speed and performance:
*Keep small stockpiles immediately next to workshops. This means Urist McCrafter doesn't have to do very much pathing to find his rocks (though it may cause Urist McHauler to do even more pathing).
*Keep Haulers near places where things will need to be moved from (excess stockpiles, mines, butcher's shops or other shops that have a high item yield).
*Make it easy to get in and out of the areas where workshops are.
*Staircases in rooms instead of in central areas should greatly improve pathing speeds.
*Applying traffic costs properly will greatly increase the speed of finding paths. Make corners of rooms higher cost and the center of major hallways and rooms with stockpiles and workshops lower cost. More on [[traffic]].

===Splitted One-way===
It's not possible to create areas path-able in one way only (though it was [[40d:One-way|in 0.28]], by exploiting a bug). However, it's possible to create a strong preference for pathing differently in different directions. A* algorithm in itself allows asymmetry, which suggests that bias in its priorities at least sometimes can be exploited to split traffic by direction. Consider this floor diagram:
{{diagram|spaces=yes|\
░░░░░░░░░░░░░░ ░░░░░░░░░░░░░░
░RR++++++++HH░ ░ →→→→→→→→→→ ░
++░░░░░░░░░░++ ↔┤░░░░░░░░░░├↔
░HH++++++++RR░ ░ ←←←←←←←←←← ░
░░░░░░░░░░░░░░ ░░░░░░░░░░░░░░

░ : wall
+ : floor - normal traffic
H : floor - High traffic
R : floor - Restricted traffic
}}
If this fragment is set up between a closed cave and outside, dwarves will always choose to pass through it via the left corridor, even if that corridor is farther both from the dwarf's original location and destination. Since A* is "best-first", i.e. strongly prioritizes lower path cost in the immediate vicinity, we may guess that DF calculates path ''from'' the destination to the creature. (This seems more efficient if creatures more often need to path from open space ''into'' a dead-end or maze than vice versa, or the destination is cut off from open space more often than the creature.)

This isn't foolproof (e.g. pets ignore traffic designations and dorfs don't path ''through'' it from end to end when picking up something ''within'' it), or even too useful in itself (you need alternate paths to be very close - enough that the immediate traffic cost matters much more than difference in distance), but it does allow to e.g. make assumptions as to whether a dwarf arrives or leaves for [[pressure plate]] automation purpose, without forcing path retries (and attendant CPU load) inherent in "suddenly closed door"/"suddenly opened hatch" technique (even if you need a strict one-way, these methods can be combined, to make path retry an exception rather than rule).

The longer the space between entrance and exit (left and right in the diagram) of the two one-way-floors, the more likely dwarves will stick to the desired side even obstacles like animals and dwarves are in their way. Of course, there will be fewer actual collisions than predicted if everyone moves in the same direction.

'''Warning:''' Using Restricted traffic on floors dwarves have to pass — like the entrance of a fortress - leads to high pathing costs (and thus potentially FPS drop) because of searching for alternative routes!{{verify}}

If you want to use this, keep those (path-through) restricted areas as small as possible. On the other side, the higher the restricted costs, the more likely dwarves stick to the correct site. The same is true for longer tunnels. And the longer the tunnel, the less additional pathing will be done. If the tunnel is at least as long as the costs of the restricted area, you don't have to bother additional costs. So, this should only be used for long tunnels. Never use it to control traffic inside your fort between rooms unless you restrict most of your fort's area!

==Other dwarves==
It is possible for entities such as dwarves to walk over each other when necessary. However, moving over occupied tiles in this manner is much slower, and dwarves will try to path so that they can avoid it. This introduces an important consideration to fortress design.

If you have a long, 1-tile wide corridor which already has a dwarf moving through it, other dwarves who need to get from one side of the corridor to the other will try to avoid colliding with that dwarf, by pathing elsewhere. If it so happens that the corridor is long, and there are no nearby alternative routes, this may cause a very significant increase in pathfinding burden.

For this reason, it's best to make high-traffic routes at least 2 tiles wide, and avoid single doors and single stairs. This ensures that when a dwarf tries to find a detour around another dwarf in his way, he will be able to do so easily and without modifying his current path much.

{{Translation
| dwarven = nimar
| elvish = alí
| goblin = snust
| human = anur
}}

{{Category|Game mechanics}}
[[ru:Path]]

Siege

2025-04-20T21:20:58Z

Putnam3145: /* Elven sieges */

{{Quality|Exceptional}}
{{av}}
[[File:df_goblin_siege.png|thumb|220px|right|Brutal battle during a small siege.]]
{{Translation
| dwarven = zokun
| elvish = thima
| goblin = etosp
| human = rislu}}
:''For catapults and ballistae, see [[Siege engine]].''
'''Sieges''' are large-scale assaults on your fortress by other [[civilization]]s, and a step beyond [[ambush]]es. Sieges are drawn from moving units advancing towards the fortress, whether from an army, a bandit group, or a necromancer's [[Tower (necromancy)|tower]]. They are announced with a full-screen message that differs depending on the attacking race, and the main screen showing the {{DFtext|SIEGE|6:4:1}} tag at the top for the duration of the siege. In the premium version, it looks like this: 
[[File:siege_icon.png]] 

A siege's objective is to exterminate every [[dwarf]] in your fortress, or die trying. It is possible to be sieged by all civilized races, with the exception of [[kobold]]s and subterranean [[animal people]]; these two never go beyond ambushes. Enemy civilizations will begin to send sieges against your fortress once its [[population]] reaches 80 members, with the exception of the undead, who may attack at any time.

[[Caravan]]s will not arrive at an already-besieged fortress, but will, unfortunately, arrive if a siege is not broken quickly enough - it is possible to miss out entirely on a civilization's caravan for the year this way. Even if they do arrive before the siege, the attackers may kill them or chase them off if they can reach them. '''Consider this when deciding how you set up your [[trade depot]] and how heavily reliant your economy is on imported goods.'''

A civilization will be unable to lay siege if it can't ''reach'' your fortress site, that is, armies need to physically move to the location of your fortress; they are normally allowed a 30-tile radius of interaction (towers have 10 tiles), beyond which sieges are impossible. Specifically, you will never get sieges if you embark on an [[island]], or in a valley which is completely surrounded by [[mountain]]s. If you want to make sure that a certain civilization will be capable of laying siege to you, then look at the "neighbors" view of the embark site finder when selecting your fortress site.

== Structure of a siege ==
*Siege forces usually consist of several "squads". Using the [[goblin]]s as an example, each squad consists of several goblins of one military class (swordsman, lasher, etc.), and often one "squad leader" (typically an Elite or better, which need not be the same class as the squad being led).
*Occasionally, a squad will be mounted – this means each of its members will be riding a suitable [[creature]], though the creatures typically vary between members. The squad leader can be mounted even if their squad is not. These mounts can change the combat dynamics, since some can fly, are [[building destroyer]]s, or have substantially different combat traits from their riders. For more info on mounted units, and the [[fun]] they can unleash upon an ill-prepared defender, see: [[Mount]].
*Invaders can climb [[wall]]s and pits. This can be quite [[fun]] if your fort defense relies on the same kinds of walls and pits as previous versions.
*In the pause menu, your retiring option will change from "retire your fortress" to "succumb to the invasion". Choosing this option will lead to the siege succeeding and the dwarves being killed.
*After being sufficiently "successful" at defending against the siege (killing sufficient attackers, waiting them out, or some combination thereof), the attackers will retreat. All of the remaining squads and groups will head for the map edges and leave, typically favoring the edge they entered from. Once all of the remaining attackers have decided to retreat, the {{DFtext|SIEGE|6:4:1}} tag will go away.
*It is possible to have multiple sieges at the same time. If the attacking civilizations are at war with each other, they will start to fight with each other as well.
*You can turn off sieges and [[megabeast]]s altogether by changing "civilizations can attack" and "megabeasts can attack" to NO in the difficulty settings.
*Depending on how your fortress is set up, [[winter]] can be the worst time for a siege due to any outside water being frozen. If your fortress is surrounded by a moat, or is meant to be blocked off by water in some way, your enemies will simply walk over the [[ice]] and climb over any walls into your fortress.

===Difficulty===
On normal [[difficulty]], the intensity of enemy attacks directly corresponds to your [[fortress]]'s title. Once sieges are possible, 25% of invasions will be sieges instead of [[Ambush|ambushes]].

On hard difficulty, the trigger conditions for enemies are roughly halved, allowing more invaders to attack earlier. The frequency of sieges instead of ambush increases to 50%.

By default, a max of 120 soldiers and 40 monsters can attack your fortress during a siege. This number can be adjusted in the [[difficulty]] settings.

{| style="margin: 1em auto; border-spacing: 0;"
|- style="vertical-align: top; padding: 0 1em"
|
{| class=wikitable
|+ Normal enemies
! colspan='2' | Fortress Title
! Pop
! Created Wealth
! Exported Wealth
! Invaders

|- style='background-color:#eee'
| style='background-color:#000; padding:2px 6px' | {{Raw Tile|Ω|#555|#000}}
| '''Outpost'''
| style='text-align:right' | -
| -
| -
| None

|- style='background-color:#ddd'
| style='background-color:#000;' | {{Raw Tile|Ω|#777|#000}}
| '''Hamlet'''
| style='text-align:right' | 20
| 5,000☼
| 500☼
| Ambush only

|- style='background-color:#eee'
| style='background-color:#000;' | {{Raw Tile|Ω|#999|#000}}
| '''Village'''
| style='text-align:right' | 50
| 25,000☼
| 2,500☼
| " "

|- style='background-color:#ddd'
| style='background-color:#000;' | {{Raw Tile|Ω|#bbb|#000}}
| '''Town'''
| style='text-align:right' | 80
| 100,000☼
| 10,000☼
| Sieges (10 regulars)

|- style='background-color:#eee'
| style='background-color:#000;' | {{Raw Tile|Ω|#ddd|#000}}
| '''City'''
| style='text-align:right' | 110
| 200,000☼
| 20,000☼
| Sieges (40 regulars, 5 monsters)

|- style='background-color:#ddd'
| style='background-color:#000;| {{Raw Tile|Ω|#fff|#000}}
| '''Metropolis'''
| style='text-align:right' | 140
| 300,000☼
| 30,000☼
| Sieges (120 regulars, 40 monsters)
|}
|
{| class=wikitable
|+ Hard enemies
! Pop
! Created Wealth
! Exported Wealth
! Invaders

|- style='background-color:#eee'
| style='text-align:right' | -
| -
| -
| None

|- style='background-color:#ddd'
| style='text-align:right' | 15
| 2,500☼
| 250☼
| Ambush only

|- style='background-color:#eee'
| style='text-align:right' | 30
| 12,500☼
| 1,250☼
| " "

|- style='background-color:#ddd'
| style='text-align:right' | 40
| 50,000☼
| 5,000☼
| Sieges (20 regulars, 1 monster)

|- style='background-color:#eee'
| style='text-align:right' | 55
| 100,000☼
| 10,000☼
| Sieges (60 regulars, 10 monsters)

|- style='background-color:#ddd'
| style='text-align:right' | 70
| 150,000☼
| 15,000☼
| Sieges (120 regulars, 40 monsters)
|}
|}

== [[Goblin]] sieges ==
[[File:The last stand by ncorva.jpg|thumb|250px|We hear the drums, they are coming... ''Art by ncorva'']]
{{dftext|A vile force of darkness has arrived!|5:1}}

Usually, the tactics used by the goblins are no more sophisticated than charging in an open march toward your fortress, and attempting to kill your dwarves. Goblin sieges often include groups of [[troll]]s and [[beak dog]]s, but may also include things like [[ogre]]s, or [[cave dragon]]s (along with some other "Subterranean" and evil "Fantasy" creatures), that can [[Building destroyer|break buildings]] and smash workshops. Unlike the squads, however, these "groups" usually enter the map in a single tile, somewhat akin to arriving [[migrants]]. These war creatures usually possess random civilian classes, and show little of the organized behavior of the squads. Goblins may also bring fighters belonging to other races (previously kidnapped as children by [[snatcher]]s), and if you're really lucky, they may be commanded by something particularly [[Demon|fun]]. Goblin sieges usually involve [[mount]]ed squads, some of which can fly over whatever defenses you might have set up to stop them.

Interestingly, the goblin civilization lacks the {{token|SIEGER|e}} token, while large-scale attacks by them nevertheless activate the {{DFtext|SIEGE|6:4:1}} state. This suggests that the token doesn't regulate the overall ability to send out sieging forces, but merely enables large attacking forces to set up camp and try to wait out a fort – the behavior often seen in human sieges – instead of charging in blindly like a pack of fools. Goblins are also the only race who can siege your fortress without their civilization being explicitly at [[war]] with your own, presumably because their evil nature makes them disregard diplomacy entirely.

== [[Elf|Elven]] sieges ==
{{dftext|An ambush! Curse all friends of nature!|4:1}}

It is possible to have elven attacks as well, but that usually requires some effort on the part of the player, or for your starting civilization to have a pre-existing conflict with a nearby elven one - you can check this when you embark while looking at nearby civilizations, where it will read {{DFtext|WAR|4:1}} next to the elf civilization, though it seems to be entirely dependent on how world gen plays out, and embarking at a time when a war is happening. Another, possibly simpler (and more amusing) way to elven siege is to blatantly provoke them. If you don't want to be attacked by elves you should not offer them wooden goods or goods stored in wooden barrels or bins. You might also avoid clearing too much woodland, as elves will be offended if you do so. Unless you want to be attacked by them, don't send squads to [[Mission|raid]] their sites in the civilization screen.

Elves ambush using stealth squads rather than siege, to hide their numbers and locations. It should be noted, however, that unlike goblin ambushes which cap at four squads, elves can come in '''massive''' numbers, atop mighty (and [[Butcher|tasty]]) [[unicorn]]s or other [[elephant|exotic beasts]] (like unaligned/mundane/giant animals, and good-aligned creatures). Fortunately, unlike goblins and humans, who wear heavy armor and wield [[metal]] weapons that can cause considerable damage, the elves are very weak in battle - their weapons and arrows are made of [[wood]], which will simply bounce off any standard metal armor, and they march into battle wearing easily breakable wooden armor, or even nothing but [[cloth]] robes and trousers.

== [[Human]] sieges ==
[[File:human_siege_preview.png|thumb|250px|right|Being taller helps with war-related things. ''Art by by John Gilbert (1817 - 1897 CE)'']]
{{dftext|The enemy have come and are laying siege to the fortress.|5:1}}

Humans may also siege you if you let their [[diplomat]] die while visiting your fortress; if too many of their trade wagons get destroyed, if you trade with an elven nation the humans are at war with, or if you raid their sites. Humans sometimes set up a camp near the map edge they arrived on, harassing wandering dwarves and waiting for you to come to them instead of blindly charging toward your fortress.

Humans often ride mundane animals, such as [[horse]]s, [[camel]]s (of both varieties), or war [[grizzly bear]]s, and may bring along further war animals like trained [[cheetah]]s, or even [[elephant]]s. Be aware that human siegers know about all [[trap]]s that their diplomats have seen before; even their war animals are immune to those traps. If you have had a human diplomat in your fort, assume that your traps are useless against the invaders unless they were built after their last visit. A removed and rebuilt trap counts as "new", even if it's the same type of trap in the same tile.

== [[Necromancer]] sieges ==
{{dftext|The dead walk. Hide while you still can!|5:1}} 
{{dftext|Forms twisted from their nature, legion of the night. What hope remains?|5:1}}

Necromancers will only be able to siege you if you embark in an area near a [[Tower (necromancy)|tower]]. If no tower is present in the neighbors list, no necromancers will ever besiege your fortress unless you attack them first.

Necromancers will besiege your fortress by sending [[undead]] to your fort or even coming themselves. Either way, undead sieges are a guaranteed source of [[Fun]]. The undead units will arrive from all sides of the map, slowly meandering towards your fortress. Undead sieges may arrive with as few as one zombie to as many as fifty or more—and if a necromancer is present with them, anyone that dies in or near battle (or lying somewhere near it) is likely to be revived as a new zombie, complete with all the skills, attributes, and equipment it had in life. The undead in general are serious enemies, that one cannot treat like goblin garbage. A legendary squad can take down unarmed zombies in equal numbers, but the large numbers that necromancers can bring are unmatchable. To make things worse, "elite" zombie fighters may carry ''weapons and armor'', a truly terrifying thought were there ever one.

While normally human, goblin and elven invaders usually do not have access to [[steel]] (with elves not using metal weapons/armour at all), if the original necromancer of the group (the one who was given the slab during worldgen) was a dwarf, it is not uncommon for the undead invaders to use steel. Yes, that means being invaded by steel-clad elven zombies with steel swords, for example.

It is recommended that you have <s>many traps</s> every single trap with the best available materials you could possibly build set in advance, and when the undead legions arrive, '''shut down everything'''. Be sure to shut down all of your [[butcher's shop]]s, crypts, and [[refuse]] [[stockpile]]s, as necromancers can reanimate armies of body parts to destroy your fortress from the inside. Be also careful with [[fishery]] workshops, as reports of [[mussel]] [[shell]]s rising from the dead are fairly common. Necromancers will raise any [[corpse]] or corpse part that they see, and simple proximity to undead can cause things like [[skin]] and [[hair]] to rise and attack the unfortunate butcher. It doesn't really matter how many zombies arrive; if you are not prepared, you will probably get slaughtered, as one zombie can easily become two zombies, then four, then eight and so on. If the zombies cannot attack your dwarves immediately, they will simply mill about on the surface until something living (wild animals included) comes too close or until they are all destroyed. Like other sieges, it is also possible to wait out necromancer sieges, though this can take a year or more. When fighting zombies that used to be your own dwarves, be sure not to let anyone who knew that dwarf fight them—it generates a strong negative [[thought]] on top of the reduction to sanity caused by fighting the living dead. Use [[Attack type|blunt]] weapons whenever possible—a mangled corpse is one that will stay dead, and with no functioning organs to damage, the only other way to stop them is through decapitation or bisection.

Undead sieges can attack your fortress at any time, including before the second spring's elven caravan arrives, or even before the first dwarven caravan arrives in the fall of your first year (thus preventing its arrival). The number of undead sent will depend on your wealth and population, and early sieges tend to have as few as three undead—but can cause very much cheesy [[fun]] if a lone necromancer accompanies them (which isn't uncommon).

(If [[experiment]]s are brought along, the latter message will be shown. Sometimes these "sieges" of experiments will be very small, consisting of only a few experiments and no necromancer.)

== [[Dwarf|Dwarven]] sieges ==
{{dftext|The enemy have come and are laying siege to the fortress.|5:1}}

Dwarves of a different entity from yours will normally not interact with your fortress. However, should the player [[Mission|raid]] the sites of another dwarven civilization, or refuse to give a petitioned [[legendary artifact]] if requested, the other dwarves may declare war on yours, leading to dwarven sieges. It isn't possible to be attacked by dwarves of your own entity.

Dwarves employ tactics similar to those of humans during sieges, and employ war beasts and cavalry equivalent to their own or to those used by goblins, as they have access both to above-ground and subterranean resources. Enemy dwarves can be particularly [[fun]] to face due to them possessing access to everything the player has, including the likes of steel equipment, and due to being able to enter [[martial trance]]s much like your own dwarves.

== [[Bandit]] sieges ==
Roving bandit groups near by your fortress may also besiege it, happening potentially as early as ''the first year'', making them an excellent source of surprise [[fun]].

Bandit groups are drawn from any entity with the {{token|BANDITRY|e}} and {{token|LOCAL_BANDITRY|e}} tokens. In unmodded games, these are [[goblin]]s, [[human]]s and [[kobold]]s, though other races (even [[dwarves]]) have been reported. Their announcement messages are the same as the messages for regular sieges of their race. Bandit sieges are generally smaller than a later-game full-blown siege, more similar in size to goblin [[ambush]]es, as there are fewer units from which to draw combatants. Bandits tend to be poorly equipped and skilled, some being recruits with no weapons or armour (''as would be expected of such matters of war'').

== Bugs ==
* Amphibian invader mounts drown their riders. {{Bug|926}}
* Occasionally sieges will not end with all invaders being dealt with. In such cases the siege seems to end after several months by itself. {{Bug|10075}}

{{Military}}
{{category|Fortress mode}}
[[ru:Siege]]

Lua scripting

2025-02-27T01:50:45Z

Putnam3145:

{{Template:Under_construction}}
{{Modding}}

''This article is about procedural raw generation. Information on [[Utility:DFHack]] scripting can be found at https://docs.dfhack.org/en/stable/.''

[https://www.lua.org/ Lua] scripting is an experimental feature{{version|51.06}}. It is used to create custom procedurally-generated objects that were previously created by hardcoded methods. It was announced in a [https://www.youtube.com/watch?v=Z9rzhFwgfUk video], with the stated goal of "supporting future [[Magic|magical]] endeavors."

Inorganic [[Material definition token|materials]], [[Language token|languages]], [[Creature token|creatures]], [[Interaction token|interactions]], [[Item token|items]] (currently excluding instruments), [[reaction]]s, [[Entity token|entities]], and [[Plant token|plants]] are open to this system.

Scripts are loaded from a mod's ``scripts/init.lua`` file, as well as from any included files.

==Structure==

As of right now, Lua scripting is confined to generation of procedural objects. This is done by running the ``generate`` function, a global function loaded in ``'''data/init/generators.lua'''``. It runs unit tests, preprocess, materials, items, languages, creatures, interactions, entities and postprocessing, in that order.

When random objects are first generated, the game populates two global tables, ``world`` and ``random_object_parameters``. ``world`` contains info about the world currently being generated (or, in the future, played in), while ``random_object_parameters`` contains what the game expects to be generated. The most important thing between these is ``random_object_parameters.main_world_randoms``, which is ``true`` for exactly one generation at the start of worldgen; it's what you want to check for if you're generating your own objects

You can set the global ``debug_level`` variable to print some debug info. It's a number, but what numbers are there are completely arbitrary. If it's >0, it'll run unit tests; if it's >=0.5, it'll display what step of generation it's at, at every step. You can use ``get_debug_logger(x)`` to return a function that logs to ``lualog.txt`` if the debug level is at least ``x``.

Unit tests are functions that return a table, containing ``good``, which, if truthy, is considered passed, and ``info``, which is a string that contains information on said pass or fail. These unit tests should have no side effects, i.e. they shouldn't muck with global state any. Here's an example unit test, one that was used during development (but had no reason to be removed):

{{Scriptdata
|title=get_random_creature
|script=
get_random_creature=function()
local cr=world.creature.get_random_creature()
local res={}
res.good=type(cr)=='table'
res.info=res.good and ("Got a random creature: "..cr.token) or "No random creature could be gotten, even at most permissive!"
return res
end}}

``preprocess`` is just a table of functions. It runs each function, one at a time. This is where you want your side effects, and, if you're adding an entirely new procedural object type, that's what you probably want. You should also use it if you want to mess around with ``random_object_parameters``, which is allowed (it's how demon types are assigned in vanilla, and you can change the proportions as an end user if you want). The "adamantine alloys" example below is an example of what can be done with preprocess (and postprocess, which is mostly identical except it happens after the rest of generation).

The game then generates all of the individual objects; the general procedure for this is that the game calls the ``generate_from_list`` function on a table of functions, which calls every function and picks one of the resulting tables at random depending on their weights. For example, the ``interactions.secrets`` table contains one entry, that for necromancers; it returns a table containing three entries: ``{interaction=tbl,weight=1,spheres=spheres}``. ``interaction`` is the full raw text of the interaction; ``weight`` is the random weight for the interaction, i.e. if you add another one which returns a table containing ``weight=2``, that will be twice as likely as necromancers. ``spheres=spheres`` is some extra data the generator might be able to use. It actually doesn't, at this point, but one could override ``generate_random_interactions`` with their own version that takes into account ``spheres`` and, say, tries to evenly distribute generated secrets over available spheres. (This didn't end up in vanilla primarily out of concerns of bug-like behavior cropping up).

Languages are special, though; as can be seen below, the ``languages`` table just expects a table containing translations, e.g. ``tbl["ABBEY"]="abbey"``. If you want to procedurally add words or symbols (and yes, these are both doable), you can use preprocess or postprocess.

==Creatures==
Creatures have a lot more to them than other procedural objects. Forgotten beasts are, in a sense, the simplest of them:

{{Scriptdata
|title=creatures.fb.default
|script=
creatures.fb.default=function(layer_type,tok)
local tbl={}
local options={
strong_attack_tweak=true,
spheres={CAVERNS=true},
is_evil=true,
sickness_name="beast sickness",
token=tok
}
tbl=split_to_lines(tbl,[[
[FEATURE_BEAST]
[ATTACK_TRIGGER:0:0:2]
[NAME:forgotten beast:forgotten beasts:forgotten beast]
[CASTE_NAME:forgotten beast:forgotten beasts:forgotten beast]
[NO_GENDER]
[CARNIVORE]
[DIFFICULTY:10]

[NATURAL_SKILL:WRESTLING:6]
[NATURAL_SKILL:BITE:6]
[NATURAL_SKILL:GRASP_STRIKE:6]
[NATURAL_SKILL:STANCE_STRIKE:6]
[NATURAL_SKILL:MELEE_COMBAT:6]
[NATURAL_SKILL:DODGING:6]
[NATURAL_SKILL:SITUATIONAL_AWARENESS:6]
[LARGE_PREDATOR]
]])
add_regular_tokens(tbl,options)
tbl[#tbl+1]=layer_type==0 and "[BIOME:SUBTERRANEAN_WATER]" or "[BIOME:SUBTERRANEAN_CHASM]"
if layer_type==0 then options.spheres.WATER=true end
options.spheres[pick_random(evil_spheres)]=true
options.do_water=layer_type==0
populate_sphere_info(tbl,options)
local rcp=get_random_creature_profile(options)
add_body_size(tbl,math.max(10000000,rcp.min_size),options)
tbl[#tbl+1]="[CREATURE_TILE:"..tile_string(rcp.tile).."]"
build_procgen_creature(rcp,tbl,options)
return {creature=tbl,weight=1}
end}}

This is a lot of info! First, you build an ``options`` table; it's possible to make a full list of options used in vanilla, but other mods can also use arbitrary options. It then adds all the usual special-to-forgotten-beast tokens, in a big string, followed by calling ``add_regular_tokens(tbl,options)``, which adds some stuff common to all (vanilla) procedural creatures, based on the options given. It sets ``do_water`` and the WATER sphere if the FB is in a water cavern, an option which whitelists certain random creature profiles, as well as adding a random evil sphere. ``populate_sphere_info`` is similar to ``add_regular_tokens``; it adds all of the spheres in ``options.spheres`` to the creature, using the SPHERE token, then, if certain options are set, does more. Then, it gets a random creature profile using ``get_random_creature_profile`` and the options, uses ``add_body_size`` to set the BODY_SIZE tokens and attendant things that come with it, sets the creature tile, and finally runs the Big Function, ``build_procgen_creature``, which creates the description, body, tissues, et cetera.

===Random Creature Profiles===
A random creature profile is a type of "thing" a generated creature can be. For example:

{{Scriptdata
|title=random_creature_types.GENERAL_QUADRUPED
|script=
GENERAL_QUADRUPED={
name_string="quadruped",
tile='Q',
body_base="QUADRUPED",
c_class="UNIFORM",
cannot_have_get_more_legs=true,
min_size=70000,
weight=1000
},
}}

Of these, only ``cannot_have_get_more_legs`` is optional. ``build_procgen_creature`` has direct access to the RCP, as the first argument, and thus extra table entries can be used however you like.

===Other stuff===
TODO: Tweaks, random creature materials, random creature classes, color pickers, function that ``build_procgen_creature`` calls in the process of building that can be used to inject your own logic into creature building (e.g. ``btc1_tweaks``), etc.

==Code Samples==

===Divine language===
This is the [[divine language]], which generates a bunch of random-sounding words from a set of syllables.


{{Main:Divine language/script}}

===Identity language===
This makes a [[Language token|language]] called ``GEN_IDENTITY`` which is like: "Abbey abbeyabbeys the abbey of abbeys" - i.e. it's the "English" language you might see occasionally.

{{Scriptdata
|title=GEN_IDENTITY
|script=
languages.GEN_IDENTITY=function()
-- just to demonstrate the absolute most basic method of generating one of these
-- also so that you can just mod stuff to use GEN_IDENTITY
local tbl={}
local unempty = function(str1, str2)
return str1=='' and str2 or str1
end
for k,v in ipairs(world.language.word) do
local str=''
str=unempty(str,v.NOUN_SING)
str=unempty(str,v.ADJ)
str=unempty(str,v.VERB_FIRST_PRES)
str=unempty(str,string.lower(v.token))
tbl[v.token]=str
end
return tbl
end}}

===New divine metal===
You can add new metal descriptions for divine metal pretty easily, for example:

{{Scriptdata
|title=Laughing metal
|script=
metal_by_sphere.CHILDREN={
name="laughing metal",
col="7:0:1",
color="WHITE"
}
}}

===New forgotten beast===
Add a new kind of forgotten beast.

{{Scriptdata
|title=Unbidden spirit
|script=
creatures.fb.unbidden=function(layer_type,tok)
if layer_type==0 then return nil end -- land only
local tbl={}
local options={
strong_attack_tweak=true,
always_make_uniform=true,
always_insubstantial=true,
intangible_flier=true,
spheres={CAVERNS=true},
is_evil=true,
sickness_name="beast sickness",
token=tok
}
tbl=split_to_lines(tbl,[[
[FEATURE_BEAST]
[ATTACK_TRIGGER:0:0:2]
[NAME:unbidden spirit:unbidden spirit:unbidden spirit]
[CASTE_NAME:unbidden spirit:unbidden spirit:unbidden spirit]
[NO_GENDER]
[CARNIVORE]
[DIFFICULTY:10]

[NATURAL_SKILL:WRESTLING:6]
[NATURAL_SKILL:BITE:6]
[NATURAL_SKILL:GRASP_STRIKE:6]
[NATURAL_SKILL:STANCE_STRIKE:6]
[NATURAL_SKILL:MELEE_COMBAT:6]
[NATURAL_SKILL:DODGING:6]
[NATURAL_SKILL:SITUATIONAL_AWARENESS:6]
[LARGE_PREDATOR]
]])
add_regular_tokens(tbl,options)
tbl[#tbl+1]=layer_type==0 and "[BIOME:SUBTERRANEAN_WATER]" or "[BIOME:SUBTERRANEAN_CHASM]"
if layer_type==0 then options.spheres.WATER=true end
options.spheres[pick_random(evil_spheres)]=true
options.do_water=layer_type==0
populate_sphere_info(tbl,options)
local rcp=get_random_creature_profile(options)
add_body_size(tbl,math.max(10000000,rcp.min_size),options)
tbl[#tbl+1]="[CREATURE_TILE:"..tile_string(rcp.tile).."]"
build_procgen_creature(rcp,tbl,options)
-- Weight is a float; all vanilla objects have weight 1
return {creature=tbl,weight=0.5}
end
}}

===Remove default forgotten beast===

<syntaxhighlight lang="lua" >
creatures.fb.default=nil
</syntaxhighlight>

===Adamantine alloys===

You can add your own arbitrary generated objects, though as of right now there's no way to make settings for them. This allows for some ''truly'' wild stuff; here's a fun example: adamantine-metal alloys for every single non-special metal, giving you an average of the properties of them.

{{Scriptdata
|title=Adamantine alloys
|script=
preprocess.adamantine_alloys=function()
if not random_object_parameters.main_world_randoms then return end
local l=get_debug_logger(2)
local lines={}
local reaction_lines={}
local reaction_names={}
local adamantine=world.inorganic.inorganic.ADAMANTINE
if not adamantine then return end
local adamantine_color=world.descriptor.color[world.descriptor.color_pattern[adamantine.material.color_pattern.SOLID].color[1]]
local adamantine_modulus = 2500000 --mildly arbitrary, just below the theoretical limit
l("Starting")
local done_category=false
for k,v in ipairs(world.inorganic.inorganic) do
if not v.flags.SPECIAL and v.material.flags.IS_METAL then
l(v.token)
local token="GEN_ADAMANTINE_"..v.token
lines[#lines+1]="[INORGANIC:"..token.."]"
add_generated_info(lines)
lines[#lines+1]="[USE_MATERIAL_TEMPLATE:METAL_TEMPLATE]"
for kk,vv in pairs(v.material.adj) do
lines[#lines+1]="[STATE_ADJ:"..kk..":adamantine "..vv.."]" --"adamantine molten steel"? it's fine
end
for kk,vv in pairs(v.material.name) do
lines[#lines+1]="[STATE_NAME:"..kk..":adamantine "..vv.."]"
end
l(2)
local mat_values={}
-- Find the ratio for which you get closest to (but not below) 2000000 in the material's worst property
local worst=math.min(v.material.yield.IMPACT,v.material.fracture.SHEAR)
local wafers=1
local bars=1
if worst < 2000000 then
local ratio = (2000000-3*worst)/1000000
local best_diff=1
for i=1,10 do
local wafer_amt=i*ratio
if wafer_amt>1 and wafer_amt<20 and math.ceil(wafer_amt)-wafer_amt<best_diff then
best_diff=math.ceil(wafer_amt)-wafer_amt
wafers=math.ceil(wafer_amt)
bars=i
end
end
end
local avg_denom=1/(bars*3+wafers) -- Multiplication just a bit faster than division, we're rounding at the end anyway
local solid_cl=nil
for kk,vv in pairs(v.material.color_pattern) do
-- time to get silly
local this_color=world.descriptor.color[world.descriptor.color_pattern[vv].color[1]]
local wanted_color={
r=(this_color.r*bars*3+adamantine_color.r*wafers)*avg_denom,
g=(this_color.g*bars*3+adamantine_color.g*wafers)*avg_denom,
b=(this_color.b*bars*3+adamantine_color.b*wafers)*avg_denom,
}
local best_total_diff=1000000000
local best_clp=nil
for _,clp in ipairs(world.descriptor.color_pattern) do
if clp.pattern=="MONOTONE" then
local cl=world.descriptor.color[clp.color[1]]
local diff=math.abs(wanted_color.r-cl.r)+math.abs(wanted_color.b-cl.b)+math.abs(wanted_color.g-cl.g)
if diff<best_total_diff then
best_clp=clp
best_total_diff=diff
end
end
end
lines[#lines+1]="[STATE_COLOR:"..kk..":"..best_clp.token.."]"
if kk=="SOLID" then solid_cl=world.descriptor.color[best_clp.color[1]] end
end
local color_str=solid_cl.col_f..":0:"..solid_cl.col_br
l(color_str)
lines[#lines+1]="[DISPLAY_COLOR:"..color_str.."]"
lines[#lines+1]="[BUILD_COLOR:"..color_str.."]"
lines[#lines+1]="[ITEMS_METAL][ITEMS_HARD][ITEMS_SCALED][ITEMS_BARRED]"
lines[#lines+1]="[SPECIAL]"
if v.material.flags.ITEMS_DIGGER then
lines[#lines+1]="[ITEMS_DIGGER]"
end
local function new_value(str)
mat_values[str]=mat_values[str] or math.floor((adamantine.material[str]*wafers+v.material[str]*bars*3)*avg_denom+0.5)
l(str,mat_values[str])
return mat_values[str]
end
local function new_value_nested(str1,str2)
mat_values[str1..str2]=mat_values[str1..str2] or math.floor((adamantine.material[str1][str2]*wafers+v.material[str1][str2]*bars*3)/(bars*3+wafers)+0.5)
l(str1..str2,mat_values[str1..str2])
return mat_values[str1..str2]
end
if new_value_nested("fracture","SHEAR")>170000 or new_value_nested("yield","IMPACT")>245000 then
lines[#lines+1]="[ITEMS_WEAPON][ITEMS_AMMO]"
if new_value("solid_density")<10000 then
lines[#lines+1]="[ITEMS_WEAPON_RANGED][ITEMS_ARMOR]"
end
end
lines[#lines+1]="[MATERIAL_VALUE:"..new_value("base_value").."]"
lines[#lines+1]="[SPEC_HEAT:"..new_value("temp_spec_heat").."]"
lines[#lines+1]="[MELTING_POINT:"..new_value("temp_melting_point").."]"
lines[#lines+1]="[BOILING_POINT:"..new_value("temp_boiling_point").."]"
lines[#lines+1]="[SOLID_DENSITY:"..new_value("solid_density").."]"
lines[#lines+1]="[LIQUID_DENSITY:"..new_value("liquid_density").."]"
lines[#lines+1]="[MOLAR_MASS:"..new_value("molar_mass").."]" -- i don't think this is actually correct
for _,thing in ipairs({"yield","fracture"}) do
for force,_ in pairs(v.material[thing]) do
lines[#lines+1]="["..string.upper(force).."_"..string.upper(thing)..":"..new_value_nested(thing,force).."]"
end
end
for _,force in ipairs("IMPACT","COMPRESSIVE","TENSILE","TORSION","SHEAR","BENDING") do
local modulus = v.yield[force] / v.elasticity[force]
local average_modulus = (adamantine_modulus*wafers + modulus*bars*3)*avg_denom
local strain_at_yield = math.floor(new_value_nested("yield",force) / average_modulus + 0.5) -- usually zero, but can be 1 or 2 sometimes
lines[#lines+1]="["..string.upper(force).."_YIELD:"..new_value_nested("yield",force).."]"
lines[#lines+1]="["..string.upper(force).."_FRACTURE:"..new_value_nested("fracture",force).."]"
lines[#lines+1]="["..string.upper(force).."_STRAIN_AT_YIELD:"..strain_at_yield.."]"
end
lines[#lines+1]="[MAX_EDGE:"..new_value("max_edge").."]"
local reaction_token=token.."_MAKING"
reaction_lines[#reaction_lines+1]="[REACTION:"..reaction_token.."]"
add_generated_info(reaction_lines)
reaction_lines[#reaction_lines+1]="[NAME:make adamantine "..v.material.name.SOLID.." (use bars)]"
reaction_lines[#reaction_lines+1]="[BUILDING:SMELTER:NONE]"
reaction_lines[#reaction_lines+1]="[REAGENT:A:"..tostring(150*wafers)..":BAR:NO_SUBTYPE:METAL:ADAMANTINE]"
reaction_lines[#reaction_lines+1]="[REAGENT:B:"..tostring(150*bars)..":BAR:NO_SUBTYPE:METAL:"..v.token.."]"
reaction_lines[#reaction_lines+1]="[PRODUCT:100:"..tostring(bars+wafers)..":BAR:NO_SUBTYPE:METAL:"..token.."][PRODUCT_DIMENSION:150]"
reaction_lines[#reaction_lines+1]="[FORTRESS_MODE_ENABLED]"
reaction_lines[#reaction_lines+1]="[CATEGORY:ADAMANTINE_ALLOYS]"
if not done_category then
done_category=true
reaction_lines[#reaction_lines+1]="[CATEGORY_NAME:Adamantine alloys]"
reaction_lines[#reaction_lines+1]="[CATEGORY_DESCRIPTION:Debase adamantine with other metals to get extremely strong alloys.]"
reaction_lines[#reaction_lines+1]="[CATEGORY_KEY:CUSTOM_SHIFT_A]"
end
reaction_lines[#reaction_lines+1]="[FUEL]"
reaction_lines[#reaction_lines+1]="[SKILL:SMELT]"
end
end
local entity_lines={}
raws.register_inorganics(lines)
-- not used in vanilla right now, due to lack of instruments, but you CAN do this
raws.register_reactions(reaction_lines)
end}}
[[Category:Modding]]
[[Category:Lua]]

Lua scripting

2025-02-27T01:16:51Z

Putnam3145:

{{Template:Under_construction}}
{{Modding}}

''This article is about procedural raw generation. Information on [[Utility:DFHack]] scripting can be found at https://docs.dfhack.org/en/stable/.''

[https://www.lua.org/ Lua] scripting is an experimental feature{{version|51.06}}. It is used to create custom procedurally-generated objects that were previously created by hardcoded methods. It was announced in a [https://www.youtube.com/watch?v=Z9rzhFwgfUk video], with the stated goal of "supporting future [[Magic|magical]] endeavors."

Inorganic [[Material definition token|materials]], [[Language token|languages]], [[Creature token|creatures]], [[Interaction token|interactions]], [[Item token|items]] (currently excluding instruments), [[reaction]]s, [[Entity token|entities]], and [[Plant token|plants]] are open to this system.

Scripts are loaded from a mod's ``scripts/init.lua`` file, as well as from any included files.

==Structure==

As of right now, Lua scripting is confined to generation of procedural objects. This is done by running the ``generate`` function, a global function loaded in ``generators.lua``. It runs unit tests, preprocess, materials, items, languages, creatures, interactions, entities and postprocessing, in that order.

When random objects are first generated, the game populates two global tables, ``world`` and ``random_object_parameters``. ``world`` contains info about the world currently being generated (or, in the future, played in), while ``random_object_parameters`` contains what the game expects to be generated. The most important thing between these is ``random_object_parameters.main_world_randoms``, which is ``true`` for exactly one generation at the start of worldgen; it's what you want to check for if you're generating your own objects

You can set the global ``debug_level`` variable to print some debug info. It's a number, but what numbers are there are completely arbitrary. If it's >0, it'll run unit tests; if it's >=0.5, it'll display what step of generation it's at, at every step. You can use ``get_debug_logger(x)`` to return a function that logs to ``lualog.txt`` if the debug level is at least ``x``.

Unit tests are functions that return a table, containing ``good``, which, if truthy, is considered passed, and ``info``, which is a string that contains information on said pass or fail. These unit tests should have no side effects, i.e. they shouldn't muck with global state any. Here's an example unit test, one that was used during development (but had no reason to be removed):

{{Scriptdata
|title=get_random_creature
|script=
get_random_creature=function()
local cr=world.creature.get_random_creature()
local res={}
res.good=type(cr)=='table'
res.info=res.good and ("Got a random creature: "..cr.token) or "No random creature could be gotten, even at most permissive!"
return res
end}}

``preprocess`` is just a table of functions. It runs each function, one at a time. This is where you want your side effects, and, if you're adding an entirely new procedural object type, that's what you probably want. You should also use it if you want to mess around with ``random_object_parameters``, which is allowed (it's how demon types are assigned in vanilla, and you can change the proportions as an end user if you want). The "adamantine alloys" example below is an example of what can be done with preprocess (and postprocess, which is mostly identical except it happens after the rest of generation).

The game then generates all of the individual objects; the general procedure for this is that the game calls the ``generate_from_list`` function on a table of functions, which calls every function and picks one of the resulting tables at random depending on their weights. For example, the ``interactions.secrets`` table contains one entry, that for necromancers; it returns a table containing three entries: ``{interaction=tbl,weight=1,spheres=spheres}``. ``interaction`` is the full raw text of the interaction; ``weight`` is the random weight for the interaction, i.e. if you add another one which returns a table containing ``weight=2``, that will be twice as likely as necromancers. ``spheres=spheres`` is some extra data the generator might be able to use. It actually doesn't, at this point, but one could override ``generate_random_interactions`` with their own version that takes into account ``spheres`` and, say, tries to evenly distribute generated secrets over available spheres. (This didn't end up in vanilla primarily out of concerns of bug-like behavior cropping up).

Languages are special, though; as can be seen below, the ``languages`` table just expects a table containing translations, e.g. ``tbl["ABBEY"]="abbey"``. If you want to procedurally add words or symbols (and yes, these are both doable), you can use preprocess or postprocess.

==Creatures==
Creatures have a lot more to them than other procedural objects. Forgotten beasts are, in a sense, the simplest of them:

{{Scriptdata
|title=creatures.fb.default
|script=
creatures.fb.default=function(layer_type,tok)
local tbl={}
local options={
strong_attack_tweak=true,
spheres={CAVERNS=true},
is_evil=true,
sickness_name="beast sickness",
token=tok
}
tbl=split_to_lines(tbl,[[
[FEATURE_BEAST]
[ATTACK_TRIGGER:0:0:2]
[NAME:forgotten beast:forgotten beasts:forgotten beast]
[CASTE_NAME:forgotten beast:forgotten beasts:forgotten beast]
[NO_GENDER]
[CARNIVORE]
[DIFFICULTY:10]

[NATURAL_SKILL:WRESTLING:6]
[NATURAL_SKILL:BITE:6]
[NATURAL_SKILL:GRASP_STRIKE:6]
[NATURAL_SKILL:STANCE_STRIKE:6]
[NATURAL_SKILL:MELEE_COMBAT:6]
[NATURAL_SKILL:DODGING:6]
[NATURAL_SKILL:SITUATIONAL_AWARENESS:6]
[LARGE_PREDATOR]
]])
add_regular_tokens(tbl,options)
tbl[#tbl+1]=layer_type==0 and "[BIOME:SUBTERRANEAN_WATER]" or "[BIOME:SUBTERRANEAN_CHASM]"
if layer_type==0 then options.spheres.WATER=true end
options.spheres[pick_random(evil_spheres)]=true
options.do_water=layer_type==0
populate_sphere_info(tbl,options)
local rcp=get_random_creature_profile(options)
add_body_size(tbl,math.max(10000000,rcp.min_size),options)
tbl[#tbl+1]="[CREATURE_TILE:"..tile_string(rcp.tile).."]"
build_procgen_creature(rcp,tbl,options)
return {creature=tbl,weight=1}
end}}

This is a lot of info! First, you build an ``options`` table; it's possible to make a full list of options used in vanilla, but other mods can also use arbitrary options. It then adds all the usual special-to-forgotten-beast tokens, in a big string, followed by calling ``add_regular_tokens(tbl,options)``, which adds some stuff common to all (vanilla) procedural creatures, based on the options given. It sets ``do_water`` and the WATER sphere if the FB is in a water cavern, an option which whitelists certain random creature profiles, as well as adding a random evil sphere. ``populate_sphere_info`` is similar to ``add_regular_tokens``; it adds all of the spheres in ``options.spheres`` to the creature, using the SPHERE token, then, if certain options are set, does more. Then, it gets a random creature profile using ``get_random_creature_profile`` and the options, uses ``add_body_size`` to set the BODY_SIZE tokens and attendant things that come with it, sets the creature tile, and finally runs the Big Function, ``build_procgen_creature``, which creates the description, body, tissues, et cetera.

===Random Creature Profiles===
A random creature profile is a type of "thing" a generated creature can be. For example:

{{Scriptdata
|title=random_creature_types.GENERAL_QUADRUPED
|script=
GENERAL_QUADRUPED={
name_string="quadruped",
tile='Q',
body_base="QUADRUPED",
c_class="UNIFORM",
cannot_have_get_more_legs=true,
min_size=70000,
weight=1000
},
}}

Of these, only ``cannot_have_get_more_legs`` is optional. ``build_procgen_creature`` has direct access to the RCP, as the first argument, and thus extra table entries can be used however you like.

===Other stuff===
TODO: Tweaks, random creature materials, random creature classes, color pickers, function that ``build_procgen_creature`` calls in the process of building that can be used to inject your own logic into creature building (e.g. ``btc1_tweaks``), etc.

==Code Samples==

===Divine language===
This is the [[divine language]], which generates a bunch of random-sounding words from a set of syllables.


{{Main:Divine language/script}}

===Identity language===
This makes a [[Language token|language]] called ``GEN_IDENTITY`` which is like: "Abbey abbeyabbeys the abbey of abbeys" - i.e. it's the "English" language you might see occasionally.

{{Scriptdata
|title=GEN_IDENTITY
|script=
languages.GEN_IDENTITY=function()
-- just to demonstrate the absolute most basic method of generating one of these
-- also so that you can just mod stuff to use GEN_IDENTITY
local tbl={}
local unempty = function(str1, str2)
return str1=='' and str2 or str1
end
for k,v in ipairs(world.language.word) do
local str=''
str=unempty(str,v.NOUN_SING)
str=unempty(str,v.ADJ)
str=unempty(str,v.VERB_FIRST_PRES)
str=unempty(str,string.lower(v.token))
tbl[v.token]=str
end
return tbl
end}}

===New divine metal===
You can add new metal descriptions for divine metal pretty easily, for example:

{{Scriptdata
|title=Laughing metal
|script=
metal_by_sphere.CHILDREN={
name="laughing metal",
col="7:0:1",
color="WHITE"
}
}}

===New forgotten beast===
Add a new kind of forgotten beast.

{{Scriptdata
|title=Unbidden spirit
|script=
creatures.fb.unbidden=function(layer_type,tok)
if layer_type==0 then return nil end -- land only
local tbl={}
local options={
strong_attack_tweak=true,
always_make_uniform=true,
always_insubstantial=true,
intangible_flier=true,
spheres={CAVERNS=true},
is_evil=true,
sickness_name="beast sickness",
token=tok
}
tbl=split_to_lines(tbl,[[
[FEATURE_BEAST]
[ATTACK_TRIGGER:0:0:2]
[NAME:unbidden spirit:unbidden spirit:unbidden spirit]
[CASTE_NAME:unbidden spirit:unbidden spirit:unbidden spirit]
[NO_GENDER]
[CARNIVORE]
[DIFFICULTY:10]

[NATURAL_SKILL:WRESTLING:6]
[NATURAL_SKILL:BITE:6]
[NATURAL_SKILL:GRASP_STRIKE:6]
[NATURAL_SKILL:STANCE_STRIKE:6]
[NATURAL_SKILL:MELEE_COMBAT:6]
[NATURAL_SKILL:DODGING:6]
[NATURAL_SKILL:SITUATIONAL_AWARENESS:6]
[LARGE_PREDATOR]
]])
add_regular_tokens(tbl,options)
tbl[#tbl+1]=layer_type==0 and "[BIOME:SUBTERRANEAN_WATER]" or "[BIOME:SUBTERRANEAN_CHASM]"
if layer_type==0 then options.spheres.WATER=true end
options.spheres[pick_random(evil_spheres)]=true
options.do_water=layer_type==0
populate_sphere_info(tbl,options)
local rcp=get_random_creature_profile(options)
add_body_size(tbl,math.max(10000000,rcp.min_size),options)
tbl[#tbl+1]="[CREATURE_TILE:"..tile_string(rcp.tile).."]"
build_procgen_creature(rcp,tbl,options)
-- Weight is a float; all vanilla objects have weight 1
return {creature=tbl,weight=0.5}
end
}}

===Remove default forgotten beast===

<syntaxhighlight lang="lua" >
creatures.fb.default=nil
</syntaxhighlight>

===Adamantine alloys===

You can add your own arbitrary generated objects, though as of right now there's no way to make settings for them. This allows for some ''truly'' wild stuff; here's a fun example: adamantine-metal alloys for every single non-special metal, giving you an average of the properties of them.

{{Scriptdata
|title=Adamantine alloys
|script=
preprocess.adamantine_alloys=function()
if not random_object_parameters.main_world_randoms then return end
local l=get_debug_logger(2)
local lines={}
local reaction_lines={}
local reaction_names={}
local adamantine=world.inorganic.inorganic.ADAMANTINE
if not adamantine then return end
local adamantine_color=world.descriptor.color[world.descriptor.color_pattern[adamantine.material.color_pattern.SOLID].color[1]]
local adamantine_modulus = 2500000 --mildly arbitrary, just below the theoretical limit
l("Starting")
local done_category=false
for k,v in ipairs(world.inorganic.inorganic) do
if not v.flags.SPECIAL and v.material.flags.IS_METAL then
l(v.token)
local token="GEN_ADAMANTINE_"..v.token
lines[#lines+1]="[INORGANIC:"..token.."]"
add_generated_info(lines)
lines[#lines+1]="[USE_MATERIAL_TEMPLATE:METAL_TEMPLATE]"
for kk,vv in pairs(v.material.adj) do
lines[#lines+1]="[STATE_ADJ:"..kk..":adamantine "..vv.."]" --"adamantine molten steel"? it's fine
end
for kk,vv in pairs(v.material.name) do
lines[#lines+1]="[STATE_NAME:"..kk..":adamantine "..vv.."]"
end
l(2)
local mat_values={}
-- Find the ratio for which you get closest to (but not below) 2000000 in the material's worst property
local worst=math.min(v.material.yield.IMPACT,v.material.fracture.SHEAR)
local wafers=1
local bars=1
if worst < 2000000 then
local ratio = (2000000-3*worst)/1000000
local best_diff=1
for i=1,10 do
local wafer_amt=i*ratio
if wafer_amt>1 and wafer_amt<20 and math.ceil(wafer_amt)-wafer_amt<best_diff then
best_diff=math.ceil(wafer_amt)-wafer_amt
wafers=math.ceil(wafer_amt)
bars=i
end
end
end
local avg_denom=1/(bars*3+wafers) -- Multiplication just a bit faster than division, we're rounding at the end anyway
local solid_cl=nil
for kk,vv in pairs(v.material.color_pattern) do
-- time to get silly
local this_color=world.descriptor.color[world.descriptor.color_pattern[vv].color[1]]
local wanted_color={
r=(this_color.r*bars*3+adamantine_color.r*wafers)*avg_denom,
g=(this_color.g*bars*3+adamantine_color.g*wafers)*avg_denom,
b=(this_color.b*bars*3+adamantine_color.b*wafers)*avg_denom,
}
local best_total_diff=1000000000
local best_clp=nil
for _,clp in ipairs(world.descriptor.color_pattern) do
if clp.pattern=="MONOTONE" then
local cl=world.descriptor.color[clp.color[1]]
local diff=math.abs(wanted_color.r-cl.r)+math.abs(wanted_color.b-cl.b)+math.abs(wanted_color.g-cl.g)
if diff<best_total_diff then
best_clp=clp
best_total_diff=diff
end
end
end
lines[#lines+1]="[STATE_COLOR:"..kk..":"..best_clp.token.."]"
if kk=="SOLID" then solid_cl=world.descriptor.color[best_clp.color[1]] end
end
local color_str=solid_cl.col_f..":0:"..solid_cl.col_br
l(color_str)
lines[#lines+1]="[DISPLAY_COLOR:"..color_str.."]"
lines[#lines+1]="[BUILD_COLOR:"..color_str.."]"
lines[#lines+1]="[ITEMS_METAL][ITEMS_HARD][ITEMS_SCALED][ITEMS_BARRED]"
lines[#lines+1]="[SPECIAL]"
if v.material.flags.ITEMS_DIGGER then
lines[#lines+1]="[ITEMS_DIGGER]"
end
local function new_value(str)
mat_values[str]=mat_values[str] or math.floor((adamantine.material[str]*wafers+v.material[str]*bars*3)*avg_denom+0.5)
l(str,mat_values[str])
return mat_values[str]
end
local function new_value_nested(str1,str2)
mat_values[str1..str2]=mat_values[str1..str2] or math.floor((adamantine.material[str1][str2]*wafers+v.material[str1][str2]*bars*3)/(bars*3+wafers)+0.5)
l(str1..str2,mat_values[str1..str2])
return mat_values[str1..str2]
end
if new_value_nested("fracture","SHEAR")>170000 or new_value_nested("yield","IMPACT")>245000 then
lines[#lines+1]="[ITEMS_WEAPON][ITEMS_AMMO]"
if new_value("solid_density")<10000 then
lines[#lines+1]="[ITEMS_WEAPON_RANGED][ITEMS_ARMOR]"
end
end
lines[#lines+1]="[MATERIAL_VALUE:"..new_value("base_value").."]"
lines[#lines+1]="[SPEC_HEAT:"..new_value("temp_spec_heat").."]"
lines[#lines+1]="[MELTING_POINT:"..new_value("temp_melting_point").."]"
lines[#lines+1]="[BOILING_POINT:"..new_value("temp_boiling_point").."]"
lines[#lines+1]="[SOLID_DENSITY:"..new_value("solid_density").."]"
lines[#lines+1]="[LIQUID_DENSITY:"..new_value("liquid_density").."]"
lines[#lines+1]="[MOLAR_MASS:"..new_value("molar_mass").."]" -- i don't think this is actually correct
for _,thing in ipairs({"yield","fracture"}) do
for force,_ in pairs(v.material[thing]) do
lines[#lines+1]="["..string.upper(force).."_"..string.upper(thing)..":"..new_value_nested(thing,force).."]"
end
end
for _,force in ipairs("IMPACT","COMPRESSIVE","TENSILE","TORSION","SHEAR","BENDING") do
local modulus = v.yield[force] / v.elasticity[force]
local average_modulus = (adamantine_modulus*wafers + modulus*bars*3)*avg_denom
local strain_at_yield = math.floor(new_value_nested("yield",force) / average_modulus + 0.5) -- usually zero, but can be 1 or 2 sometimes
lines[#lines+1]="["..string.upper(force).."_YIELD:"..new_value_nested("yield",force).."]"
lines[#lines+1]="["..string.upper(force).."_FRACTURE:"..new_value_nested("fracture",force).."]"
lines[#lines+1]="["..string.upper(force).."_STRAIN_AT_YIELD:"..strain_at_yield.."]"
end
lines[#lines+1]="[MAX_EDGE:"..new_value("max_edge").."]"
local reaction_token=token.."_MAKING"
reaction_lines[#reaction_lines+1]="[REACTION:"..reaction_token.."]"
add_generated_info(reaction_lines)
reaction_lines[#reaction_lines+1]="[NAME:make adamantine "..v.material.name.SOLID.." (use bars)]"
reaction_lines[#reaction_lines+1]="[BUILDING:SMELTER:NONE]"
reaction_lines[#reaction_lines+1]="[REAGENT:A:"..tostring(150*wafers)..":BAR:NO_SUBTYPE:METAL:ADAMANTINE]"
reaction_lines[#reaction_lines+1]="[REAGENT:B:"..tostring(150*bars)..":BAR:NO_SUBTYPE:METAL:"..v.token.."]"
reaction_lines[#reaction_lines+1]="[PRODUCT:100:"..tostring(bars+wafers)..":BAR:NO_SUBTYPE:METAL:"..token.."][PRODUCT_DIMENSION:150]"
reaction_lines[#reaction_lines+1]="[FORTRESS_MODE_ENABLED]"
reaction_lines[#reaction_lines+1]="[CATEGORY:ADAMANTINE_ALLOYS]"
if not done_category then
done_category=true
reaction_lines[#reaction_lines+1]="[CATEGORY_NAME:Adamantine alloys]"
reaction_lines[#reaction_lines+1]="[CATEGORY_DESCRIPTION:Debase adamantine with other metals to get extremely strong alloys.]"
reaction_lines[#reaction_lines+1]="[CATEGORY_KEY:CUSTOM_SHIFT_A]"
end
reaction_lines[#reaction_lines+1]="[FUEL]"
reaction_lines[#reaction_lines+1]="[SKILL:SMELT]"
end
end
local entity_lines={}
raws.register_inorganics(lines)
-- not used in vanilla right now, due to lack of instruments, but you CAN do this
raws.register_reactions(reaction_lines)
end}}
[[Category:Modding]]
[[Category:Lua]]

Entity token

2025-02-04T21:08:56Z

Putnam3145: /* Animal definitions */ source code verified

{{Quality|Superior}}
{{av}}
{{Modding}}
'''Entity tokens''' define entities, or [[civilization]]s, in entity_*.txt files.

The <code>[OBJECT:ENTITY]</code> [[token]] begins the definition of an entity [[raw file]]. Each new entity definition that follows begins with the <code>[ENTITY:''entity_ID'']</code> token, where ''entity_ID'' is a unique identifier for that entity, and the entity's properties are then specified by the use of further entity tokens; or, tokens can be added to existing entities using <code>[SELECT_ENTITY:''entity_ID'']</code> instead.

All known entity tokens are listed below.

__TOC__
{{clear}}

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

|-
| {{text anchor|ALL_MAIN_POPS_CONTROLLABLE}}
|
| Allows adventure mode for entities with sites.

|-
| {{text anchor|SITE_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the SITE_CONTROLLABLE token, then at embark the specific civs can be chosen on the civ list screen. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures. In entities with multiple possible creatures, you can manipulate the chance of one creature being chosen by adding multiple identical creature tags. For instance adding [CREATURE:DWARF][CREATURE:DWARF][CREATURE:DWARF][CREATURE:ELF] to the same entity will make the civs created about 75% dwarven, 25% elven. It should be noted that civilizations are in general weighted by this token: for example, if you have one entity with three [CREATURE:DWARF] tokens and another separate entity with a single [CREATURE:ELF] token, then you can expect to see three times as many of the former placed as the latter (assuming enough unclaimed [START_BIOME:X] space remains). Note that spawn rates are also limited by unclaimed biome space - if an entity can only spawn in a rarer set of biomes (only LAKE_TROPICAL_SALTWATER for example) then their spawn rate will end up being limited by the remaining unclaimed space in that biome type rather than the number of [CREATURE:X] tokens present in the entity raw.
|-
| {{text anchor|SOURCE_HFID}}
| integer
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

Entity spawning during world gen is influenced by several factors:
* The "[[Advanced world generation#Number of Civilizations|Number of Civilizations]]" world gen setting places a hard limit on the total number of entities spawned.
* The "[[Advanced world generation#Playable Civilization Required|Playable Civilization Required]]" world gen setting forces at least one of each [[Entity token#SITE_CONTROLLABLE|SITE_CONTROLLABLE]] entity to spawn (presumably still limited by "Number of Civilizations").
* The number of <nowiki>[</nowiki>[[Entity token#CREATURE|CREATURE]]:X] tokens present in an entity modifies its chance of spawning. An entity containing more <nowiki>[</nowiki>[[Entity token#CREATURE|CREATURE]]:X] tokens will spawn more often (assuming other requirements are met) and may even block entities with fewer <nowiki>[</nowiki>[[Entity token#CREATURE|CREATURE]]:X] tokens from spawning altogether. You can use [SELECT_ENTITY:VANILLA_ENTITY_X] followed by any number of duplicate <nowiki>[</nowiki>[[Entity token#CREATURE|CREATURE]]:VANILLA_CREATURE_X] tokens to attempt to balance the spawn rates of the existing vanilla entities with any custom multi-creature entities you may add.
* The number of unclaimed [[Entity token#START_BIOME|START_BIOME]] or [[Entity token#EXCLUSIVE_START_BIOME|EXCLUSIVE_START_BIOME]] tiles remaining in the world limits the spawn rate for an entity and allows entities to block each other's spawns. If there is no "starting" [[Biome token|biome]] space left for an entity then it will not spawn and the game will try to spawn a different entity instead. This means that, on average, an entity that can start in ALL_MAIN [[Biome token|biomes]] will spawn more frequently than one that can start only in LAKE_TROPICAL_SALTWATER [[Biome token|biomes]]. This also means that entities whose starting [[Biome token|biomes]] do not overlap will not block each other's spawns.

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

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Controls the expansion of the civilization's territory. The higher the number is relative to other BIOME_SUPPORT tokens in the entity, the faster it can spread through the biome. These numbers are evaluated relative to each other, i.e. if one biome is 1 and the other is 2, the spread will be the same as if one was 100 and the other was 200. Civs can spread out over biomes they cannot actually build in; for example, humans spread quickly over oceans but cannot actually build in them.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| If the civ's territory crosses over this biome, it can build settlements here.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Combination of EXCLUSIVE_START_BIOME and SETTLEMENT_BIOME; allows the civ to start in and create settlements in the biome. Note that the civ's spawn rate may be limited if all of its START or EXCLUSIVE_START biome(s) are rare in the world or have already been fully occupied by other civ spawns.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| The birth of the civilization can occur in this biome, but cannot (necessarily) build in it. If the civ does not have SETTLEMENT_BIOME or START_BIOME for the biome in question, it will only construct a single settlement there. Note that the civ's spawn rate may be limited if all of its START or EXCLUSIVE_START biome(s) are rare in the world or have already been fully occupied by other civ spawns.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS (creates a civ of hillocks only), and MONUMENT (creates a civ without visible sites (except tombs and castles), but may cause worldgen crashes). FORTRESS is no longer a valid entry, castles are currently controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing up on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]]. It also gives the civ a [[demon|special overlord]].
CAVE_DETAILED civilizations will create fortresses in mountainous regions and hillocks in non-mountainous regions. [DEFAULT_SITE_TYPE:CAVE_DETAILED]

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

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

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

|}

== Population ==

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

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

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:120]

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

|}

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

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

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

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

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

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting, as well as the value of the [[coin]]. Only effective in Adventurer mode due to lack of [[dwarven economy]].

[CURRENCY:SILVER:5]

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

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

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

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

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

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

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

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

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations are drawn randomly from all translation files. Multiple translation tags will only result in the last one being used. Migrants will sometimes arrive with no name.
* If GEN_DIVINE is entered, the entity will use a generated divine language, that is, the same language that is used for the names of [[angel]]s.
* If the entity's main creature has {{token|UTTERANCES|c}}, then this token will be ignored (except when using the naming menu) in favor of procedural [[kobold]]-style [[Kobold language|pseudolanguage]].
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* category
* [[language#language_SYM.txt|symbol]]
| ALL, REMAINING, BATTLE, BRIDGE, CIV, CRAFT_GUILD, FESTIVAL, HOSPITAL, LIBRARY, MERCHANT_COMPANY, MILITARY_UNIT, OTHER, RELIGION, ROAD, SIEGE, SITE, TEMPLE, TUNNEL, VESSEL, WALL, WAR
The entity will always use a word from the selected symbol(s) to generate names from that category.
* OTHER applies the symbol selection to personal names and site names. REMAINING will apply the symbol selection to all categories that have not already been declared above it.
* Specific to SELECT_SYMBOL, symbols selected this way will be used as "The X" in "The X of Y" names, and nouns from selected symbols can be used as first [[name]]s.

[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* category
* [[language#language_SYM.txt|symbol]]
| As SELECT_SYMBOL, a word from the subselected symbol(s) will be used in names of that category, in addition to the word from SELECT_SYMBOL (if specified). Used in vanilla to put violent names in sieges and battles.
* Words chosen with SUBSELECT_SYMBOL will appear as either adjectives or "of Y" in "The X of Y" names.
* CULL_SYMBOL does not affect subselected symbols.

[SELECT_SYMBOL:SIEGE:NAME_SIEGE]

[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

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

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

[FRIENDLY_COLOR:1:0:1]

|}

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

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

Can be specified multiple times, and will pick randomly from the assigned types. Additional instances of each type will weight the random choice, but unlike {{token|CREATURE|e}}, will not make the entity more likely to spawn.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| [[Sphere#Available_spheres|sphere]]
| Can be any available [[sphere]] - multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding [[Sphere#WATER|WATER]], for example, means civs of this entity will never get [[Sphere#FIRE|FIRE]] as a religious sphere. Note that the [[Sphere#DEATH|DEATH]] sphere favours the appearance of necromancers (and therefore, towers) "in" the entity.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* [[Sphere#Available_spheres|sphere]]
* number
|
This token forces an entity to favor or disfavor particular religious spheres. Default is 256, minimum is 0, maximum is 25600.
* Presently, this doesn't cause them to acquire those spheres more often when generating a pantheon.
* [[Sphere#PLANTS|PLANTS]] and [[Sphere#ANIMALS|ANIMALS]] affect the prevalence of depicting {{token|VEGETATION}} and {{token|NATURAL}} creatures, respectively, in a similar fashion to {{token|ART_FACET_MODIFIER|e}}.
* [[Sphere#WAR|WAR]] modifies the effective [[item value]] of [[weapon]]s and [[armor]] to [[trader]]s of this entity. The multiplier is SPHERE_ALIGNMENT/256, though this only applies to equipment the entity's main creature can properly wield.

[SPHERE_ALIGNMENT:TREES:512]

|}

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

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

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress. As of version 0.44.11, however, this is obsolete due to the changes in how sites are elevated in status.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc.). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

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

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

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

Certain values must be set to 15 or more for civs to create structures and form entities during history gen:
* 15+ KNOWLEDGE for libraries
* 15+ COOPERATION ''and'' 15+ CRAFTSMANSHIP for craft guilds
** Guilds also need guild-valid professions (see [[#PERMITTED_JOB|PERMITTED_JOB]])

|-
| {{text anchor|VARIABLE_VALUE}}
|
*value or ALL
*min
*max
| Makes values randomized rather than specified.
This tag overrides the VALUE tag. Using [VARIABLE_VALUE:ALL:x:y] and then overwriting single values with further [VARIABLE_VALUE:value:x:y] tags works.

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

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen, which seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the defenders.

Mercenaries and monster hunters from the civ may visit player's fortress and petition for residency there to enlist in the military or hunt monsters in caverns, respectively.

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

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

|-
| {{text anchor|AMBUSHER}}
|
| When invading, sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

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

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape. Also causes this civ to be hostile to any entity without this token.

Note: If the playable civ in fortress mode has this tag (e.g. you add BABYSNATCHER to the dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you. However, animals traded away to one's own caravan will count as snatched, reported upon the animal leaving the map, and the animal will not count as having been exported.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s. Only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

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

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

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

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

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

Note: If the playable civ in Fortress Mode has this tag (e.g. you add ITEM_THIEF to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and kobolds will be friendly to you. However, ALL items traded away to one's own caravan will count as stolen, reported when the items leave the map, and the stolen items will not count as exported.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality.

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

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Merchants will engage in cross-civ trading and form companies.

In previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

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

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

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

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

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

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

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

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

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

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER. Prevents the civ from engaging in diplomacy or ending up at war.

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

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as [[bat man]] civilizations. May spawn in any of the three caverns; cavern dweller raids due to [[agitation]] will pull from these. If you embark as this civ, you have access to pets and trees from all three layers, not only the first.

|-
| {{text anchor|GENERATE_KEYBOARD_INSTRUMENTS}}, {{text anchor|GENERATE_PERCUSSION_INSTRUMENTS}}, {{text anchor|GENERATE_STRINGED_INSTRUMENTS}}, {{text anchor|GENERATE_WIND_INSTRUMENTS}}, {{text anchor|GENERATE_DANCE_FORMS}}, {{text anchor|GENERATE_MUSICAL_FORMS}}, {{text anchor|GENERATE_POETIC_FORMS}}
|
| Makes civilizations generate the given instruments/forms.

|-
| {{text anchor|SCHOLAR}}
| scholar type
| ALL, ASTRONOMER, CHEMIST, DOCTOR, ENGINEER, GEOGRAPHER, HISTORIAN, MATHEMATICIAN, NATURALIST, PHILOSOPHER

|-
| {{text anchor|SET_SCHOLARS_ON_VALUES_AND_JOBS}}
|
| Generates scholars based on the values generated with the VARIABLE_VALUE tag.

|-
| {{text anchor|NO_ARTIFACT_CLAIMS}}
|
| Used for kobolds.

|-
| {{text anchor|MINING_UNDERWORLD_DISASTERS}}
|
| The civilization can breach the [[Underworld]] during world generation, spawning a civilization of {{token|EVIL}} creatures lead by a unique [[demon]].

|-
| {{text anchor|MYTHICAL}}{{version|51.01-beta26}}
|
| Builds [[mysterious dungeon]]s.

|}

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

|-
| {{text anchor|AMMO}}
| item token
| Used after a ranged weapon type.
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
| Rarity is optional, and valid values are FORCED, COMMON, UNCOMMON, and RARE (anything else is treated as COMMON). FORCED items will be available 100% of the time, COMMON items 50%, UNCOMMON items 10%, and RARE items 1%. If certain armor types are lacking after performing one pass of randomised checks, the game will repeat random checks until an option is successfully chosen.
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal - for those cases, listing the pick under the [WEAPON] token works just as well. Note that this tag is neither necessary nor sufficient to allow use of that item as a mining tool – for that, the item itself needs to be a weapon with [SKILL:MINING].
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional, and valid values are FORCED, COMMON, UNCOMMON, and RARE (anything else is treated as COMMON). Uses the same rarity values and methods as outlined in ARMOR.
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional, and valid values are FORCED, COMMON, UNCOMMON, and RARE (anything else is treated as COMMON). Uses the same rarity values and methods as outlined in ARMOR.
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
| No longer used as of [[:Category:Version 0.42.01|Version 0.42.01]] due to the ability to generate instruments in world generation. It is still usable if pre-defined instruments are modded in, and generated musical forms are capable of selecting pre-defined instruments to use. However, reactions for making instruments, instrument parts, and/or assembling such instruments need to be added as well, as this token no longer adds such instruments to the craftdwarf's workshop menu.
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional, and valid values are FORCED, COMMON, UNCOMMON, and RARE (anything else is treated as COMMON). Uses the same rarity values and methods as outlined in ARMOR.
[PANTS:ITEM_PANTS_PANTS:COMMON]

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

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional, and valid values are FORCED, COMMON, UNCOMMON, and RARE (anything else is treated as COMMON). Uses the same rarity values and methods as outlined in ARMOR.
[SHOES:ITEM_SHOES_SHOES:COMMON]

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

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

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

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

|-
| {{text anchor|WEAPON}}
| item token
| While this does not accept a rarity value, something similar can be achieved by having multiple variations of a weapon type with small differences and specifying each of them.{{cite forum|179547}}
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

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

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

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

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Without this, EVIL creatures are skipped, otherwise, evil creatures with SLOW_LEARNER or ''without'' {{catlink|Learns|CAN_LEARN}} will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with {{catlink|Mount|MOUNT}} or {{catlink|Exotic mount|MOUNT_EXOTIC}}), and siege minions (with {{catlink|War animals|TRAINABLE_WAR}} or SLOW_LEARNER), even the normally untameable species.

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| Same as USE_EVIL_ANIMALS for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| Same as USE_EVIL_ANIMALS for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Without this GOOD creatures are skipped, otherwise, good creatures ''without'' {{catlink|Learns|CAN_LEARN}} will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with {{catlink|Mount|MOUNT}} or {{catlink|Exotic mount|MOUNT_EXOTIC}}), and siege minions (with {{catlink|War animals|TRAINABLE_WAR}}), even the normally untameable species.

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| Same as USE_GOOD_ANIMALS for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| Same as USE_GOOD_ANIMALS for all uses of wood.

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

|-
| {{text anchor|USE_NON_EXOTIC_PET_RACE}}
|
| Makes the civilization use all locally available non-exotic pets.

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

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

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

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

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow use of river products in the goods available for trade.

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

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow use of underground plant products in the goods available for trade. Lack of suitable vegetation in the caverns will cause [[World generation#Rejections|worldgen rejection]]s. According to Droseran: "Gives access to plants (structural material) and seeds. It only checks for [EDIBLE_RAW] or [EDIBLE_COOKED] on the plant's structural material. It doesn't check if the plant can be used in a reaction to produce something edible, only if it can be eaten raw or cooked. If an entity with this token is placed in a biome that doesn't have at least one of these tokens on the structural material, the map is rejected. Due to the randomness of plant selection in biomes, this can happen a lot as only about half of the vanilla plants have edible structural materials. Removing either of these tokens from plants dramatically increases map rejections."

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow use of outdoor plant products in the goods available for trade. Lack of suitable vegetation in this civilization's starting area will cause [[World generation#Rejections|worldgen rejection]]s. According to Droseran: "Gives access to plants (structural material) and seeds. It only checks for [EDIBLE_RAW] or [EDIBLE_COOKED] on the plant's structural material. It doesn't check if the plant can be used in a reaction to produce something edible, only if it can be eaten raw or cooked. If an entity with this token is placed in a biome that doesn't have at least one of these tokens on the structural material, the map is rejected. Due to the randomness of plant selection in biomes, this can happen a lot as only about half of the vanilla plants have edible structural materials. Removing either of these tokens from plants dramatically increases map rejections."

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow use of underground plant growths (quarry bush leaves, in unmodded games) in the goods available for trade. According to Droseran: "Will never cause map rejections. It allows growths to be used, but doesn't care if none exist. If an entity doesn't have a farming token, they won't have seeds or plants available on embark/trade. But you can still farm in fortress mode with only this token, you just have to get the seeds manually or trading with another civ."

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow use of outdoor plant growths in the goods available for trade. According to Droseran: "Will never cause map rejections. It allows growths to be used, but doesn't care if none exist. If an entity doesn't have a farming token, they won't have seeds or plants available on embark/trade. But you can still farm in fortress mode with only this token, you just have to get the seeds manually or trading with another civ."

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows use of indoor tree growths in the goods available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit. Needs INDOOR_WOOD to function. Will cause rejections, if growths are unavailable. According to Droseran: "Gives access to tree growths. It only checks for growths on trees that are [EDIBLE_RAW] or [EDIBLE_COOKED]. If an entity with this token is placed in a biome that does not have a tree with a growth with at least one of these tokens, the map is rejected."

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows use of outdoor tree growths in the goods available for trade. Needs OUTDOOR_WOOD to function{{verify}}. According to Droseran: "Gives access to tree growths. It only checks for growths on trees that are [EDIBLE_RAW] or [EDIBLE_COOKED]. If an entity with this token is placed in a biome that does not have a tree with a growth with at least one of these tokens, the map is rejected."

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| {{text anchor|DIVINE_MAT_CRAFTS}}
|
| Allows use of materials with [DIVINE] for crafts.{{verify}} Used for generated divine entities.

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

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

== Animal definitions ==

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

|-
| {{text anchor|ANIMAL}}
|
| Start an animal definition.

|-
| {{text anchor|ANIMAL_TOKEN}}
| [[creature token]]
| Select specific creature.

|-
| {{text anchor|ANIMAL_CASTE_TOKEN}}
| [[Caste|creature caste token]]
| Select specific creature caste (requires ANIMAL_TOKEN). Sites with animal populations will still include all castes, but only the selected ones will be used for specific roles.

|-
| {{text anchor|ANIMAL_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Select creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_FORBIDDEN_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Forbid creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_ALWAYS_PRESENT}}
|
| Animal will be present even if it does not naturally occur in the entity's terrain. All creatures, including [[demon]]s, night trolls and other generated ones will be used if no specific creature or class is selected.

|-
|
* {{text anchor|ANIMAL_NEVER_MOUNT}}, {{text anchor|ANIMAL_ALWAYS_MOUNT}}
* {{text anchor|ANIMAL_NEVER_WAGON_PULLER}}, {{text anchor|ANIMAL_ALWAYS_WAGON_PULLER}}
* {{text anchor|ANIMAL_NEVER_SIEGE}}, {{text anchor|ANIMAL_ALWAYS_SIEGE}}
* {{text anchor|ANIMAL_NEVER_PET}}, {{text anchor|ANIMAL_ALWAYS_PET}}
* {{text anchor|ANIMAL_NEVER_PACK_ANIMAL}}, {{text anchor|ANIMAL_ALWAYS_PACK_ANIMAL}}
|
| Override creature usage tokens. Respectively:
* [[Creature token#MOUNT|MOUNT]] and [[Creature token#MOUNT_EXOTIC|MOUNT_EXOTIC]]
* [[Creature token#WAGON_PULLER|WAGON_PULLER]]
* [[Creature token#TRAINABLE_WAR|TRAINABLE_WAR]] and not [[Creature token#CAN_LEARN|CAN_LEARN]]
* [[Creature token#PET|PET]] and [[Creature token#PET_EXOTIC|PET_EXOTIC]]
* [[Creature token#PACK_ANIMAL|PACK_ANIMAL]]
ALWAYS overrides NEVER if a caste is matched by more than one animal definition.

|}

== Tissue styling-related tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

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

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

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

|}

== Examples ==
:''Main articles: [[Entity examples]]''

{{Category|Modding}}
{{Category|Tokens}}
{{Category|Entities}}
[[ru:Entity token]]

Discipline

2024-09-04T03:35:20Z

Putnam3145:

{{migrated article}}
{{Quality|Unrated}}
{{Skill
| color = 0:0
| skill = Discipline
| profession = Military
| job name = None
| tasks = None
| attributes = Unknown
}}
{{av}}

'''Discipline''' is a [[skill]] highly relevant to [[military]] dwarves, and somewhat less important for civilians. A dwarf with high discipline is less likely to retreat in battle, cancel a job when witnessing death, or collapse/pass out from over-exertion. This makes it very useful for long, drawn-out fights, where exhaustion may be a factor and many dwarves may die; without discipline even a dwarf with legendary weapon skills will panic and run before he is even able to do anything to the enemies trying to kill you, or might fall over and be killed just from sheer quantity. It is also helpful for keeping your medic from panicking when you're having a bit too much [[fun]] and they lose a patient with others waiting to be tended to.

Active military [[training]] raises the discipline skill (rather quickly, in fact), so giving your dwarves a few months of basic military training is helpful before throwing them onto the battlefield.

Being exposed to things such as dead bodies, being rained on, and cancelling jobs due to being "horrified" also contributes to the raising of the discipline skill.

Somewhat contrary to what one may expect, creatures with a naturally-high tolerance for mental stress and horror will actually have some difficulty training their discipline through exposure and live training, as they will not spend as much time being horrified by what is happening.

{{Skills}}

Template:V50 modding

2024-09-02T15:17:37Z

Putnam3145: Made the personality link go directly to the creature tokens in particular, and added values to the entity category

{{Sidebar
| name = Template:v50 modding
| title = [[Modding]]<hr>
| contentstyle = font-size: 12px; padding-left: 5px; text-align: center;

| heading1 = <big>[[Token]]s</big>
| content1 = [[Audio]]{{*}} [[Biome token|Biome]]{{*}} [[Graphics token|Graphics]]{{*}} [[Interaction token|Interaction]]{{*}} [[Mod info token|Mod info]]{{*}} [[Plant token|Plant]]{{*}} [[Speech file|Speech]]{{*}} [[Sphere#Sphere tokens|Sphere]]{{*}} [[Syndrome#The_anatomy_of_a_syndrome|Syndrome]]{{*}} [[World token|World]]

| heading2 = Body tokens
| content2 = [[Body token|Body]]{{*}} [[Body detail plan token|Body detail plan]]{{*}} [[Bodygloss]]{{*}} [[Tissue definition token|Tissue]]

| heading3 = Creature tokens
| content3 = [[Creature token|Creature]]{{*}} [[Creature mannerism token|Creature mannerism]]{{*}} [[Personality trait#Facets|Personality]]{{*}} [[Creature variation token|Creature variation]]{{*}} [[Procedural graphics layer]]

| heading4 = Descriptor tokens
| content4 = [[Descriptor color token|Descriptor color]]{{*}} [[Color]]{{*}} [[Descriptor pattern token|Descriptor pattern]]{{*}} [[Descriptor shape token|Descriptor shape]]

| heading5 = Entity tokens
| content5 = [[Entity token|Entity]]{{*}} [[Ethic]]{{*}} [[Language token|Language]]{{*}} [[Personality trait#Beliefs|Personality]]{{*}} [[Position token|Position]]

| heading6 = Job tokens
| content6 = [[Building token|Building]]{{*}} [[Labor token|Labor]]{{*}} [[Reaction]]{{*}} [[Skill token|Skill]]{{*}} [[Unit type token|Unit type]]

| heading7 = Item tokens
| content7 = [[Item token|Item type]]{{*}} [[Item definition token|Item definition]]{{*}} [[Ammo token|Ammo]]{{*}} [[Armor token|Armor]]{{*}} [[Instrument token|Instrument]]{{*}} [[Tool token|Tool]]{{*}} [[Trap component token|Trap component]]{{*}} [[Weapon token|Weapon]]

| heading8 = Material tokens
| content8 = [[Material token|Material type]]{{*}} [[Material definition token|Material definition]]{{*}} [[Inorganic material definition token|Inorganic material definition]]
}}

<includeonly>[[ru:{{PAGENAME}}]]</includeonly><noinclude>[[Category:Sidebars]][[Category:Navigation templates]]</noinclude>

Skill token

2024-09-01T01:42:14Z

Putnam3145:

{{Quality|Exceptional}}
{{av}}
{{old}}
{{Modding}}
A complete list of '''skill tokens''' for [[skill]]s, generally used in [[reaction]]s.

{| {{prettytable}} class="sortable"
|- style='background-color:#ddd'
! # !! Token !! Skill !! Description !! Skill type
|-
| 0 || {{text anchor|MINING}} || [[Miner]] || Mining || Labor
|-
| 1 || {{text anchor|WOODCUTTING}} || [[Wood cutter]] || Wood Cutting || Labor
|-
| 2 || {{text anchor|CARPENTRY}} || [[Carpenter]] || Carpentry || Labor
|-
| 3 || {{text anchor|ENGRAVE_STONE}} || [[Engraver]] || Engraving || Labor
|-
| 4 || {{text anchor|MASONRY}} || [[Mason]] || Masonry || Labor
|-
| 5 || {{text anchor|ANIMALTRAIN}} || [[Animal trainer]] || Animal Training || Labor
|-
| 6 || {{text anchor|ANIMALCARE}} || [[Animal caretaker]] || Animal Caretaking || Labor
|-
| 7 || {{text anchor|DISSECT_FISH}} || [[Fish dissector]] || Fish Dissection || Labor
|-
| 8 || {{text anchor|DISSECT_VERMIN}} || [[Animal dissector]] || Animal Dissection || Labor
|-
| 9 || {{text anchor|PROCESSFISH}} || [[Fish cleaner]] || Fish Cleaning || Labor
|-
| 10 || {{text anchor|BUTCHER}} || [[Butcher]] || Butchery || Labor
|-
| 11 || {{text anchor|TRAPPING}} || [[Trapper]] || Trapping || Labor
|-
| 12 || {{text anchor|TANNER}} || [[Tanner]] || Tanning || Labor
|-
| 13 || {{text anchor|WEAVING}} || [[Weaver]] || Weaving || Labor
|-
| 14 || {{text anchor|BREWING}} || [[Brewer]] || Brewing || Labor
|-
| 15 || {{text anchor|CLOTHESMAKING}} || [[Clothier]] || Clothes Making || Labor
|-
| 16 || {{text anchor|MILLING}} || [[Miller]] || Milling || Labor
|-
| 17 || {{text anchor|PROCESSPLANTS}} || [[Thresher]] || Threshing || Labor
|-
| 18 || {{text anchor|CHEESEMAKING}} || [[Cheese maker]] || Cheese Making || Labor
|-
| 19 || {{text anchor|MILK}} || [[Milker]] || Milking || Labor
|-
| 20 || {{text anchor|COOK}} || [[Cook]] || Cooking || Labor
|-
| 21 || {{text anchor|PLANT}} || [[Grower]] || Growing || Labor
|-
| 22 || {{text anchor|HERBALISM}} || [[Herbalist]] || Herbalism || Labor
|-
| 23 || {{text anchor|FISH}} || [[Fisherdwarf|Fisherman]] || Fishing || Labor
|-
| 24 || {{text anchor|SMELT}} || [[Furnace operator]] || Furnace Operation || Labor
|-
| 25 || {{text anchor|EXTRACT_STRAND}} || [[Strand extractor]] || Strand Extraction || Labor
|-
| 26 || {{text anchor|FORGE_WEAPON}} || [[Weaponsmith]] || Weaponsmithing || Labor
|-
| 27 || {{text anchor|FORGE_ARMOR}} || [[Armorsmith]] || Armorsmithing || Labor
|-
| 28 || {{text anchor|FORGE_FURNITURE}} || [[Metalsmith]] || Metalsmithing || Labor
|-
| 29 || {{text anchor|CUTGEM}} || [[Gem cutter]] || Gem Cutting || Labor
|-
| 30 || {{text anchor|ENCRUSTGEM}} || [[Gem setter]] || Gem Setting || Labor
|-
| 31 || {{text anchor|WOODCRAFT}} || [[Wood crafter]] || Wood Crafting || Labor
|-
| 32 || {{text anchor|STONECRAFT}} || [[Stone crafter]] || Stone Crafting || Labor
|-
| 33 || {{text anchor|METALCRAFT}} || [[Metal crafter]] || Metal Crafting || Labor
|-
| 34 || {{text anchor|GLASSMAKER}} || [[Glassmaker]] || Glassmaking || Labor
|-
| 35 || {{text anchor|LEATHERWORK}} || [[Leatherworker]] || Leatherworking || Labor
|-
| 36 || {{text anchor|BONECARVE}} || [[Bone carver]] || Bone Carving || Labor
|-
| 37 || {{text anchor|AXE}} || [[Axeman]] || Axe || Combat
|-
| 38 || {{text anchor|SWORD}} || [[Swordsman]] || Sword || Combat
|-
| 39 || {{text anchor|DAGGER}} || [[Knife user]] || Knife || Combat
|-
| 40 || {{text anchor|MACE}} || [[Maceman]] || Mace || Combat
|-
| 41 || {{text anchor|HAMMER}} || [[Hammerman]] || Hammer || Combat
|-
| 42 || {{text anchor|SPEAR}} || [[Spearman]] || Spear || Combat
|-
| 43 || {{text anchor|CROSSBOW}} || [[Crossbowman]] || Crossbow || Combat
|-
| 44 || {{text anchor|SHIELD}} || [[Shield user]] || Shield || Combat
|-
| 45 || {{text anchor|ARMOR}} || [[Armor user]] || Armor || Combat
|-
| 46 || {{text anchor|SIEGECRAFT}} || [[Siege engineer]] || Siege Engineering || Labor
|-
| 47 || {{text anchor|SIEGEOPERATE}} || [[Siege operator]] || Siege Operation || Combat
|-
| 48 || {{text anchor|BOWYER}} || [[Bowyer]] || Bowmaking || Labor
|-
| 49 || {{text anchor|PIKE}} || [[Pikeman]] || Pike || Combat
|-
| 50 || {{text anchor|WHIP}} || [[Lasher]] || Lash || Combat
|-
| 51 || {{text anchor|BOW}} || [[Bowman]] || Bow || Combat
|-
| 52 || {{text anchor|BLOWGUN}} || [[Blowgunner]] || Blowgun || Combat
|-
| 53 || {{text anchor|THROW}} || [[Thrower]] || Throwing || Combat
|-
| 54 || {{text anchor|MECHANICS}} || [[Mechanic]] || Machinery || Labor
|-
| 55 || {{text anchor|MAGIC_NATURE}} || [[Druid]] || Nature || Miscellaneous
|-
| 56 || {{text anchor|SNEAK}} || [[Ambusher]] || Ambush || Miscellaneous
|-
| 57 || {{text anchor|DRESS_WOUNDS}} || [[Wound dresser]] || Wound Dressing || Labor
|-
| 58 || {{text anchor|DIAGNOSE}} || [[Diagnostician]] || Diagnostics || Labor
|-
| 59 || {{text anchor|SURGERY}} || [[Surgeon]] || Surgery || Labor
|-
| 60 || {{text anchor|SET_BONE}} || [[Bone doctor]] || Bone Setting || Labor
|-
| 61 || {{text anchor|SUTURE}} || [[Suturer]] || Suturing || Labor
|-
| 62 || {{text anchor|CRUTCH_WALK}} || [[Crutch-walker]] || Crutch-walking || Miscellaneous
|-
| 63 || {{text anchor|WOOD_BURNING}} || [[Wood burner]] || Wood Burning || Labor
|-
| 64 || {{text anchor|LYE_MAKING}} || [[Lye maker]] || Lye Making || Labor
|-
| 65 || {{text anchor|SOAP_MAKING}} || [[Soaper]] || Soap Making || Labor
|-
| 66 || {{text anchor|POTASH_MAKING}} || [[Potash maker]] || Potash Making || Labor
|-
| 67 || {{text anchor|DYER}} || [[Dyer]] || Dyeing || Labor
|-
| 68 || {{text anchor|OPERATE_PUMP}} || [[Pump operator]] || Pump Operation || Labor
|-
| 69 || {{text anchor|SWIMMING}} || [[Swimmer]] || Swimming || Miscellaneous
|-
| 70 || {{text anchor|PERSUASION}} || [[Persuader]] || Persuasion || Social
|-
| 71 || {{text anchor|NEGOTIATION}} || [[Negotiator]] || Negotiation || Social
|-
| 72 || {{text anchor|JUDGING_INTENT}} || [[Judge of intent]] || Judging Intent || Social
|-
| 73 || {{text anchor|APPRAISAL}} || [[Appraiser]] || Appraisal || Labor
|-
| 74 || {{text anchor|ORGANIZATION}} || [[Organizer]] || Organization || Social
|-
| 75 || {{text anchor|RECORD_KEEPING}} || [[Record keeper]] || Record Keeping || Labor
|-
| 76 || {{text anchor|LYING}} || [[Liar]] || Lying || Social
|-
| 77 || {{text anchor|INTIMIDATION}} || [[Intimidator]] || Intimidation || Social
|-
| 78 || {{text anchor|CONVERSATION}} || [[Conversationalist]] || Conversation || Social
|-
| 79 || {{text anchor|COMEDY}} || [[Comedian]] || Comedy || Social
|-
| 80 || {{text anchor|FLATTERY}} || [[Flatterer]] || Flattery || Social
|-
| 81 || {{text anchor|CONSOLE}} || [[Consoler]] || Consoling || Social
|-
| 82 || {{text anchor|PACIFY}} || [[Pacifier]] || Pacification || Social
|-
| 83 || {{text anchor|TRACKING}} || [[Tracker]] || Tracking || Miscellaneous
|-
| 84 || {{text anchor|KNOWLEDGE_ACQUISITION}} || [[Student]] || Studying || Labor
|-
| 85 || {{text anchor|CONCENTRATION}} || [[Concentration]] || Concentration || Social
|-
| 86 || {{text anchor|DISCIPLINE}} || [[Discipline]] || Discipline || Combat
|-
| 87 || {{text anchor|SITUATIONAL_AWARENESS}} || [[Observer]] || Observation || Combat
|-
| 88 || {{text anchor|WRITING}} || [[Writer]] || Writing || Knowledge
|-
| 89 || {{text anchor|PROSE}} || [[Wordsmith]] || Prose || Knowledge
|-
| 90 || {{text anchor|POETRY}} || [[Poet]] || Poetry || Performance
|-
| 91 || {{text anchor|READING}} || [[Reader]] || Reading || Miscellaneous
|-
| 92 || {{text anchor|SPEAKING}} || [[Speaker]] || Speaking || Performance
|-
| 93 || {{text anchor|COORDINATION}} || [[Coordination]] || Coordination || Miscellaneous
|-
| 94 || {{text anchor|BALANCE}} || [[Balance]] || Balance || Miscellaneous
|-
| 95 || {{text anchor|LEADERSHIP}} || [[Leader]] || Leadership || Miscellaneous
|-
| 96 || {{text anchor|TEACHING}} || [[Teacher]] || Teaching || Miscellaneous
|-
| 97 || {{text anchor|MELEE_COMBAT}} || [[Fighter]] || Fighting || Combat
|-
| 98 || {{text anchor|RANGED_COMBAT}} || [[Archer]] || Archery || Combat
|-
| 99 || {{text anchor|WRESTLING}} || [[Wrestler]] || Wrestling || Combat
|-
| 100 || {{text anchor|BITE}} || [[Biter]] || Biting || Combat
|-
| 101 || {{text anchor|GRASP_STRIKE}} || [[Striker]] || Striking || Combat
|-
| 102 || {{text anchor|STANCE_STRIKE}} || [[Kicker]] || Kicking || Combat
|-
| 103 || {{text anchor|DODGING}} || [[Dodger]] || Dodging || Combat
|-
| 104 || {{text anchor|MISC_WEAPON}} || [[Misc. object user]] || Misc. Object || Combat
|-
| 105 || {{text anchor|KNAPPING}} || [[Knapper]] || Knapping || Miscellaneous
|-
| 106 || {{text anchor|MILITARY_TACTICS}} || [[Military tactics]] || Military Tactics || Miscellaneous
|-
| 107 || {{text anchor|SHEARING}} || [[Shearer]] || Shearing || Labor
|-
| 108 || {{text anchor|SPINNING}} || [[Spinner]] || Spinning || Labor
|-
| 109 || {{text anchor|POTTERY}} || [[Potter]] || Pottery || Labor
|-
| 110 || {{text anchor|GLAZING}} || [[Glazer]] || Glazing || Labor
|-
| 111 || {{text anchor|PRESSING}} || [[Presser]] || Pressing || Labor
|-
| 112 || {{text anchor|BEEKEEPING}} || [[Beekeeper]] || Beekeeping || Labor
|-
| 113 || {{text anchor|WAX_WORKING}} || [[Wax worker]] || Wax Working || Labor
|-
| 114 || {{text anchor|CLIMBING}} || [[Climber]] || Climbing || Miscellaneous
|-
| 115 || {{text anchor|GELD}} || [[Gelder]] || Gelding || Labor
|-
| 116 || {{text anchor|DANCE}} || [[Dancer]] || Dancing || Performance
|-
| 117 || {{text anchor|MAKE_MUSIC}} || [[Musician]] || Music Making || Performance
|-
| 118 || {{text anchor|SING}} || [[Singer]] || Singing || Performance
|-
| 119 || {{text anchor|PLAY_KEYBOARD_INSTRUMENT}} || [[Keyboardist]] || Keyboard Instrument Playing || Performance
|-
| 120 || {{text anchor|PLAY_STRINGED_INSTRUMENT}} || [[Stringed instrumentalist]] || Stringed Instrument Playing || Performance
|-
| 121 || {{text anchor|PLAY_WIND_INSTRUMENT}} || [[Wind instrumentalist]] || Wind Instrument Playing || Performance
|-
| 122 || {{text anchor|PLAY_PERCUSSION_INSTRUMENT}} || [[Percussionist]] || Percussion Instrument Playing || Performance
|-
| 123 || {{text anchor|CRITICAL_THINKING}} || [[Critical thinker]] || Critical Thinking || Knowledge
|-
| 124 || {{text anchor|LOGIC}} || [[Logician]] || Logic || Knowledge
|-
| 125 || {{text anchor|MATHEMATICS}} || [[Mathematician]] || Mathematics || Knowledge
|-
| 126 || {{text anchor|ASTRONOMY}} || [[Astronomer]] || Astronomy || Knowledge
|-
| 127 || {{text anchor|CHEMISTRY}} || [[Chemist]] || Chemistry || Knowledge
|-
| 128 || {{text anchor|GEOGRAPHY}} || [[Geographer]] || Geography || Knowledge
|-
| 129 || {{text anchor|OPTICS_ENGINEER}} || [[Optics engineer]] || Optics Engineering || Knowledge
|-
| 130 || {{text anchor|FLUID_ENGINEER}} || [[Fluid engineer]] || Fluid Engineering || Knowledge
|-
| 131 || {{text anchor|PAPERMAKING}} || [[Papermaker]] || Papermaking || Labor
|-
| 132 || {{text anchor|BOOKBINDING}} || [[Bookbinder]] || Bookbinding || Labor
|-
| 133|| {{text anchor|INTRIGUE}} || [[Schemer]] || Scheming || Miscellaneous
|-
| 134|| {{text anchor|RIDING}} || [[Rider]] || Riding || Miscellaneous
|-
| 135|| {{text anchor|CUT_STONE}} || [[Stonecutter]] || Stonecutter || Labor
|-
| 136|| {{text anchor|CARVE_STONE}} || [[Stone carver]] || Stone Carving || Labor
|-
| 137|| {{text anchor|MODSKILL01}} || [[Mod skill|Skill 1]] || Mod skill || Miscellaneous
|-
| 138|| {{text anchor|MODSKILL02}} || [[Mod skill|Skill 2]] || Mod skill || Miscellaneous
|-
| 139|| {{text anchor|MODSKILL03}} || [[Mod skill|Skill 3]] || Mod skill || Miscellaneous
|-
| 140|| {{text anchor|MODSKILL04}} || [[Mod skill|Skill 4]] || Mod skill || Miscellaneous
|-
| 141|| {{text anchor|MODSKILL05}} || [[Mod skill|Skill 5]] || Mod skill || Miscellaneous
|-
| 142|| {{text anchor|MODSKILL06}} || [[Mod skill|Skill 6]] || Mod skill || Miscellaneous
|-
| 143|| {{text anchor|MODSKILL07}} || [[Mod skill|Skill 7]] || Mod skill || Miscellaneous
|-
| 144|| {{text anchor|MODSKILL08}} || [[Mod skill|Skill 8]] || Mod skill || Miscellaneous
|-
| 145|| {{text anchor|MODSKILL09}} || [[Mod skill|Skill 9]] || Mod skill || Miscellaneous
|-
| 146|| {{text anchor|MODSKILL10}} || [[Mod skill|Skill 10]] || Mod skill || Miscellaneous
|-
|}

{{Skills}}

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

Reaction

2024-08-10T19:59:38Z

Putnam3145: /* Material token */

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

'''Reactions''' are modular, editable formulas that take specific ingredients, or reagents, and use them to produce a desired item. A lot of reactions are hardcoded—building beds or creating glass, for example—but a few are freely editable, and it's (sometimes) quite simple to add additional ones. There is a separate page with custom [[reaction examples]].

== Reaction differences between modes ==
{{migrated section}}

In [[fortress mode]], reactions are linked to specific buildings, and must be added to a civilization's [[entity token|entity file]] to be usable by that civilization. This has the useful effect of limiting new items and materials (such as special [[wood]] or [[metal]]) to civilizations that have the requisite reaction — so that if you give your custom civilization a reaction to produce "star metal" or some other custom material, only they will be able to use it.

In [[adventure mode]], reactions are freely available in the {{k|x}} menu via the {{DFtext|create}} option, and any adventurer character can make free use of them. Reagents may be held in the hands or dropped on the ground, but cannot be used within a backpack or quiver. There are several bugs with adventure mode reactions, chief of which is the fact that you cannot select liquid reagents.{{verify}} 

== Anatomy of a reaction ==
Reactions are found within reaction_x files (such as reaction_smelter or reaction_other). All reaction files must begin with the file name, followed by the <code>[OBJECT:REACTION]</code> token that tells the game that the file contains reaction definitions.

The reactions themselves generally adhere to the following structure:

[REACTION:<identifier>]
[NAME:<name>]
[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
[REAGENT:A:150:BAR:NONE:POTASH:NONE]
[PRODUCT:100:1:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:<SKILL TOKEN>]
[MAX_MULTIPLIER:<multiplier>]
[AUTOMATIC]
[ADVENTURE_MODE_ENABLED]
[DESCRIPTION:<description>]

* ''[[#Reaction identifier|identifier]]'': The internal ID of the reaction.
* ''[[#Reaction name|name]]'': The name of the reaction, visible to the player in the Fortress mode or Adventure mode menus.
* ''[[#Building|building]]'': The building ID that the reaction uses, and the relevant keyboard shortcut.
* ''[[#Reagents|...reagents...]]'': Zero or more reagents (ingredients) that are required to be in stock for the reaction to be possible.
* ''[[#Products|...products...]]'': Zero or more products that are created from the reaction.
* ''[[#Fuel|fuel]]'': (optional) If present, the reaction requires charcoal, coke or a magma-powered workshop.
* ''[[#Skill|skill]]'': (optional) The skill required and trained by the reaction.
* ''[[#Max multiplier|multiplier]]'': (optional) If present, the reaction will only be done the specified number of times per job; used to limit the output of reactions that accept stacks of items as reagents.
* ''[[#Automatic|automatic]]'': (optional) If present, the reaction will automatically be enqueued whenever it can possibly be performed.
* ''[[#Adventure mode enabled|adventure mode enabled]]'': (optional) If present, the reaction can be used by the player in Adventure mode.
* ''[[#Description|description]]'': (optional) If present, shows pop-up description when the reaction is selected in workshop (not working in v50).

=== Reaction identifier ===
The REACTION token assigns a unique ID to your reaction.
[REACTION:<reaction identifier>]

The ''reaction identifier'' may be anything, so long as it is unique within the raw data files. A good habit to get into is to append a short prefix or suffix to each name related to the name of your mod, to ensure nobody else is going to make an identical reaction and thereby mess up the game if their mod is run alongside yours. This is referenced in an entity definition via [[Entity_token#PERMITTED_REACTION|PERMITTED_REACTION]] to allow that entity to use the reaction.

=== Reaction name ===
The REACTION_NAME token assigns a descriptive name to your reaction in-game.
[REACTION_NAME:<name>]

==== Name ====
This can be anything at all, and is how the reaction will appear in the job list of the building it is assigned to, and so should describe the reaction. '''Tan a hide''', for example, is the name of the default leather-producing reaction. Generally this should be written as a small descriptive verb phrase, with the first letter capitalized, for consistency with the existing reactions.

=== Building ===
The BUILDING token assigns the reaction to a building. Adding multiple BUILDING tokens will cause the reaction to be available at all of the specified buildings. Omitting the BUILDING token entirely will make the reaction unusable in Fortress mode (often used to restrict certain reactions to [[Reaction#Adventure_Mode_enabled|Adventure mode]]).

[BUILDING:<building name>:<building key>]
* [[#Building name|''building name:'']] The ID of the building the reaction appears in.
* [[#Building key|''building key:'']] The hotkey to queue up the reaction in the specified building.

==== Building name ====
This is the ID of the building where the reaction will be carried out. Valid building names are as follows:

* ASHERY - [[Ashery]]
* BOWYER - [[Bowyer's workshop]]
* CARPENTER - [[Carpenter's workshop]]
* CLOTHES - [[Clothier's shop]]
* CRAFTSMAN - [[Craftsdwarf's workshop]]
* FARMER - [[Farmer's workshop]]
* GLASS - [[Glass furnace]]
* KILN - [[Kiln]] and [[Magma kiln]]
* KITCHEN - [[Kitchen]]
* LEATHER - [[Leather works]]
* MASON - [[Stoneworker's workshop]]
* METALSMITH - [[Metalsmith's forge]]
* MILLSTONE - [[Millstone]]
* QUERN - [[Quern]]
* SIEGE - [[Siege workshop]]
* SMELTER - [[Smelter]] and [[Magma smelter]]
* STILL - [[Still]]
* TANNER - [[Tanner's shop]]
* WOOD - [[Wood furnace]]
* Any custom (raw-defined) building, such as:
** SOAP_MAKER - [[Soap maker's workshop]]
** SCREW_PRESS - [[Screw press]]

Custom reactions cannot be added to the following buildings:
* JEWELER - [[Jeweler's workshop]]

==== Building key ====
This defines the shortcut key(s) used to queue up the reaction in the workshop during gameplay in Classic mode only. It can be NONE for no shortcut, or take the format of CUSTOM_X, where X can be: any uppercase letter, which shows as a lowercase letter in the building UI, eg. "CUSTOM_A" creates the shortcut {{k|a}}; or a valid modifier key (ALT, CTRL, or SHIFT) followed by an uppercase letter, eg. CUSTOM_SHIFT_A.

=== Category ===

Categories are custom submenus for buildings' reaction menus. A reaction doesn't require a category, but if you have a lot of reactions, categories can be invaluable for organizing and presenting those reactions to players.

Categories can be nested indefinitely—you can have a category within a category within a category within a category within a category within... but as a practical matter, nesting categories more than 2 deep is not recommended.

Categories will be displayed in alphabetical order, first off the file name and then off the category name.

Categories currently have no effect on adventure mode reactions.

==== Defining a category ====

Each category needs to be defined within a reaction, usually one which should appear within its menu. Categories only need to be defined once.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description
|-
| style="vertical-align: top"| CATEGORY || style="vertical-align: top"| Category ID || The category ID is a unique identifier for the category. It is only used in the raws, and will not appear in the game.

If you're defining multiple categories within the same reaction - for example, if you intend the reaction to be nested two deep, and haven't yet defined the super-category - the ''last'' CATEGORY token within the reaction definition is the one that the reaction will appear in.
|-
| style="vertical-align: top"| CATEGORY_NAME || style="vertical-align: top"| String || The name of the category as displayed in-game.
|-
| style="vertical-align: top"| CATEGORY_DESCRIPTION || style="vertical-align: top"| String || Optional. If present, when the category is highlighted in a building menu, this string will be displayed in the Helpful Hint box.
|-
| style="vertical-align: top"| CATEGORY_PARENT || style="vertical-align: top"| Category ID || Optional. If present, this category will be a submenu of the indicated category, rather than a submenu of the reaction's building.
|-
| style="vertical-align: top"| CATEGORY_KEY || style="vertical-align: top"| Hotkey token || Optional. If present, this category can be selected from its parent menu (whether a building or a parent category) using the given hotkey. Uses the same format as the BUILDING KEY described above.
|}

==== Adding reactions to an existing category ====

Just include the tag [CATEGORY:<category_id>] within your reaction definition, and if the category exists, your reaction will be added to its menu. You can only add reactions to custom categories.

Each reaction can belong to only one category.

=== Reagents ===

REAGENTs are a little bit complicated. They are the ingredients that the reaction will use. You can define as many as you like within a reaction.

[REAGENT:<name>:<quantity>:<item token>:<material token>][...modifiers...]
* ''[[#Reagent name|name]]'': The name of the reagent, local to the reaction.
* ''[[#Quantity|quantity]]'': The amount of the item that will be used in the reaction.
* ''[[#Item_token|item token]]'': The type (and subtype) of the item you require.
* ''[[#Material_token|material token]]'': The material the item should be made of.
* ''[[#Modifiers|...modifiers...]]'': Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

==== Name ====

The name field is a small string used to identify the reagent within the reaction. The name is not visible to the player. It is local to the reaction and does not need to be unique across all of the reactions, so you can reuse the same names over and over, although each reagent within the same individual reaction must have a different name.

Most reagents are simply named '''A''', '''B''', and so forth in default reactions, although names such as '''TOOLSTONE''', '''FLUX''', or '''seeds''' will also work equally well. The PRODUCT may make reference to this name – for instance, if a container '''B''' is specified as a reagent, PRODUCT_TO_CONTAINER:B specifies that container.

==== Quantity ====

How many or how much of this reagent the reaction requires. For most item types this is just the number of them required. However, some other item types─specifically bars, cloth, thread, globs, liquids, powder, and sheets of paper or parchment─instead use numbers representing the size of the material within one (or more) of these items. For example, while REAGENT:A:'''''10''''':'''''TOY''''':NONE:NONE:NONE is ten unique, solid toy items, REAGENT:A:'''''10''''':'''''THREAD''''':NONE:NONE:NONE is an extremely tiny portion of a random spool of thread. One can see which items have what size quantities in the description of the [[Reaction#PRODUCT_DIMENSION|PRODUCT_DIMENSION]] token.

If one of the reagents is in a stack, or the reaction is only using a fraction of the amount of a sized item, the reaction will consume the entire stack, or as much of the sized item as possible, and multiply the product accordingly. This behaviour can be controlled using the [[Reaction#MAX_MULTIPLIER|MAX_MULTIPLIER]] token.

==== Item token ====

[[Item token]]s are of the form ITEM_TYPE:ITEM_SUBTYPE.

The ITEM_TYPE is the category of item you require; WEAPON, TOY or SKIN_TANNED, for example.

The ITEM_SUBTYPE is name of the exact item that you require. Examples are ITEM_WEAPON_SPEAR or ITEM_TOY_PUZZLEBOX. Some items, like quivers or backpacks, or chunks of stone or metal, have no subtype and only require the item token to be filled in; so if you're asking for those you should set the subtype to NONE. Subtypes are defined within the local raw data files and their exact names can be referenced by looking at the corresponding file.

For reagents, the item token can also be set to ANY_RAW_MATERIAL:NONE (to permit BAR, BOULDER, POWDER_MISC, or GLOB) or ANY_CRAFT:NONE (to permit FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET). Internally, these special values are both converted to NONE:NONE and merely set special modifiers (similar to [BUILDMAT])—they cannot be used in any other context.

For backwards compatibility, reagents can also accept "METAL_ORE:metal_id" in place of both the item and material tokens—this is equivalent to using the reagent BOULDER:NONE:NONE:NONE with the modifier [METAL_ORE:metal_id] (see below).

==== Material token ====

[[Material token]]s come in several forms. For most reagents, this will typically be INORGANIC:MATERIAL_ID or NONE:NONE (to allow multiple materials using other modifier tokens).

Some reactions will allow the player to select specific materials after creating the job (or in [[Reaction#material_token_2|some cases]], armor size from the product), by clicking on the magnifying glass icon next to the job in the workshop queue. To permit this behaviour in your reaction, the reagent materials must be specified as follows:
{| {{prettytable}}
|- bgcolor="#dddddd"
! Item Type
! Material
! Notes
|-
| style="vertical-align: top"| BAR BLOCKS BOULDER ROUGH SMALLGEM || style="vertical-align: top"| INORGANIC:NONE || style="vertical-align: top"| These all appear as "stone" in the material selection menu, and list all inorganic materials regardless of any material modifier tokens, eg. [ITEMS_METAL]. BAR and BLOCKS made of organic materials, and BOULDER made of clay, are excluded.
|-
| style="vertical-align: top"| SKIN_TANNED or WOOD || style="vertical-align: top"| NONE:NONE ||
|-
| style="vertical-align: top"| Other Item Types || style="vertical-align: top"| NONE:NONE || style="vertical-align: top"| These will appear if a material modifier token other than [ANY_LEATHER_MATERIAL] is included.
|}

==== Modifiers ====

Reagents may also have extra tokens added on, following the REAGENT token, in order to modify their behaviour.

Generally speaking, if you set a field in a reagent to NONE, the reaction won't discriminate when it comes to that particular field. For example, if you require a BOULDER reagent but leave the material as NONE:NONE, it will grab any available BOULDER-type item regardless of material. Modifiers can then be used to restrict this to only certain broad classes of materials.

The following is a list of all known reagent modifiers:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description
|-
| style="vertical-align: top"| ANY_BONE_MATERIAL
|
| Reagent material must have the [BONE] token.
|-
| style="vertical-align: top"| ANY_GEM_MATERIAL
|
| Reagent material must have the [IS_GEM] token.
|-
| style="vertical-align: top"| ANY_HORN_MATERIAL
|
| Reagent material must have the [HORN] token.
|-
| style="vertical-align: top"| ANY_LEATHER_MATERIAL
|
| Reagent material must have the [LEATHER] token.
|-
| style="vertical-align: top"| ANY_PEARL_MATERIAL
|
| Reagent material must have the [PEARL] token.
|-
| style="vertical-align: top"| ANY_PLANT_MATERIAL
|
| Reagent material must be subordinate to a PLANT object.
|-
| style="vertical-align: top"| ANY_SHELL_MATERIAL
|
| Reagent material must have the [SHELL] token.
|-
| style="vertical-align: top"| ANY_SILK_MATERIAL
|
| Reagent material must have the [SILK] token.
|-
| style="vertical-align: top"| ANY_SOAP_MATERIAL
|
| Reagent material must have the [SOAP] token.
|-
| style="vertical-align: top"| ANY_STONE_MATERIAL
|
| Reagent material must have the [IS_STONE] token.
|-
| style="vertical-align: top"| ANY_STRAND_TISSUE
|
| Reagent is made of a tissue having TISSUE_SHAPE:STRANDS, intended for matching hair and wool. Must be used with USE_BODY_COMPONENT.
|-
| style="vertical-align: top"| ANY_TOOTH_MATERIAL
|
| Reagent material must have the [TOOTH] token.
|-
| style="vertical-align: top"| ANY_WOOD_MATERIAL
|
| Reagent material must have the [WOOD] token.
|-
| style="vertical-align: top"| ANY_YARN_MATERIAL
|
| Reagent material must have the [YARN] token.
|-
| style="vertical-align: top"| BUILDMAT
|
| Reagent must be a general [[building material]] - BAR, BLOCKS, BOULDER, or WOOD.
|-
| style="vertical-align: top"| CAN_USE_ARTIFACT
|
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.
|-
| style="vertical-align: top"| CONTAINS
| style="vertical-align: top"|
* [[#Reagent name|Reagent name]]
| Reagent is a container that holds the specified reagent (where ''Reagent name'' is the locally-defined name of the reagent).
|-
| style="vertical-align: top"| CONTAINS_LYE
|
| Reagent must be a BARREL or TOOL which contains at least one item of type LIQUID_MISC made of LYE. Use of this token is discouraged, as it does not work with buckets (instead, use [CONTAINS:lye] — note the colon — and a corresponding lye reagent [REAGENT:lye:150:LIQUID_MISC:NONE:LYE]).
|-
| style="vertical-align: top"| DOES_NOT_ABSORB
|
| Reagent material must have ABSORPTION:0
|-
| style="vertical-align: top"| DOES_NOT_DETERMINE_PRODUCT_AMOUNT
|
| Reagent quantity is ignored for the purposes of producing extra outputs. Typically used for containers so that [[stack]]s of reagents will correctly produce additional outputs.
|-
| style="vertical-align: top"| EMPTY
|
| If the reagent is a container, it must be empty.
|-
| style="vertical-align: top"| FIRE_BUILD_SAFE
|
| Reagent material must be solid and stable at temperatures approaching 11000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe.
|-
| style="vertical-align: top"| FOOD_STORAGE_CONTAINER
|
| Reagent is either a BARREL or a TOOL with the FOOD_STORAGE use.
|-
| style="vertical-align: top"| GLASS_MATERIAL
|
| Reagent material must have the IS_GLASS token. All 3 types of [[glass]] have this token hardcoded.
|-
| style="vertical-align: top"| HARD_ITEM_MATERIAL
|
| Reagent material must have the [ITEMS_HARD] token.
|-
| style="vertical-align: top"| HAS_EDGE
|
| Reagent must have an edge.
|-
| style="vertical-align: top"| HAS_ITEM_REACTION_PRODUCT
| style="vertical-align: top"|
* PRODUCT_ID
| Reagent material must have the item reaction product specified by PRODUCT_ID - [[Reaction#Item_reaction_products|see below]] for more details. This can be used interchangeably with HAS_MATERIAL_REACTION_PRODUCT.
|-
| style="vertical-align: top"| HAS_MATERIAL_REACTION_PRODUCT
| style="vertical-align: top"|
* PRODUCT_ID
| Reagent material must have the material reaction product specified by PRODUCT_ID - [[Reaction#Material_reaction_products|see below]] for more details.
|-
| style="vertical-align: top"| HAS_TOOL_USE
| style="vertical-align: top"|
* [[Tool token#TOOL_USE|TOOL_USE]] value
| Reagent must be a [[tool]] with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.
|-
| style="vertical-align: top"| IS_CRAFTED_ARTIFACT{{verify}}
|
| Reagent item must be an artifact.
|-
| style="vertical-align: top"| IS_DIVINE_MATERIAL
|
| Reagent material must have the [DIVINE] token.
|-
| style="vertical-align: top"| IS_SAND_MATERIAL
|
| Reagent material must have the [SOIL_SAND] token.
|-
| style="vertical-align: top"| MAGMA_BUILD_SAFE
|
| Reagent material must be solid and stable at temperatures approaching 12000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe.
|-
| style="vertical-align: top"| METAL_ITEM_MATERIAL
|
| Reagent material must have the [ITEMS_METAL] token.
|-
| style="vertical-align: top"| METAL_ORE
| style="vertical-align: top"|
* Metal ID
| Reagent material must be an ore of the specified metal.
|-
| style="vertical-align: top"| MIN_DIMENSION
| style="vertical-align: top"|
* Integer
| Reagent's item size must be at least as large as ''Integer''. The reagent's item type must be BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, CLOTH, or GLOB for this to work. See [[Reaction#PRODUCT_DIMENSION|PRODUCT_DIMENSION]] below.
|-
| style="vertical-align: top"| NO_EDGE_ALLOWED
|
| Reagent must not have an edge, so must be blunt. Sharp stones (produced using knapping) and most types of weapon/ammo can not be used with this token.
|-
| style="vertical-align: top"| NOT_ARTIFACT{{verify}}
|
| Reagent item must not be an artifact.
|-
| style="vertical-align: top"| NOT_CONTAIN_BARREL_ITEM
|
| If the reagent is a container, it must not contain [[lye]] or [[milk]]. Not necessary if specifying [EMPTY].
|-
| style="vertical-align: top"| NOT_ENGRAVED
|
| Reagent can not be engraved. For example, a memorial slab can not be engraved.
|-
| style="vertical-align: top"| NOT_IMPROVED
|
| Reagent has not been decorated.
|-
| style="vertical-align: top"| NOT_PRESSED
|
| Reagent must not be in the SOLID_PRESSED state.
|-
| style="vertical-align: top"| NOT_WEB
|
| Reagent must be collected (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| style="vertical-align: top"| ON_GROUND
|
| Reagent must be on the ground. Grabs from stockpiles. Does not grab from inventories (workshops, wagon) and causes infinite gathering for reactions in workshop.
|-
| style="vertical-align: top"| POTASHABLE (Deprecated)
|
| Alias for [CONTAINS_LYE].
|-
| style="vertical-align: top"| PRESERVE_REAGENT
|
| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.
|-
| style="vertical-align: top"| REACTION_CLASS
| style="vertical-align: top"|
* CLASS_ID
| Reagent material must have the reaction class specified by CLASS_ID - [[Reaction#Reaction_classes|see below]] for more details.
|-
| style="vertical-align: top"| UNROTTEN
|
| Reagent must not be rotten, mainly for organic materials.
|-
| style="vertical-align: top"| USE_BODY_COMPONENT
|
| Reagent must be a body part (CORPSE or CORPSEPIECE). Must be used even if your reagent item type is CORPSE or CORPSEPIECE, otherwise it will match any item.
|-
| style="vertical-align: top"| WEB_ONLY
|
| Reagent must be undisturbed (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| style="vertical-align: top"| WORTHLESS_STONE_ONLY
|
| Reagent material must be non-[[economic]].
|-
| style="vertical-align: top"| WOVEN_ITEM
|
| Reagent must be a clothing item made of a woven material, ie. plant, silk, or yarn cloth.
|}

=== Products ===

Products are the end product of the reaction. A reaction can have as many products as it likes.

Products are almost identical to reagents, except that they do not need to be named, can't have fields undefined, and don't use the quantity field to determine the product size. Instead, the token [PRODUCT_DIMENSION:X] is tacked on after the PRODUCT token, determining the size of the product.

Products can be produced directly to a container using the [PRODUCT_TO_CONTAINER:''name''] token, where the ''name'' is the [[#Reagent name|name]] of a reagent. This requires the reagent to have the [PRESERVE_REAGENT] token.

Restating this in the above style, we have:
[PRODUCT:<probability>:<quantity>:<item token>:<material token>][...modifiers...]

==== Probability ====

The percentage chance the product will be produced when the reaction is completed. Must be an integer.

==== Quantity ====

Determines how many of the product will be produced. For the item types AMMO, REMAINS, MEAT, FISH, FISH_RAW, PLANT, PLANT_GROWTH, DRINK, CHEESE, LIQUID_MISC, COIN, and EGG, the resulting items will be created as a single [[stack]], while all other item types will produce multiple individual items.

If a reaction can take stacks of input items, then it will attempt to perform the reaction enough times to consume as many full sets of reagents as it can—for example, if a reaction "1 piece of meat + 2 pieces of fish -> 3 pieces of cheese" is given a stack of 5 meat and 5 fish, it will produce 6 pieces of cheese and leave 3 meat and 1 fish behind. Using the token DOES_NOT_DETERMINE_PRODUCT_AMOUNT allows a reagent to be excluded from this calculation - for example, with the reaction "1 plant + 1 barrel -> 5 alcohol (into barrel)", using this on the barrel allows the reaction to be performed as "5 plant + 1 barrel -> 25 alcohol" instead of "5 plant + 5 barrel -> 25 alcohol".

==== Item token ====

The [[item token]] and subtype of the item you produce.

If your item has an [[Reaction#Item reaction products|item reaction product]] and you want the item type and material to be derived from one of the reagents, you can use GET_ITEM_DATA_FROM_REAGENT:reagent:REACTION_PRODUCT_ID in place of both the item token ''and'' the material token (see next section). You can also specify GET_ITEM_DATA_FROM_REAGENT:reagent:NONE in order to make a direct copy of the source item, though this will not work for complex items such as corpses or prepared meals.

For products, this can also be set to CRAFTS:NONE to produce up to three random [[craft]] items. This value cannot be used in any other context.

==== Material token ====

A [[material token]] describing what the product will be made of.

If you want the product's material to be derived from one of the reagents, you can use GET_MATERIAL_FROM_REAGENT:reagent:NONE in place of the material token in order to directly use the reagent's own material; if the reagent has a [[Reaction#Material_reaction_products|material reaction product]] defined, you can use GET_MATERIAL_FROM_REAGENT:reagent:REACTION_PRODUCT_ID to use that.

Similarly to choosing material types for a reagent, if the item product is armor/clothing, and has the appropriate [[Entity_token#Available_resources|armor token]] in the entity file, you will be able to choose the armor/clothing size for different creatures by clicking the magnifying glass of the workshop task. However, this will only work if the product material is [[Modding pitfalls#My_custom_armor.2Fclothing_reaction_won.27t_let_user_choose_size|cloth leather or certain metals]], and the item is also recognized by the related vanilla workshop reaction{{verify}}.

==== Product modifiers ====

Zero or more tokens which further set the properties or disposition of the resulting product item.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description
|-
| style="vertical-align: top"| FORCE_EDGE
|
| Product is given a sharp edge. Used for knapping.
|-
| style="vertical-align: top"| PRODUCT_PASTE
|
| Product is created in the SOLID_PASTE state.
|-
| style="vertical-align: top"| PRODUCT_PRESSED
|
| Product is created in the SOLID_PRESSED state.
|-
| style="vertical-align: top"| PRODUCT_DIMENSION
| style="vertical-align: top"|
* Integer
| Specifies the dimension of the product for those items that use dimensions. For items of type BAR, DRINK, GLOB, LIQUID_MISC, and POWDER_MISC, one item is dimension 150; one item of CLOTH or SHEET is dimension 10000; and one item of THREAD is dimension 15000. Has no effect on any other item types. Note: this is not the actual [[storage]] volume of the product, which is hard-coded by the item token.
|-
| style="vertical-align: top"| PRODUCT_TO_CONTAINER
| style="vertical-align: top"|
* [[#Reagent name|Name]]
| Places the product in a container; ''Name'' must be the name of a reagent with the [PRESERVE_REAGENT] token and a container item type.
|-
| style="vertical-align: top"| PRODUCT_TOKEN
| style="vertical-align: top"|
* [[#Reagent name|Name]]
| Allows the product to be referred to by the given name for the purpose of being passed down as and argument in other tokens, in the same fashion as reagent names.
|-
| style="vertical-align: top"| TRANSFER_ARTIFACT_STATUS
|
| style="vertical-align: top"| Transfers artifact status from the reagent to the product.
|}

=== Improvements ===

Improvements are applied to existing reagents. A reaction can have as many improvements as it likes.

Restating this in the above style, we have:
[IMPROVEMENT:<probability>:<reagent name>:<improvement type>:<material token>]

==== Probability ====
The percentage chance the improvement will be applied to the reagent when the reaction is completed.

==== Reagent name ====
The [[#Reagent name|name]] of the reagent that will be improved. In order to be meaningful, this reagent must have [PRESERVE_REAGENT].

==== Improvement type ====
The following improvement types can be used:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Description
|-
| COVERED
| Item is encrusted/studded/decorated with <material>.
|-
| GLAZED
| Item is glazed with <material>.
|-
| RINGS_HANGING
| Item is adorned with hanging rings of <material>.
|-
| BANDS
| Item is encircled with bands of <material>.
|-
| SPIKES
| Item menaces with spikes of <material>.
|-
| PAGES
| Adds pages to a [[book]].
|-
| SPECIFIC
| With subtype ROLLERS, adds rollers of <material> to a [[scroll]]; with subtype HANDLE, adds a handle of <material> to an item; with subtype TRACTION_BENCH_CHAIN or TRACTION_BENCH_ROPE adds a chain or rope of <material> to an item.
|}

All other item improvement tokens (ART_IMAGE, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE, and ILLUSTRATION) are ignored.

==== Material token ====

A [[material token]] describing what the decoration will be made of.

If you want the product's material to be derived from one of the reagents, and the reagent has a [[Reaction#Material_reaction_products|material reaction product]] defined, you can use GET_MATERIAL_FROM_REAGENT:reagent:REACTION_PRODUCT_ID in place of the material token. You can also specify GET_MATERIAL_FROM_REAGENT:reagent:NONE in order to directly use the reagent's own material.

=== Other tokens ===

==== Fuel ====

The FUEL token means that the reaction requires coke or charcoal to be performed. Fuel is not needed when the reaction is performed at a magma workshop (a [[magma kiln]], [[magma smelter]], or any custom building having [NEEDS_MAGMA]).

==== Skill ====

The [[Skill token|skill tokens]] determine what skill the reaction requires and trains; also how quickly skill is gained, how quickly those skill gains raise attributes, and how skill level affects the quality of the reaction product.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description
|-
| style="vertical-align: top"| SKILL
| style="vertical-align: top"|
* [[Skill token]]
| (Optional) This identifies the skill required to carry out the reaction and is trained when the reaction is performed. Only one skill may be specified; if multiple skill tokens are defined only the last will be used. A reaction with no product will yield no experience gain. A reaction with no SKILL token will complete in a default amount of time.
|-
| style="vertical-align: top"| SKILL_IP
| style="vertical-align: top"|
* Integer
| (Optional, requires SKILL token) This adjusts the amount of skill gained each time the reaction is carried out. The default value is 30; higher values increase the amount of skill gain.
|-
| style="vertical-align: top"| ATTRIBUTE_IP
| style="vertical-align: top"|
* Integer
| (Optional, requires SKILL token) This adjusts the amount of [[Attribute|attribute]] gain that skill gain from this reaction results in. The default value is 10; higher values increase the amount of attribute gain.
|-
| style="vertical-align: top"| SKILL_ROLL_RANGE
| style="vertical-align: top"|
* Range
* Multiplier
| (Optional, requires SKILL token) This changes how much skill level affects the quality of the reaction product. The default is [SKILL_ROLL_RANGE:11:5]. The ''range'' is the base "die roll" and the ''multiplier'' determines how much the dwarf's skill can affect the reaction; the skill roll is random(range) + random((skill level * multipler)/2 + 1) + random((skill level * multipler)/2 + 1), where random(x) gives a random number from 0 to x-1, inclusive (which also means that the minimum for the range is 1). The higher result on the roll, the better. Both numbers can be lowered to make the skill check harder. For example, with the default values a dwarf who is proficient in a skill has a skill level of 5; their roll will be random(11)+random(13)+random(13), meaning this dwarf can roll anywhere from 0 to 34; similarly, unskilled dwarves can roll 0 to 10 while legendary+0 (skill 15) dwarves can roll 0 to 84. If this is changed to [SKILL_ROLL_RANGE:1:8], then instead a proficient dwarf will have random(1)+random(21)+random(21), giving a roll of 0 to 40, with unskilled dwarves always rolling 0 and legendary dwarves going all the way up to 120.

As a consequence, increasing the multiplier will always make legendary dwarves more effective, even if base roll is reduced to its minimum of 1, with the default going up to 84 for default and 90 for [SKILL_ROLL_RANGE:1:6].
|}

==== Max multiplier ====

The [MAX_MULTIPLIER:<#>] token specifies how many times to do the reaction. This can be used to limit stacked reagent use to the specified quantity instead of the whole stack.

==== Automatic ====

The AUTOMATIC token means that the reaction will be queued automatically if the reaction reagents are all present.

This token only works with jobs performed at a [[kiln]], [[smelter]], [[tanner's shop]], [[kitchen]], or custom workshop, and [[standing orders]] allow you to limit which ones trigger; custom reactions performed at a [[quern]], [[millstone]]{{verify}}, [[still]]{{verify}} or [[craftsdwarf's workshop]]{{verify}} cannot be made automatic.

==== Adventure mode enabled ====

The ADVENTURE_MODE_ENABLED token means that this version of the reaction can be used by the wanderers of Adventure Mode without needing to also give the dwarves at home in a fortress access to it. When using this token, it will be allowed for adventurers of any race, without editing entity files. This token does not prevent Fortress Mode usage assuming the reaction also has a usable building assigned and is a {{token|PERMITTED_REACTION|entity}} within the entity file.

==== Description ====

This feature is exclusive to Classic Mode, as no description window pops up when mousing over reactions in workshops in Premium.

The [DESCRIPTION:<string>] token provides a text description of the reaction when it is highlighted in the building UI. Multiple DESCRIPTION tokens can be defined in a reaction, and each will appear on a new line. The pop-up box that contains the description is limited to 325 characters total. Alternatively, this token can reference a DESCRIPTION token in an existing tool definition by replacing ''string'' with USE_TOOL:<ITEM_SUBTYPE>; or an existing instrument definition with USE_INSTRUMENT:<ITEM_SUBTYPE>.

== Reaction classes and products ==

When you're doing things like tanning hides or brewing alcohol, having separate reactions for every single possible raw material is unwieldy and terrible. However, you can let the reaction itself ask the material for details and process them all with the same reaction. There are three types of tags to dictate this behavior.

=== Reaction classes ===

The simplest token is the reaction class. If it is tacked on a material, a reaction can limit reagents to only those materials that have the specified arbitrary [REACTION_CLASS:whatever] identifier.

We want a reaction that smelts iron and flux into pig iron. However, there are a half-dozen different stones that count as flux. Instead of clogging up the smelter job menu with six nearly identical reactions that all take in either dolomite or limestone or marble for the same result, we use a reaction class.

[REACTION:PIG_IRON_MAKING]
[NAME:make pig iron bars]
[BUILDING:SMELTER:NONE]
[REAGENT:A:150:BAR:NO_SUBTYPE:METAL:IRON]
[REAGENT:B:1:BOULDER:NO_SUBTYPE:NONE:NONE]'''[REACTION_CLASS:FLUX]'''
[REAGENT:C:150:BAR:NO_SUBTYPE:COAL:NO_MATGLOSS]
[PRODUCT:100:1:BAR:NO_SUBTYPE:METAL:PIG_IRON][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:SMELT]

Note how reagent B asks for "NONE:NONE" as its material. This means "boulders of any kind as long as they have the reaction class named FLUX". Stuff like calcite, here:

[INORGANIC:CALCITE]
[USE_MATERIAL_TEMPLATE:STONE_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:calcite][DISPLAY_COLOR:7:7:1][TILE:'"']
'''[REACTION_CLASS:FLUX]'''
[ENVIRONMENT_SPEC:LIMESTONE:CLUSTER_SMALL:100]
[ENVIRONMENT_SPEC:MARBLE:CLUSTER_SMALL:100]
[MATERIAL_VALUE:2]
[IS_STONE]
[MELTING_POINT:12902]
[SOLID_DENSITY:2930]

The label itself can be absolutely anything. It's only used to find a match between the material and the reaction. Note that some reaction classes have special meanings to the game itself—notably, the [[site finder]] knows that "FLUX" should be connected to the "Flux stone" filter.

=== Material reaction products ===

But what if it's not all the same what materials the members of the reaction class put out? If a tanner starts working on a bear pelt, a horse hide, some dragon scales and a section of human skin, surely they all can't produce generic boot leather! No, the reaction must get the chance to ask the "reaction class" what the reagent should turn out as. We will declare a material reaction product.

[REACTION:TAN_A_HIDE]
[NAME:tan a hide]
[BUILDING:TANNER:CUSTOM_T]
[REAGENT:flaps of skin:1:NONE:NONE:NONE:NONE][USE_BODY_COMPONENT][UNROTTEN]
'''[HAS_MATERIAL_REACTION_PRODUCT:TAN_MAT]'''
[PRODUCT:100:1:SKIN_TANNED:NONE:'''GET_MATERIAL_FROM_REAGENT:flaps of skin:TAN_MAT''']
[SKILL:TANNER]
[AUTOMATIC]

Where you'd usually have some fresh bodypart with the TAN_MAT reaction class produce some generic SKIN_TANNED, this goes further. Instead of declaring a material, the spool of pattern-ready tailoring leather (SKIN_TANNED) now comes out as whatever the skin flaps' material reaction product (named TAN_MAT) says in the material's definition (GET_MATERIAL_FROM_REAGENT). And what does it say?

[MATERIAL_TEMPLATE:SKIN_TEMPLATE]
[STATE_COLOR:ALL_SOLID:GRAY]
[STATE_NAME:ALL_SOLID:skin]
[STATE_ADJ:ALL_SOLID:skin]
...
[ABSORPTION:100]
'''[MATERIAL_REACTION_PRODUCT:TAN_MAT:LOCAL_CREATURE_MAT:LEATHER]'''
[IMPLIES_ANIMAL_KILL]
[ROTS]

It says that the caller of the TAN_MAT hook always comes out as the LEATHER of whatever creature the skin has been peeled off of (LOCAL_CREATURE_MAT). For example, skin taken from a butchered dog would be turned into dog leather. Change the SKIN_TEMPLATE MATERIAL_REACTION_PRODUCT to TAN_MAT:INORGANIC:GOLD instead and your tanner turns into Midas. Use your imagination.

If the item you're creating should be made of the ''same'' material as the raw material you're using (e.g. if you're carving a log into a training spear), you can specify "NONE" instead of the MATERIAL_REACTION_PRODUCT code:

[REACTION:MAKE WOODEN TRAINING SPEAR]
[NAME:make wooden training spear]
[BUILDING:CARPENTER:NONE]
[REAGENT:log:1:WOOD:NONE:NONE:NONE][ANY_PLANT_MATERIAL]
[PRODUCT:100:1:WEAPON:ITEM_WEAPON_SPEAR_TRAINING:'''GET_MATERIAL_FROM_REAGENT:log:NONE''']
[SKILL:CARPENTRY]

As with reaction classes, some MATERIAL_REACTION_PRODUCT identifiers have special meanings to the game itself - notably, the [[site finder]] knows that "FIRED_MAT" should be connected to the "Clay" filter, and "CHEESE_MAT" is used when making [[cheese]] from [[milk]].

=== Item reaction products ===

Item reaction products are an even more powerful form of the above. Where material reaction products can only affect what type of stuff the predestined end product is made of, item reaction products can decide the entire end result ahead of time. Item AND material.

Let's assume for a moment that we're completely tired of leather earrings and hair crowns. We want a crafting reaction that takes cloth and only produces things that make sense.

[REACTION:TAILOR_THE_BEST_THING]
[NAME:weave something that makes sense]
[BUILDING:CRAFTSMAN]
[REAGENT:woven fabric:1:CLOTH:NONE:NONE:NONE]
'''[HAS_ITEM_REACTION_PRODUCT:BEST_OPTION]'''
[PRODUCT:100:1:'''GET_ITEM_DATA_FROM_REAGENT:woven fabric:BEST_OPTION''']
[SKILL:CLOTHIER]

Now we need to come up with the counterpart tags in the materials. Hmmm... cotton is thin and soft, so it makes pretty good undergarments. An undershirt, maybe?

[PLANT:COTTON] Gossypium hirsutum / sp.
[NAME:cotton plant][NAME_PLURAL:cotton plants][ADJ:cotton plant]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[DRY][BIOME:ANY_TROPICAL]
[VALUE:2]
...
[USE_MATERIAL_TEMPLATE:THREAD:THREAD_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
'''[ITEM_REACTION_PRODUCT:BEST_OPTION:ARMOR:ITEM_ARMOR_TUNIC:LOCAL_PLANT_MAT:THREAD]'''
...

Then jute fabric. Isn't that burlap? And what's about the only thing they make from burlap?

[PLANT:JUTE] Corchorus capsularis / Corchorus olitorius
[NAME:jute plant][NAME_PLURAL:jute plants][ADJ:jute plant]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[DRY][BIOME:ANY_TROPICAL]
[VALUE:2]
...
[USE_MATERIAL_TEMPLATE:THREAD:THREAD_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
'''[ITEM_REACTION_PRODUCT:BEST_OPTION:BAG:NONE:LOCAL_PLANT_MAT:THREAD]'''
...

Sacks, of course! Wait, how about silk?

[CREATURE:SPIDER_CAVE]
[DESCRIPTION:A tiny underground bug, sought after for its thread.]
[NAME:cave spider:cave spiders:cave spider]
...
[USE_MATERIAL_TEMPLATE:SILK:SILK_TEMPLATE]
'''[ITEM_REACTION_PRODUCT:BEST_OPTION:PANTS:ITEM_PANTS_THONG:LOCAL_CREATURE_MAT:SILK]'''
...

This goes on for as long as you let it. The ITEM_REACTION_PRODUCT declares the identifier and then the item and material with subtypes, just like a normal reaction's product line would.

Do note that MATERIAL_REACTION_PRODUCT and ITEM_REACTION_PRODUCT use the same IDs, so you cannot have both a material and item reaction product of the same name. Also, though you cannot use GET_ITEM_DATA_FROM_REAGENT with a MATERIAL_REACTION_PRODUCT (there'd be no item type information), you ''can'' use GET_MATERIAL_FROM_REAGENT on an ITEM_REACTION_PRODUCT (in case you want to force your own item type).

== Reactions and world generation ==

There are several things to keep in mind when you're adding reactions to a game that already exists.

* Most entity changes require a regen, but adding PERMITTED_REACTION tokens for reactions that existed at the time of world generation to the entity file in the save directory do not.
* Adding reactions to the raws in a save directory requires you to regen the world.
* You can alter an existing reaction in any way you like without regenning the world, so long as you don't alter the reaction identifier.

== Full token list ==

For the sake of convenience and readability, this is a complete compilation of the previously listed reaction tokens in alphabetical order:

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

|-
| style="vertical-align: top"| {{text anchor|ADVENTURE_MODE_ENABLED}}
|
|
| style="vertical-align: top"| This version of the reaction can be used by the wanderers of Adventure Mode without needing to also give the dwarves at home in a fortress access to it. When using this token, it will be allowed for adventurers of any race, without editing entity files. This token does not prevent Fortress Mode usage.

|-
| style="vertical-align: top"| {{text anchor|ANY_BONE_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [BONE] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_GEM_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [IS_GEM] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_HORN_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [HORN] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_LEATHER_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [LEATHER] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_PEARL_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [PEARL] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_PLANT_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must be subordinate to a PLANT object.

|-
| style="vertical-align: top"| {{text anchor|ANY_SHELL_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [SHELL] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_SILK_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [SILK] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_SOAP_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [SOAP] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_STONE_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [IS_STONE] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_STRAND_TISSUE}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT].

|-
| style="vertical-align: top"| {{text anchor|ANY_TOOTH_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [TOOTH] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_WOOD_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [WOOD] token.

|-
| style="vertical-align: top"| {{text anchor|ANY_YARN_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [YARN] token.

|-
| style="vertical-align: top"| {{text anchor|ATTRIBUTE_IP}}
| style="vertical-align: top"|
* Integer
| style="vertical-align: top"| Skill modifier
| style="vertical-align: top"| Amount of attribute gain given per skill improvement. Default is 10.

|-
| style="vertical-align: top"| {{text anchor|AUTOMATIC}}
|
|
| style="vertical-align: top"| The reaction will be queued automatically if the reaction reagents are all present.

|-
| style="vertical-align: top"| {{text anchor|BAG}} (Deprecated)
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent has to be a bag. Intended to be used with an item type of BOX, to prevent chests, coffers, and other containers from being used instead. Deprecated as of Version 0.50.01 in favor of BAG:NONE [[item token]].

|-
| style="vertical-align: top"| {{text anchor|BUILDING}}
| style="vertical-align: top"|
* [[#building name|Building name]]
* [[#building key|In-building reaction hotkey]]
|
| style="vertical-align: top"| Sets the building that the reaction will be performed in, and the button used to queue the reaction once that building's menu is accessed in-game.

|-
| style="vertical-align: top"| {{text anchor|BUILDMAT}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent is able to be used to build structures (Boulders, Wood, Blocks, Bars).

|-
| style="vertical-align: top"| {{text anchor|CAN_USE_ARTIFACT}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.

|-
| style="vertical-align: top"| {{text anchor|CAN_USE_HOSPITAL_RESERVED}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Allows the reagent to be an item that is otherwise reserved for use by a [[healthcare|hospital]].

|-
| style="vertical-align: top"| {{text anchor|CAN_USE_LOCATION_RESERVED}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Allows the reagent to be an item that is otherwise reserved for use by a [[locations|location]].

|-
| style="vertical-align: top"| {{text anchor|CATEGORY}}
| style="vertical-align: top"|
* Category ID
|
| style="vertical-align: top"| Puts the reaction in a category. Categories are custom submenus for reaction menus. The category ID is a unique identifier for the category. It is only used in the raws, and will not appear in the game.

If you're defining multiple categories within the same reaction - for example, if you intend the reaction to be nested two deep, and haven't yet defined the super-category - the ''last'' CATEGORY token within the reaction definition is the one that the reaction will appear in.

|-
| style="vertical-align: top"| {{text anchor|CATEGORY_NAME}}
| style="vertical-align: top"|
* String
| style="vertical-align: top"| Category
| style="vertical-align: top"| The name of the category as displayed in-game.

|-
| style="vertical-align: top"| {{text anchor|CATEGORY_DESCRIPTION}}
| style="vertical-align: top"|
* String
| style="vertical-align: top"| Category
| style="vertical-align: top"| If present, when the category is highlighted in a building menu, this string will be displayed in the Helpful Hint box.

|-
| style="vertical-align: top"| {{text anchor|CATEGORY_PARENT}}
| style="vertical-align: top"|
* Category ID
| style="vertical-align: top"| Category
| style="vertical-align: top"| If present, this category will be a submenu of the indicated category, rather than a submenu of the reaction's building.

|-
| style="vertical-align: top"| {{text anchor|CATEGORY_KEY}}
| style="vertical-align: top"|
* Hotkey
| style="vertical-align: top"| Category
| style="vertical-align: top"| If present, this category can be selected from its parent menu (whether a building or a parent category) using the given hotkey while playing in Classic mode.

|-
| style="vertical-align: top"| {{text anchor|CONTAINS}}
| style="vertical-align: top"|
* [[#Reagent name|Reagent name]]
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent is a container that holds the specified reagent.

|-
| style="vertical-align: top"| {{text anchor|CONTAINS_LYE}} (Deprecated)
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| If the reagent is a container, it must contain LYE. No longer used - instead, use one reagent for the LYE itself and another reagent with [CONTAINS:lye_reagent].

|-
| style="vertical-align: top"| {{text anchor|DESCRIPTION}}
| style="vertical-align: top"|
* String
|
| style="vertical-align: top"| A description of the reaction that appears when it is highlighted in the building UI. ''String'' can also be replaced with a reference to existing DESCRIPTION tokens in tools (using USE_TOOL:<tool_id>) or musical instruments (using USE_TOOL:<instrument_id>).

|-
| style="vertical-align: top"| {{text anchor|DOES_NOT_ABSORB}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have [ABSORPTION:0].

|-
| style="vertical-align: top"| {{text anchor|DOES_NOT_DETERMINE_PRODUCT_AMOUNT}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Performing a reaction with large [[stack]]s of inputs can allow multiple sets of outputs to be produced. Setting this flag causes the reagent to be ignored in this process - for example, with the reaction "1 plant + 1 barrel -> 5 alcohol (into barrel)", using this on the barrel allows the reaction to be performed as "5 plant + 1 barrel -> 25 alcohol" instead of "5 plant + 5 barrel -> 25 alcohol".

|-
| style="vertical-align: top"| {{text anchor|EMPTY}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| If the reagent is a container, it must be empty.

|-
| style="vertical-align: top"| {{text anchor|FIRE_BUILD_SAFE}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must be considered [[fire-safe]] (stable [[temperature]] below {{ct|11000}}) - i.e. not wood, and not coal.

|-
| style="vertical-align: top"| {{text anchor|FORCE_EDGE}}
|
| style="vertical-align: top"| Product modifier
| style="vertical-align: top"| Product is given a sharp edge. Used for knapping.

|-
| style="vertical-align: top"| {{text anchor|FOOD_STORAGE_CONTAINER}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must be a barrel or any non-absorbing tool with [TOOL_USE:FOOD_STORAGE].

|-
| style="vertical-align: top"| {{text anchor|FUEL}}
|
|
| style="vertical-align: top"| Requires that the reaction either use up a unit of coal or charcoal or else be performed at a magma workshop.

|-
| style="vertical-align: top"| {{text anchor|GLASS_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material has [IS_GLASS].

|-
| style="vertical-align: top"| {{text anchor|HAS_EDGE}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must be sharpened (used for carving).

|-
| style="vertical-align: top"| {{text anchor|HAS_ITEM_REACTION_PRODUCT}}
| style="vertical-align: top"|
* PRODUCT_ID (custom)
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Similar to HAS_MATERIAL_REACTION_PRODUCT, but requires the reagents material to have a matching ITEM_REACTION_PRODUCT entry.

|-
| style="vertical-align: top"| {{text anchor|HAS_MATERIAL_REACTION_PRODUCT}}
| style="vertical-align: top"|
* PRODUCT_ID (custom)
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Similar to REACTION_CLASS, but requires the reagents material to have a matching [[Material definition token|MATERIAL_REACTION_PRODUCT]] entry. Intended for reactions which transform one class of material into another, such as skin->leather and fat->tallow.

|-
| style="vertical-align: top"| {{text anchor|HAS_TOOL_USE}}
| style="vertical-align: top"|
* [[Tool token#TOOL_USE|TOOL_USE value]]
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must be a [[tool]] with the specific TOOL_USE value. The reagents item type must be TOOL:NONE for this to make any sense.

|-
| style="vertical-align: top"| {{text anchor|HAS_WRITING_IMPROVEMENT}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must contain writing.

|-
| style="vertical-align: top"| {{text anchor|IMPROVEMENT}}
| style="vertical-align: top"|
* Probability
* [[#Reagent name|Reagent name]]
* Improvement type
* Material Token
|
| style="vertical-align: top"| Applies an improvement to the named reagent. Only meaningful if said reagent has [PRESERVE_REAGENT]. Improvement types include BANDS, COVERED, GLAZED, PAGES, RINGS_HANGING, and SPIKES

|-
| style="vertical-align: top"| {{text anchor|IS_CRAFTED_ARTIFACT}}{{verify}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent item must be an artifact.

|-
| style="vertical-align: top"| {{text anchor|IS_DIVINE_MATERIAL}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must have the [DIVINE] token.

|-
| style="vertical-align: top"| {{text anchor|MAGMA_BUILD_SAFE}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Currently broken - Reagent must be considered [[magma-safe]] (stable [[temperature]] below {{ct|12000}}).

|-
| style="vertical-align: top"| {{text anchor|MAX_MULTIPLIER}}
| style="vertical-align: top"|
* Integer
|
| style="vertical-align: top"| Sets the maximum number of times a reaction is allowed to run when using stacked reagents. This can be used to ensure that the reaction doesn't repeat until the entire stack is depleted.

|-
| style="vertical-align: top"| {{text anchor|METAL_ORE}}
| style="vertical-align: top"|
* Inorganic material
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must be an ore of the specified metal.

|-
| style="vertical-align: top"| {{text anchor|MIN_DIMENSION}}
| style="vertical-align: top"|
* Integer
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Requires that the reagent have a size of at least ''integer''. Only effective with BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, CLOTH, and GLOB items.

|-
| style="vertical-align: top"| {{text anchor|NAME}}
| style="vertical-align: top"|
* [[#name|Name]]
|
| style="vertical-align: top"| Defines the name used by the reaction in-game.

|-
| style="vertical-align: top"| {{text anchor|NO_EDGE_ALLOWED}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must not have an edge, so must be blunt. Sharp stones (produced using knapping) and most types of weapon/ammo can not be used with this token.

|-
| style="vertical-align: top"| {{text anchor|NOT_ARTIFACT}}{{verify}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent item must not be an artifact.

|-
| style="vertical-align: top"| {{text anchor|NOT_CONTAIN_BARREL_ITEM}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| If the reagent is a Barrel, it must not contain an item that has to reside in a barrel. Barrel items appear to be lye and milk. Alcohol appears to be covered as part of [EMPTY]. A reaction which places an item in a barrel should probably have both tags.

|-
| style="vertical-align: top"| {{text anchor|NOT_ENGRAVED}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent has not been engraved i.e. a blank memorial slab.
|-
| style="vertical-align: top"| {{text anchor|NOT_IMPROVED}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent has not been decorated.

|-
| style="vertical-align: top"| {{text anchor|NOT_PRESSED}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must not be in the SOLID_PRESSED state.

|-
| style="vertical-align: top"| {{text anchor|NOT_WEB}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must be "collected" - used with THREAD:NONE to exclude webs.

|-
| style="vertical-align: top"| {{text anchor|ON_GROUND}}
|
| style="vertical-align: top"| Reagent modifier
| Reagent must be on the ground. Grabs from stockpiles. Does not grab from bins in stockpiles, nor inventories (workshops, wagon). Causes infinite collection of items if reaction is in workshop, as reagents are no longer on ground when brought to workshop. Untested in adventure mode; possibly more useful for adv. mode reactions.

|-
| style="vertical-align: top"| {{text anchor|POTASHABLE}} (Deprecated)
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Alias for [CONTAINS_LYE].

|-
| style="vertical-align: top"| {{text anchor|PRESERVE_REAGENT}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.

|-
| style="vertical-align: top"| {{text anchor|PRODUCT}}
| style="vertical-align: top"|
*Probability of success (%)
*Quantity
*Item token:subtype
*Material token:subtype
|
| style="vertical-align: top"| Defines a thing that comes out of the reaction. GET_MATERIAL_FROM_REAGENT and GET_ITEM_DATA_FROM_REAGENT can be used to defer the choice of material and/or item to the appropriate tag in a given reagent's material - the former comes in place of the material token, the latter replaces both the item and material tokens. See above for detailed information on how the hooks work.

|-
| style="vertical-align: top"| {{text anchor|PRODUCT_DIMENSION}}
| style="vertical-align: top"|
* Size
| style="vertical-align: top"| Product modifier
| style="vertical-align: top"| Specifies the amount of the product for those items that use dimension. For items of type BAR, DRINK, GLOB, LIQUID_MISC, and POWDER_MISC, one item is dimension 150; one item of CLOTH or SHEET is dimension 10000; and one item of THREAD is dimension 15000. Has no effect on any other item types. Note: this is not the actual [[storage]] volume of the product, which is hard-coded by the item token.

|-
| style="vertical-align: top"| {{text anchor|PRODUCT_PASTE}}
|
| style="vertical-align: top"| Product modifier
| style="vertical-align: top"| Product is created in the SOLID_PASTE state.

|-
| style="vertical-align: top"| {{text anchor|PRODUCT_PRESSED}}
|
| style="vertical-align: top"| Product modifier
| style="vertical-align: top"| Product is created in the SOLID_PRESSED state.

|-
| style="vertical-align: top"| {{text anchor|PRODUCT_TO_CONTAINER}}
| style="vertical-align: top"|
* [[#Reagent name|Reagent name]]
| style="vertical-align: top"| Product modifier
| style="vertical-align: top"| Places the product in a container; reagent name must be the name of a reagent with the [PRESERVE_REAGENT] token and a container item type.

|-
| style="vertical-align: top"| {{text anchor|PRODUCT_TOKEN}}
| style="vertical-align: top"|
* Name
| style="vertical-align: top"| Product modifier
| style="vertical-align: top"| Allows the product to be referred to by the given name, for the purpose of being passed down as argument in other tokens in the same fashion as reagent names.

|-
| style="vertical-align: top"| {{text anchor|REACTION}}
| style="vertical-align: top"|
* Identifier
|
| style="vertical-align: top"| Defines a new reaction.

|-
| style="vertical-align: top"| {{text anchor|REACTION_CLASS}}
| style="vertical-align: top"|
* CLASS_ID (custom)
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Requires the reagent's material to have a matching [[Material definition token|REACTION_CLASS]] entry. Intended for reactions which accept a variety of materials but where the input material does not determine the output material, such as FLUX (for making pig iron and steel) and GYPSUM (for producing plaster powder).

|-
| style="vertical-align: top"| {{text anchor|REAGENT}}
| style="vertical-align: top"|
* [[#Reagent name|Reagent name]]
* [[#quantity|Quantity]]
* [[Item token]]
* [[Material token]]
|
| style="vertical-align: top"| Specifies a given reagent as an input for a reaction.

|-
| style="vertical-align: top"| {{text anchor|SKILL}}
| style="vertical-align: top"|
* [[Skill token]]
|
| style="vertical-align: top"| Skill used by the reaction.

|-
| style="vertical-align: top"| {{text anchor|SKILL_IP}}
| style="vertical-align: top"|
* Integer
| style="vertical-align: top"| Skill modifier
| style="vertical-align: top"| Amount of skill given per product made. Default is 30.

|-
| style="vertical-align: top"| {{text anchor|SKILL_ROLL_RANGE}}
| style="vertical-align: top"|
* Range
* Multiplier
| style="vertical-align: top"| Skill modifier
| style="vertical-align: top"| Determines how [[skill]] level affects [[quality]] of the reaction product. The skill roll is random(range) + random((skill level * multipler)/2 + 1) + random((skill level * multipler)/2 + 1). random(x) returns a number between 0 and x-1, so range is always 1 or more. The default is 11. The default multiplier is 5. Higher skill rolls give better results.

|-
| style="vertical-align: top"| {{text anchor|TRANSFER_ARTIFACT_STATUS}}
|
| style="vertical-align: top"| Product modifier
| style="vertical-align: top"| Transfers artifact status from the reagent to the product.

|-
| style="vertical-align: top"| {{text anchor|UNROTTEN}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must not be rotten, mainly for organic materials.

|-
| style="vertical-align: top"| {{text anchor|USE_BODY_COMPONENT}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must come off a creature's body.

|-
| style="vertical-align: top"| {{text anchor|WEB_ONLY}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must be "undisturbed" - used with THREAD:NONE to gather webs.

|-
| style="vertical-align: top"| {{text anchor|WORTHLESS_STONE_ONLY}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent is not made of an economic stone.

|-
| style="vertical-align: top"| {{text anchor|WOVEN_ITEM}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent material must be a woven material, eg. plant cloth, silk, yarn. This ''excludes'' CLOTH or THREAD items.

|}

== Examples ==
:''Main articles: [[Reaction Examples]]''

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Reaction]]

Material definition token

2024-08-01T21:59:57Z

Putnam3145: mouths too actually

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

The following [[token]]s can be used in [[material]] definitions (whether for inorganics or those within plants and creatures) as well as in [[:Category:material template raw pages|material templates]].

__TOC__
{{clear}}

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

|-
| {{text_anchor|USE_MATERIAL_TEMPLATE}}
|
* <template name>
| Resets all material tokens back to their default values, then imports the tokens of the specified preexisting material template (overriding any tokens defined prior to itself in the material). This means USE_MATERIAL_TEMPLATE should be the first token present in any material using it. It cannot be used inside of a [MATERIAL_TEMPLATE:X] which prevents the creation of nested material template structures.

|-
| {{text_anchor|PREFIX}}
|
* <prefix> or NONE
| Applies a prefix to all items made from the material. For PLANT and CREATURE materials, this defaults to the plant/creature name. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|STONE_NAME}}
|
* <name>
| Overrides the name of [[Item_token#BOULDER|BOULDER]] items (i.e. mined-out stones) made of the material (used for native copper/silver/gold/platinum to make them be called "nuggets" instead of "boulders").

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

|-
| {{text_anchor|TEMP_DIET_INFO}}
|
* <type>
| Specifies what the material should be treated as when drinking water contaminated by it, for generating unhappy [[thought]]s. Valid values are BLOOD, SLIME, VOMIT, ICHOR, PUS, GOO, GRIME, and FILTH.

|-
| {{text_anchor|POWDER_DYE}}
|
*<[[Color#Color_tokens|color token]]>
| Allows the material to be used as [[dye]], and defines color of dyed items.

|-
| {{text_anchor|TILE}}
|
*<[[Main:Character table|tile value or character]]>
| Specifies the tile that will be used to represent unmined tiles made of this material. Generally only used with stones. Defaults to 219 ('█').

|-
| {{text_anchor|ITEM_SYMBOL}}
|
*<[[Main:Character table|tile value or character]]>
| Specifies the tile that will be used to represent [[Item_token#BOULDER|BOULDER]] items made of this material. Generally only used with stones. Defaults to 7 ('•').

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

|-
| {{text_anchor|BUILD_COLOR}}
|
*<[[Color#Color_values|foreground color]]>
*<[[Color#Color_values|background color]]>
*<[[Color#Color_values|foreground brightness]]>
| The color of objects made of this material which use both the foreground and background color: [[door]]s, [[floodgate]]s, [[hatch cover]]s, [[bin]]s, [[barrel]]s, and [[cage]]s. Defaults to 7:7:1 (white).

|-
| {{text_anchor|TILE_COLOR}}
|
*<[[Color#Color_values|foreground color]]>
*<[[Color#Color_values|background color]]>
*<[[Color#Color_values|foreground brightness]]>
| The color of unmined tiles containing this material (for stone and soil), as well as [[engraving]]s in this material. Defaults to 7:7:1 (white).

|-
| {{text_anchor|BASIC_COLOR}}
|
*<[[Color#Color_values|foreground color]]>
*<[[Color#Color_values|foreground brightness]]>
| The color of objects made of this material which use only the foreground color, including workshops, floors and boulders, and smoothed walls. Defaults to 7:1 (white).

|-
| {{text_anchor|STATE_COLOR}}
|
*<[[Material_definition_token#Material States|material state]]>
*<[[Color#Color_tokens|color token]]>
| Determines the color of the material at the specified state. See [[Material_definition_token#Material states|below]] for a list of valid material states. Color comes from descriptor_color_standard.txt. The nearest color value is used to display contaminants and body parts made of this material in ASCII and to color items and constructions made from this material with graphics. Example:
[STATE_COLOR:ALL_SOLID:GRAY]

|-
| {{text_anchor|STATE_NAME}}
|
*<[[Material_definition_token#Material States|material state]]>
*<name>
| Determines the name of the material at the specified state, as displayed in-game.
[STATE_NAME:ALL_SOLID:stone]

|-
| {{text_anchor|STATE_ADJ}}
|
*<[[Material_definition_token#Material States|material state]]>
*<adjective>
| Like [[Material_definition_token#STATE_NAME|STATE_NAME]], but used in different situations. Equipment made from the material uses the state adjective and not the state name.

|-
| {{text_anchor|STATE_NAME_ADJ}}
|
*<[[Material_definition_token#Material States|material state]]>
*<name>
*<adjective>
| Sets both [[Material_definition_token#STATE_NAME|STATE_NAME]] and [[Material_definition_token#STATE_ADJ|STATE_ADJ]] at the same time.

|-
| {{text_anchor|ABSORPTION}}
|
*<value>
| The material's tendency to absorb liquids. Containers made of materials with nonzero absorption cannot hold liquids unless they have been [[glaze]]d. Defaults to 0.

|-
| {{text_anchor|IMPACT_YIELD}}
|
*<value>
| Specifies how hard of an impact (in kilopascals) the material can withstand before it will start deforming permanently. Used for blunt-force combat. Defaults to 10000.

|-
| {{text_anchor|IMPACT_FRACTURE}}
|
*<value>
| Specifies how hard of an impact the material can withstand before it will fail entirely. Used for blunt-force combat. Defaults to 10000.

|-
| {{text_anchor|IMPACT_STRAIN_AT_YIELD}} or {{text_anchor|IMPACT_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given (in parts-per-100000) when the yield point is reached. Used for blunt-force combat. Defaults to 0. Apparently affects in combat whether the corresponding tissue is bruised (value >= 50000), torn (value between 25000 and 49999), or fractured (value <= 24999)

|-
| {{text_anchor|COMPRESSIVE_YIELD}}
|
*<value>
| Specifies how hard the material can be compressed before it will start deforming permanently. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 10000.

|-
| {{text_anchor|COMPRESSIVE_FRACTURE}}
|
*<value>
| Specifies how hard the material can be compressed before it will fail entirely. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 10000.

|-
| {{text_anchor|COMPRESSIVE_STRAIN_AT_YIELD}} or {{text_anchor|COMPRESSIVE_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when it has been compressed to its yield point. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 0.

|-
| {{text_anchor|TENSILE_YIELD}}
|
*<value>
| Specifies how hard the material can be stretched before it will start deforming permanently. Determines a tissue's resistance to a latching and tearing bite. Defaults to 10000.

|-
| {{text_anchor|TENSILE_FRACTURE}}
|
*<value>
| Specifies how hard the material can be stretched before it will fail entirely. Determines a tissue's resistance to a latching and tearing bite. Defaults to 10000.

|-
| {{text_anchor|TENSILE_STRAIN_AT_YIELD}} or {{text_anchor|TENSILE_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when it is stretched to its yield point. Determines a tissue's resistance to a latching and tearing bite. Defaults to 0.

|-
| {{text_anchor|TORSION_YIELD}}
|
*<value>
| Specifies how hard the material can be twisted before it will start deforming permanently. Used for latching and shaking with a blunt attack (certain generated creatures can do this). Defaults to 10000.

|-
| {{text_anchor|TORSION_FRACTURE}}
|
*<value>
| Specifies how hard the material can be twisted before it will fail entirely. Used for latching and shaking with a blunt attack (certain generated creatures can do this). Defaults to 10000.

|-
| {{text_anchor|TORSION_STRAIN_AT_YIELD}} or {{text_anchor|TORSION_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when it is twisted to its yield point. Used for latching and shaking with a blunt attack (certain generated creatures can do this). Defaults to 0.

|-
| {{text_anchor|SHEAR_YIELD}}
|
*<value>
| Specifies how hard the material can be sheared before it will start deforming permanently. Used for cutting calculations. Defaults to 10000.

|-
| {{text_anchor|SHEAR_FRACTURE}}
|
*<value>
| Specifies how hard the material can be sheared before it will fail entirely. Used for cutting calculations. Defaults to 10000.

|-
| {{text_anchor|SHEAR_STRAIN_AT_YIELD}} or {{text_anchor|SHEAR_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when sheared to its yield point. Used for cutting calculations. Defaults to 0.

|-
| {{text_anchor|BENDING_YIELD}}
|
*<value>
| Specifies how hard the material can be bent before it will start deforming permanently. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 10000.

|-
| {{text_anchor|BENDING_FRACTURE}}
|
*<value>
| Specifies how hard the material can be bent before it will fail entirely. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 10000.

|-
| {{text_anchor|BENDING_STRAIN_AT_YIELD}} or {{text_anchor|BENDING_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when bent to its yield point. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 0.

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

|-
| {{text_anchor|MATERIAL_VALUE}}
|
*<value>
| Value modifier for the material. Defaults to 1. This number can be made negative by placing a "-" in front, resulting in things that you are paid to buy and must pay to sell.

|-
| {{text_anchor|MULTIPLY_VALUE}}
|
*<value>
| Multiplies the value of the material. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|SPEC_HEAT}}
|
*<specific heat capacity>
| Rate at which the material heats up or cools down (in joules/kilogram-kelvin). If set to NONE, the temperature will be fixed at its initial value. See [[Temperature]] for more information. Defaults to NONE.

|-
| {{text_anchor|HEATDAM_POINT}}
|
*<temperature>
| Temperature above which the material takes damage from heat. May be set to NONE. If the material has an ignite point but no heatdam point, it will burn for a very long time (9 months and 16.8 days). Defaults to NONE.

|-
| {{text_anchor|COLDDAM_POINT}}
|
*<temperature>
| Temperature below which the material takes damage from cold. Defaults to NONE.

|-
| {{text_anchor|IGNITE_POINT}}
|
*<temperature>
| Temperature at which the material will catch fire. Defaults to NONE.

|-
| {{text_anchor|MELTING_POINT}}
|
*<temperature>
| Temperature at which the material melts. Defaults to NONE.

|-
| {{text_anchor|BOILING_POINT}}
|
*<temperature>
| Temperature at which the material boils. Defaults to NONE.

|-
| {{text_anchor|MAT_FIXED_TEMP}}
|
*<temperature>
| Items composed of this material will initially have this temperature. Used in conjunction with <code>[SPEC_HEAT:NONE]</code> to make material's temperature fixed at the specified value. Defaults to NONE.

|-
| {{text_anchor|IF_EXISTS_SET_HEATDAM_POINT}}
|
*<temperature>
| Changes a material's HEATDAM_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_COLDDAM_POINT}}
|
*<temperature>
| Changes a material's COLDDAM_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_IGNITE_POINT}}
|
*<temperature>
| Changes a material's IGNITE_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_MELTING_POINT}}
|
*<temperature>
| Changes a material's MELTING_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_BOILING_POINT}}
|
*<temperature>
| Changes a material's BOILING_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_MAT_FIXED_TEMP}}
|
*<temperature>
| Changes a material's MAT_FIXED_TEMP, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|SOLID_DENSITY}}
|
*<density>
| Specifies the density (in kilograms per cubic meter) of the material when in solid form. Also affects combat calculations; affects blunt-force damage and ability of weak-in-impact-yield blunt attacks to pierce armor. Defaults to NONE.

|-
| {{text_anchor|LIQUID_DENSITY}}
|
*<density>
| Specifies the density of the material when in liquid form. Defaults to NONE. Also affects combat calculations; affects blunt force damage like SOLID_DENSITY, but only for attacks made by liquids (e.g. forgotten beasts made of water).

|-
| {{text_anchor|MOLAR_MASS}}
|
*<value>
| Specifies (in kg/mol) the molar mass of the material in gaseous form. Only affects combat calculations like the densities, and only for attacks made by gases (e.g. forgotten beasts made of steam).

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

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

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

|-
| {{text_anchor|BLOCK_NAME}}
|
*<singular>
*<plural>
| Specifies the name of [[block]]s made from this material.

|-
| {{text_anchor|WAFERS}}
|
| The material forms "wafers" instead of "[[bar]]s".

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

|-
| {{text_anchor|ITEM_REACTION_PRODUCT}}
|
*<item reference>
*<[[item token]]>
*<[[material token]]>
| Used with reaction raws to associate a reagent material with a complete item. The first argument is used by HAS_ITEM_REACTION_PRODUCT and GET_ITEM_DATA_FROM_REAGENT in reaction raws. The rest refers to the type of item, then its material.
[ITEM_REACTION_PRODUCT:BAG_ITEM:PLANT_GROWTH:LEAVES:LOCAL_PLANT_MAT:LEAF]

|-
| {{text_anchor|REACTION_CLASS}}
|
*<reaction class name>
| Used to classify all items made of the material, so that reactions can use them as generic reagents.
In default raws, the following are used:
* FAT, TALLOW, SOAP, PARCHMENT, PAPER_PLANT, PAPER_SLURRY, MILK, CHEESE, WAX
* CAN_GLAZE - items made from this material can be glazed.
* FLUX - can be used as [[flux]] in pig iron and steel making.
* GYPSUM - can be processed into [[gypsum plaster]].
* CALCIUM_CARBONATE - can be used in production of [[quicklime]].

|-
| {{text_anchor|METAL_ORE}}
|
* <inorganic material name e.g. [[lead|LEAD]]>
* <value>
| Makes BOULDER acceptable as a [[Reactions#Reagents|reagent]] in reactions that require [[Item_token#Related_Tokens|"METAL_ORE:MATERIAL_NAME"]], as well as [[Smelter|smelting]] directly into metal [[bar]]s. Places the material under "Metal Ores" in Stone stockpiles. The specified value determines the probability for this product (see [[Tetrahedrite]] or [[Galena]] for details).

|-
| {{text_anchor|THREAD_METAL}}
|
* <inorganic material name e.g. [[Raw_adamantine|RAW_ADAMANTINE]]>
* <value>
| Makes BOULDER items made of the material acceptable for [[Strand extractor|strand extraction]] into threads; see also STOCKPILE_THREAD_METAL. Value presumably determines the probability of this product extracted.{{verify}}

|-
| {{text_anchor|HARDENS_WITH_WATER}}
|
* <[[material token]]>
| Allows the material to be used to make [[healthcare|casts]].

|-
| {{text_anchor|SOAP_LEVEL}}
|
*<value>
| Determines effectiveness of soap - if the amount of grime on a body part is more than 3-SOAP_LEVEL, it sets it to 3-SOAP_LEVEL; as such setting it above 3 is bad. [[Soap]] has [SOAP_LEVEL:2]. Defaults to 0.

|-
| {{text_anchor|SYNDROME}}
|
| Begins defining a [[syndrome]] applied by the material. Multiple syndromes can be specified. See [[Syndrome token]].

|-
| {{text_anchor|ANTLER}}
|
| Found in the raws of several antler-wielding animals. It is used to show an antler as bodypart.
|

|-
| {{text_anchor|HAIR}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|FEATHER}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|SCALE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|HOOF}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|CHITIN}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|CARTILAGE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|NERVOUS_TISSUE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|MEAT_CATEGORY}}
| category
| Probably used in graphics. The following values for "category" are used in the vanilla raws: STANDARD, EYE, BRIAN, LUNG, HEART, LIVER, INTESTINES, STOMACH, GIZZARD, PANCREAS, SPLEEN, KIDNEY.
|}

===Material states===

The following is a list of valid material states:

{| {{prettytable}}
|-
|'''SOLID'''
|-
|'''LIQUID'''
|-
|'''GAS'''
|-
|'''POWDER''' (or '''SOLID_POWDER''')
|-
|'''PASTE''' (or '''SOLID_PASTE''')
|-
|'''PRESSED''' (or '''SOLID_PRESSED''')
|}

The following can be specified within tokens such as [[Material_definition_token#STATE_NAME|STATE_NAME]], [[Material_definition_token#STATE_NAME_ADJ|STATE_NAME_ADJ]] and [[Material_definition_token#STATE_ADJ|STATE_ADJ]] to make them apply to several of the above material states simultaneously:

{| {{prettytable}}
|- bgcolor="#C0C0C0"
!Value
!Description
|-
|'''ALL'''
|Denotes all possible material states.
|-
|'''ALL_SOLID'''
|Denotes 'SOLID', 'POWDER', 'PASTE' and 'PRESSED'.
|}

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

|-
| {{text_anchor|IMPLIES_ANIMAL_KILL}}
|
| Lets the game know that an animal was likely killed in the production of this item. Entities opposed to killing animals ([[elf|Elves]] in vanilla) will refuse to accept these items in trade.

|-
| {{text_anchor|ALCOHOL_PLANT}}
|
| Classifies the material as plant-based alcohol, allowing its storage in food stockpiles under "Drink (Plant)".

|-
| {{text_anchor|ALCOHOL_CREATURE}}
|
| Classifies the material as animal-based alcohol, allowing its storage in food stockpiles under "Drink (Animal)".

|-
| {{text_anchor|ALCOHOL}}
|
| Classifies the material as generic alcohol. Implied by both ALCOHOL_PLANT and ALCOHOL_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|CHEESE_PLANT}}
|
| Classifies the material as plant-based cheese, allowing its storage in food stockpiles under "Cheese (Plant)".

|-
| {{text_anchor|CHEESE_CREATURE}}
|
| Classifies the material as animal-based cheese, allowing its storage in food stockpiles under "Cheese (Animal)".

|-
| {{text_anchor|CHEESE}}
|
| Classifies the material as generic cheese. Implied by both CHEESE_PLANT and CHEESE_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|POWDER_MISC_PLANT}}
|
| Classifies the material as plant powder, allowing its storage in food stockpiles under "Milled Plant".

|-
| {{text_anchor|POWDER_MISC_CREATURE}}
|
| Classifies the material as creature powder, allowing its storage in food stockpiles under "Bone Meal". Unlike milled plants, such as sugar and flour, "Bone Meal" barrels or pots may not contain bags. Custom reactions using this product better use buckets or jugs instead.

|-
| {{text_anchor|POWDER_MISC}}
|
| Classifies the material as generic powder. Implied by both POWDER_MISC_PLANT and POWDER_MISC_CREATURE. Exact behavior unknown, possibly vestigial.

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

|-
| {{text_anchor|STOCKPILE_GLOB_PASTE}}
|
| Classifies the material as milled paste, allowing its storage in food stockpiles under "Paste".

|-
| {{text_anchor|STOCKPILE_GLOB_PRESSED}}
|
| Classifies the material as pressed goods, allowing its storage in food stockpiles under "Pressed Material".

|-
| {{text_anchor|STOCKPILE_PLANT_GROWTH}}
|
| Classifies the material as a plant growth (e.g. fruits, leaves), allowing its storage in food stockpiles under Plant Growth/Fruit.

|-
| {{text_anchor|LIQUID_MISC_PLANT}}
|
| Classifies the material as a plant extract, allowing its storage in food stockpiles under "Extract (Plant)".

|-
| {{text_anchor|LIQUID_MISC_CREATURE}}
|
| Classifies the material as a creature extract, allowing its storage in food stockpiles under "Extract (Animal)".

|-
| {{text_anchor|LIQUID_MISC_OTHER}}
|
| Classifies the material as a miscellaneous liquid, allowing its storage in food stockpiles under "Misc. Liquid" along with lye.

|-
| {{text_anchor|LIQUID_MISC}}
|
| Classifies the material as a generic liquid. Implied by LIQUID_MISC_PLANT, LIQUID_MISC_CREATURE, and LIQUID_MISC_OTHER. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|STRUCTURAL_PLANT_MAT}}
|
| Classifies the material as a plant, allowing its storage in food stockpiles under "Plants".

|-
| {{text_anchor|SEED_MAT}}
|
| Classifies the material as a plant seed, allowing its storage in food stockpiles under "Seeds".

|-
| {{text_anchor|BONE}}
|
| Classifies the material as bone, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|WOOD}}
|
| Classifies the material as wood, allowing its use for carpenters and storage in wood stockpiles. Entities opposed to killing plants (i.e. [[Elf|Elves]]) will refuse to accept these items in trade.

|-
| {{text_anchor|THREAD_PLANT}}
|
| Classifies the material as plant fiber, allowing its use for clothiers and storage in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".

|-
| {{text_anchor|TOOTH}}
|
| Classifies the material as tooth, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|HORN}}
|
| Classifies the material as horn, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|HAIR}}
|
| Classifies the material as hair, allowing for its use for spinners and restriction from refuse stockpiles by material.

|-
| {{text_anchor|PEARL}}
|
| Classifies the material as pearl, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|SHELL}}
|
| Classifies the material as shell, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|LEATHER}}
|
| Classifies the material as leather, allowing its use for leatherworkers and storage in leather stockpiles.

|-
| {{text_anchor|SILK}}
|
| Classifies the material as silk, allowing its use for clothiers and storage in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".

|-
| {{text_anchor|SOAP}}
|
| Classifies the material as soap, allowing it to be used as a bath detergent and stored in bar/block stockpiles under "Bars: Other Materials".{{verify}}

|-
| {{text_anchor|GENERATES_MIASMA}}
|
| Material generates miasma when it rots.

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

|-
| {{text_anchor|ROTS}}
|
| Material will rot if not stockpiled appropriately. Currently only affects [[food]] and [[refuse]], other items made of this material will not rot.

|-
| {{text_anchor|NERVOUS_TISSUE}}
|
| In most living creatures, it controls many bodily functions and movements by sending signals around the body. See: [[Nervous tissue]]

|-
| {{text_anchor|BLOOD_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "blood" in Adventurer mode tile descriptions ("Here we have a Dwarf in a slurry of blood.").

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

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

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

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

|-
| {{text_anchor|SWEAT_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "sweat".

|-
| {{text_anchor|TEARS_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "tears".

|-
| {{text_anchor|SPIT_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "spit".

|-
| {{text_anchor|EVAPORATES}}
|
| Contaminants composed of this material evaporate over time, slowly disappearing from the map. Used internally by water.

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

|-
| {{text_anchor|EDIBLE_VERMIN}}
|
| Can be eaten by vermin.

|-
| {{text_anchor|EDIBLE_RAW}}
|
| Can be eaten raw.

|-
| {{text_anchor|EDIBLE_COOKED}}
|
| Can be cooked and then eaten.

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

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

|-
| {{text_anchor|ITEMS_METAL}}
|
| The material can be made into minecarts, wheelbarrows, and stepladders at the metalsmith's forge.

|-
| {{text_anchor|ITEMS_BARRED}}
|
| Equivalent to ITEMS_HARD. Given to [[bone]].

|-
| {{text_anchor|ITEMS_SCALED}}
|
| Equivalent to ITEMS_HARD. Given to [[shell]].

|-
| {{text_anchor|ITEMS_LEATHER}}
|
| Equivalent to ITEMS_SOFT. Given to [[leather]].

|-
| {{text_anchor|ITEMS_SOFT}}
|
| The material can be made into clothing, amulets, bracelets, earrings, backpacks, and quivers, contingent on which workshops accept the material. Given to [[plant fiber]], [[silk]] and [[wool]].

|-
| {{text_anchor|ITEMS_HARD}}
|
| The material can be made into furniture, crafts, mechanisms, and blocks, contingent on which workshops accept the material. Random [[finished goods|crafts]] made from this material include all seven items. Given to [[stone]], [[wood]], [[bone]], [[shell]], [[chitin]], [[nail|claws]], [[tooth|teeth]], [[horn|horns]], [[horn|hooves]] and [[wax|beeswax]]. [[Hair]], [[pearl|pearls]] and eggshells also have the tag.

|-
| {{text_anchor|IS_STONE}}
|
| Used to define that the material is a stone. Allows its usage in [[masonry]] and [[stonecrafting]] and storage in stone stockpiles, among other effects.

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

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

|-
| {{text_anchor|YARN}}
|
| Classifies the material as yarn, allowing its use for clothiers and its storage in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".

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

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

|-
| {{text_anchor|IS_GLASS}}
|
| Used internally by green glass, clear glass, and crystal glass. Appears to only affect the [[Reaction#GLASS_MATERIAL|[GLASS_MATERIAL]]] reaction token. Does not cause the game to treat the material like glass, i.e being referred to as "raw" instead of "rough" in its raw form or being displayed in the "glass" trade/embark category.

|-
| {{text_anchor|IS_CERAMIC}}
|
| Defines the material as a ceramic. Examples include CERAMIC_EARTHENWARE, CERAMIC_STONEWARE and CERAMIC_PORCELAIN.

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

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

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

|-
| {{text_anchor|ITEMS_ANVIL}}
|
| [[Anvil]]s can be made out of this material.

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

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

|-
| {{text_anchor|ITEMS_ARMOR}}
|
| [[Armor]] can be made out of this material.

|-
| {{text_anchor|ITEMS_DELICATE}}
|
| Used internally by amber and coral. Functionally equivalent to ITEMS_HARD.

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

|-
| {{text_anchor|ITEMS_QUERN}}
|
| Querns and millstones can be made out of this material. Does not appear to work.
|}

==Syndrome tokens==
Below is a table with some of the tokens you can use when declaring a [SYNDROME] token. For all the tokens you can use, see the [[Syndrome token]] page.

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

|-
| {{text_anchor|SYN_NAME
|
* text
| Defines the name of the syndrome

|-
| {{text_anchor|SYN_INJECTED}}
|
| Syndrome can be contracted by injection (by a creature)

|-
| {{text_anchor|SYN_CONTACT}}
|
| Syndrome can be contracted on contact (e.g. poison dust or liquid)

|-
| {{text_anchor|SYN_INHALED}}
|
| Syndrome can be contracted by inhalation (e.g. poison vapor or gas)

|-
| {{text_anchor|SYN_INGESTED}}
|
| Syndrome can be contracted by ingestion (when the material is eaten in solid or liquid form)

|-
| {{text_anchor|SYN_AFFECTED_CLASS}}
|
* creature class name
| Adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| {{text_anchor|SYN_IMMUNE_CLASS}}
|
* creature class name
| Makes the class of creatures immune to the syndrome

|-
| {{text_anchor|SYN_AFFECTED_CREATURE}}
|
* creature name
* caste name or ALL
| Adds a specific creature to those affected.

|-
| {{text_anchor|SYN_IMMUNE_CREATURE}}
|
* creature name
* caste name or ALL
| Makes the creature immune to the syndrome

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

|}

==See also==
* [[Inorganic material definition token]]
* [[Syndrome]]
* [[Hardcoded material]]

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

Material definition token

2024-08-01T21:11:51Z

Putnam3145: /* Material properties */ sometimes you're reading the code and say "Neat!"

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

The following [[token]]s can be used in [[material]] definitions (whether for inorganics or those within plants and creatures) as well as in [[:Category:material template raw pages|material templates]].

__TOC__
{{clear}}

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

|-
| {{text_anchor|USE_MATERIAL_TEMPLATE}}
|
* <template name>
| Resets all material tokens back to their default values, then imports the tokens of the specified preexisting material template (overriding any tokens defined prior to itself in the material). This means USE_MATERIAL_TEMPLATE should be the first token present in any material using it. It cannot be used inside of a [MATERIAL_TEMPLATE:X] which prevents the creation of nested material template structures.

|-
| {{text_anchor|PREFIX}}
|
* <prefix> or NONE
| Applies a prefix to all items made from the material. For PLANT and CREATURE materials, this defaults to the plant/creature name. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|STONE_NAME}}
|
* <name>
| Overrides the name of [[Item_token#BOULDER|BOULDER]] items (i.e. mined-out stones) made of the material (used for native copper/silver/gold/platinum to make them be called "nuggets" instead of "boulders").

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

|-
| {{text_anchor|TEMP_DIET_INFO}}
|
* <type>
| Specifies what the material should be treated as when drinking water contaminated by it, for generating unhappy [[thought]]s. Valid values are BLOOD, SLIME, VOMIT, ICHOR, PUS, GOO, GRIME, and FILTH.

|-
| {{text_anchor|POWDER_DYE}}
|
*<[[Color#Color_tokens|color token]]>
| Allows the material to be used as [[dye]], and defines color of dyed items.

|-
| {{text_anchor|TILE}}
|
*<[[Main:Character table|tile value or character]]>
| Specifies the tile that will be used to represent unmined tiles made of this material. Generally only used with stones. Defaults to 219 ('█').

|-
| {{text_anchor|ITEM_SYMBOL}}
|
*<[[Main:Character table|tile value or character]]>
| Specifies the tile that will be used to represent [[Item_token#BOULDER|BOULDER]] items made of this material. Generally only used with stones. Defaults to 7 ('•').

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

|-
| {{text_anchor|BUILD_COLOR}}
|
*<[[Color#Color_values|foreground color]]>
*<[[Color#Color_values|background color]]>
*<[[Color#Color_values|foreground brightness]]>
| The color of objects made of this material which use both the foreground and background color: [[door]]s, [[floodgate]]s, [[hatch cover]]s, [[bin]]s, [[barrel]]s, and [[cage]]s. Defaults to 7:7:1 (white).

|-
| {{text_anchor|TILE_COLOR}}
|
*<[[Color#Color_values|foreground color]]>
*<[[Color#Color_values|background color]]>
*<[[Color#Color_values|foreground brightness]]>
| The color of unmined tiles containing this material (for stone and soil), as well as [[engraving]]s in this material. Defaults to 7:7:1 (white).

|-
| {{text_anchor|BASIC_COLOR}}
|
*<[[Color#Color_values|foreground color]]>
*<[[Color#Color_values|foreground brightness]]>
| The color of objects made of this material which use only the foreground color, including workshops, floors and boulders, and smoothed walls. Defaults to 7:1 (white).

|-
| {{text_anchor|STATE_COLOR}}
|
*<[[Material_definition_token#Material States|material state]]>
*<[[Color#Color_tokens|color token]]>
| Determines the color of the material at the specified state. See [[Material_definition_token#Material states|below]] for a list of valid material states. Color comes from descriptor_color_standard.txt. The nearest color value is used to display contaminants and body parts made of this material in ASCII and to color items and constructions made from this material with graphics. Example:
[STATE_COLOR:ALL_SOLID:GRAY]

|-
| {{text_anchor|STATE_NAME}}
|
*<[[Material_definition_token#Material States|material state]]>
*<name>
| Determines the name of the material at the specified state, as displayed in-game.
[STATE_NAME:ALL_SOLID:stone]

|-
| {{text_anchor|STATE_ADJ}}
|
*<[[Material_definition_token#Material States|material state]]>
*<adjective>
| Like [[Material_definition_token#STATE_NAME|STATE_NAME]], but used in different situations. Equipment made from the material uses the state adjective and not the state name.

|-
| {{text_anchor|STATE_NAME_ADJ}}
|
*<[[Material_definition_token#Material States|material state]]>
*<name>
*<adjective>
| Sets both [[Material_definition_token#STATE_NAME|STATE_NAME]] and [[Material_definition_token#STATE_ADJ|STATE_ADJ]] at the same time.

|-
| {{text_anchor|ABSORPTION}}
|
*<value>
| The material's tendency to absorb liquids. Containers made of materials with nonzero absorption cannot hold liquids unless they have been [[glaze]]d. Defaults to 0.

|-
| {{text_anchor|IMPACT_YIELD}}
|
*<value>
| Specifies how hard of an impact (in kilopascals) the material can withstand before it will start deforming permanently. Used for blunt-force combat. Defaults to 10000.

|-
| {{text_anchor|IMPACT_FRACTURE}}
|
*<value>
| Specifies how hard of an impact the material can withstand before it will fail entirely. Used for blunt-force combat. Defaults to 10000.

|-
| {{text_anchor|IMPACT_STRAIN_AT_YIELD}} or {{text_anchor|IMPACT_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given (in parts-per-100000) when the yield point is reached. Used for blunt-force combat. Defaults to 0. Apparently affects in combat whether the corresponding tissue is bruised (value >= 50000), torn (value between 25000 and 49999), or fractured (value <= 24999)

|-
| {{text_anchor|COMPRESSIVE_YIELD}}
|
*<value>
| Specifies how hard the material can be compressed before it will start deforming permanently. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 10000.

|-
| {{text_anchor|COMPRESSIVE_FRACTURE}}
|
*<value>
| Specifies how hard the material can be compressed before it will fail entirely. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 10000.

|-
| {{text_anchor|COMPRESSIVE_STRAIN_AT_YIELD}} or {{text_anchor|COMPRESSIVE_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when it has been compressed to its yield point. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 0.

|-
| {{text_anchor|TENSILE_YIELD}}
|
*<value>
| Specifies how hard the material can be stretched before it will start deforming permanently. Determines a tissue's resistance to a latching and tearing bite. Defaults to 10000.

|-
| {{text_anchor|TENSILE_FRACTURE}}
|
*<value>
| Specifies how hard the material can be stretched before it will fail entirely. Determines a tissue's resistance to a latching and tearing bite. Defaults to 10000.

|-
| {{text_anchor|TENSILE_STRAIN_AT_YIELD}} or {{text_anchor|TENSILE_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when it is stretched to its yield point. Determines a tissue's resistance to a latching and tearing bite. Defaults to 0.

|-
| {{text_anchor|TORSION_YIELD}}
|
*<value>
| Specifies how hard the material can be twisted before it will start deforming permanently. Used for latching and shaking with a blunt attack (certain generated creatures with beaks can do this). Defaults to 10000.

|-
| {{text_anchor|TORSION_FRACTURE}}
|
*<value>
| Specifies how hard the material can be twisted before it will fail entirely. Used for latching and shaking with a blunt attack (certain generated creatures with beaks can do this). Defaults to 10000.

|-
| {{text_anchor|TORSION_STRAIN_AT_YIELD}} or {{text_anchor|TORSION_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when it is twisted to its yield point. Used for latching and shaking with a blunt attack (certain generated creatures with beaks can do this). Defaults to 0.

|-
| {{text_anchor|SHEAR_YIELD}}
|
*<value>
| Specifies how hard the material can be sheared before it will start deforming permanently. Used for cutting calculations. Defaults to 10000.

|-
| {{text_anchor|SHEAR_FRACTURE}}
|
*<value>
| Specifies how hard the material can be sheared before it will fail entirely. Used for cutting calculations. Defaults to 10000.

|-
| {{text_anchor|SHEAR_STRAIN_AT_YIELD}} or {{text_anchor|SHEAR_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when sheared to its yield point. Used for cutting calculations. Defaults to 0.

|-
| {{text_anchor|BENDING_YIELD}}
|
*<value>
| Specifies how hard the material can be bent before it will start deforming permanently. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 10000.

|-
| {{text_anchor|BENDING_FRACTURE}}
|
*<value>
| Specifies how hard the material can be bent before it will fail entirely. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 10000.

|-
| {{text_anchor|BENDING_STRAIN_AT_YIELD}} or {{text_anchor|BENDING_ELASTICITY}}
|
*<value>
| Specifies how much the material will have given when bent to its yield point. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 0.

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

|-
| {{text_anchor|MATERIAL_VALUE}}
|
*<value>
| Value modifier for the material. Defaults to 1. This number can be made negative by placing a "-" in front, resulting in things that you are paid to buy and must pay to sell.

|-
| {{text_anchor|MULTIPLY_VALUE}}
|
*<value>
| Multiplies the value of the material. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|SPEC_HEAT}}
|
*<specific heat capacity>
| Rate at which the material heats up or cools down (in joules/kilogram-kelvin). If set to NONE, the temperature will be fixed at its initial value. See [[Temperature]] for more information. Defaults to NONE.

|-
| {{text_anchor|HEATDAM_POINT}}
|
*<temperature>
| Temperature above which the material takes damage from heat. May be set to NONE. If the material has an ignite point but no heatdam point, it will burn for a very long time (9 months and 16.8 days). Defaults to NONE.

|-
| {{text_anchor|COLDDAM_POINT}}
|
*<temperature>
| Temperature below which the material takes damage from cold. Defaults to NONE.

|-
| {{text_anchor|IGNITE_POINT}}
|
*<temperature>
| Temperature at which the material will catch fire. Defaults to NONE.

|-
| {{text_anchor|MELTING_POINT}}
|
*<temperature>
| Temperature at which the material melts. Defaults to NONE.

|-
| {{text_anchor|BOILING_POINT}}
|
*<temperature>
| Temperature at which the material boils. Defaults to NONE.

|-
| {{text_anchor|MAT_FIXED_TEMP}}
|
*<temperature>
| Items composed of this material will initially have this temperature. Used in conjunction with <code>[SPEC_HEAT:NONE]</code> to make material's temperature fixed at the specified value. Defaults to NONE.

|-
| {{text_anchor|IF_EXISTS_SET_HEATDAM_POINT}}
|
*<temperature>
| Changes a material's HEATDAM_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_COLDDAM_POINT}}
|
*<temperature>
| Changes a material's COLDDAM_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_IGNITE_POINT}}
|
*<temperature>
| Changes a material's IGNITE_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_MELTING_POINT}}
|
*<temperature>
| Changes a material's MELTING_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_BOILING_POINT}}
|
*<temperature>
| Changes a material's BOILING_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_MAT_FIXED_TEMP}}
|
*<temperature>
| Changes a material's MAT_FIXED_TEMP, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|SOLID_DENSITY}}
|
*<density>
| Specifies the density (in kilograms per cubic meter) of the material when in solid form. Also affects combat calculations; affects blunt-force damage and ability of weak-in-impact-yield blunt attacks to pierce armor. Defaults to NONE.

|-
| {{text_anchor|LIQUID_DENSITY}}
|
*<density>
| Specifies the density of the material when in liquid form. Defaults to NONE. Also affects combat calculations; affects blunt force damage like SOLID_DENSITY, but only for attacks made by liquids (e.g. forgotten beasts made of water).

|-
| {{text_anchor|MOLAR_MASS}}
|
*<value>
| Specifies (in kg/mol) the molar mass of the material in gaseous form. Only affects combat calculations like the densities, and only for attacks made by gases (e.g. forgotten beasts made of steam).

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

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

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

|-
| {{text_anchor|BLOCK_NAME}}
|
*<singular>
*<plural>
| Specifies the name of [[block]]s made from this material.

|-
| {{text_anchor|WAFERS}}
|
| The material forms "wafers" instead of "[[bar]]s".

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

|-
| {{text_anchor|ITEM_REACTION_PRODUCT}}
|
*<item reference>
*<[[item token]]>
*<[[material token]]>
| Used with reaction raws to associate a reagent material with a complete item. The first argument is used by HAS_ITEM_REACTION_PRODUCT and GET_ITEM_DATA_FROM_REAGENT in reaction raws. The rest refers to the type of item, then its material.
[ITEM_REACTION_PRODUCT:BAG_ITEM:PLANT_GROWTH:LEAVES:LOCAL_PLANT_MAT:LEAF]

|-
| {{text_anchor|REACTION_CLASS}}
|
*<reaction class name>
| Used to classify all items made of the material, so that reactions can use them as generic reagents.
In default raws, the following are used:
* FAT, TALLOW, SOAP, PARCHMENT, PAPER_PLANT, PAPER_SLURRY, MILK, CHEESE, WAX
* CAN_GLAZE - items made from this material can be glazed.
* FLUX - can be used as [[flux]] in pig iron and steel making.
* GYPSUM - can be processed into [[gypsum plaster]].
* CALCIUM_CARBONATE - can be used in production of [[quicklime]].

|-
| {{text_anchor|METAL_ORE}}
|
* <inorganic material name e.g. [[lead|LEAD]]>
* <value>
| Makes BOULDER acceptable as a [[Reactions#Reagents|reagent]] in reactions that require [[Item_token#Related_Tokens|"METAL_ORE:MATERIAL_NAME"]], as well as [[Smelter|smelting]] directly into metal [[bar]]s. Places the material under "Metal Ores" in Stone stockpiles. The specified value determines the probability for this product (see [[Tetrahedrite]] or [[Galena]] for details).

|-
| {{text_anchor|THREAD_METAL}}
|
* <inorganic material name e.g. [[Raw_adamantine|RAW_ADAMANTINE]]>
* <value>
| Makes BOULDER items made of the material acceptable for [[Strand extractor|strand extraction]] into threads; see also STOCKPILE_THREAD_METAL. Value presumably determines the probability of this product extracted.{{verify}}

|-
| {{text_anchor|HARDENS_WITH_WATER}}
|
* <[[material token]]>
| Allows the material to be used to make [[healthcare|casts]].

|-
| {{text_anchor|SOAP_LEVEL}}
|
*<value>
| Determines effectiveness of soap - if the amount of grime on a body part is more than 3-SOAP_LEVEL, it sets it to 3-SOAP_LEVEL; as such setting it above 3 is bad. [[Soap]] has [SOAP_LEVEL:2]. Defaults to 0.

|-
| {{text_anchor|SYNDROME}}
|
| Begins defining a [[syndrome]] applied by the material. Multiple syndromes can be specified. See [[Syndrome token]].

|-
| {{text_anchor|ANTLER}}
|
| Found in the raws of several antler-wielding animals. It is used to show an antler as bodypart.
|

|-
| {{text_anchor|HAIR}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|FEATHER}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|SCALE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|HOOF}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|CHITIN}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|CARTILAGE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|NERVOUS_TISSUE}}
|
| Probably used in graphics.
|

|-
| {{text_anchor|MEAT_CATEGORY}}
| category
| Probably used in graphics. The following values for "category" are used in the vanilla raws: STANDARD, EYE, BRIAN, LUNG, HEART, LIVER, INTESTINES, STOMACH, GIZZARD, PANCREAS, SPLEEN, KIDNEY.
|}

===Material states===

The following is a list of valid material states:

{| {{prettytable}}
|-
|'''SOLID'''
|-
|'''LIQUID'''
|-
|'''GAS'''
|-
|'''POWDER''' (or '''SOLID_POWDER''')
|-
|'''PASTE''' (or '''SOLID_PASTE''')
|-
|'''PRESSED''' (or '''SOLID_PRESSED''')
|}

The following can be specified within tokens such as [[Material_definition_token#STATE_NAME|STATE_NAME]], [[Material_definition_token#STATE_NAME_ADJ|STATE_NAME_ADJ]] and [[Material_definition_token#STATE_ADJ|STATE_ADJ]] to make them apply to several of the above material states simultaneously:

{| {{prettytable}}
|- bgcolor="#C0C0C0"
!Value
!Description
|-
|'''ALL'''
|Denotes all possible material states.
|-
|'''ALL_SOLID'''
|Denotes 'SOLID', 'POWDER', 'PASTE' and 'PRESSED'.
|}

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

|-
| {{text_anchor|IMPLIES_ANIMAL_KILL}}
|
| Lets the game know that an animal was likely killed in the production of this item. Entities opposed to killing animals ([[elf|Elves]] in vanilla) will refuse to accept these items in trade.

|-
| {{text_anchor|ALCOHOL_PLANT}}
|
| Classifies the material as plant-based alcohol, allowing its storage in food stockpiles under "Drink (Plant)".

|-
| {{text_anchor|ALCOHOL_CREATURE}}
|
| Classifies the material as animal-based alcohol, allowing its storage in food stockpiles under "Drink (Animal)".

|-
| {{text_anchor|ALCOHOL}}
|
| Classifies the material as generic alcohol. Implied by both ALCOHOL_PLANT and ALCOHOL_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|CHEESE_PLANT}}
|
| Classifies the material as plant-based cheese, allowing its storage in food stockpiles under "Cheese (Plant)".

|-
| {{text_anchor|CHEESE_CREATURE}}
|
| Classifies the material as animal-based cheese, allowing its storage in food stockpiles under "Cheese (Animal)".

|-
| {{text_anchor|CHEESE}}
|
| Classifies the material as generic cheese. Implied by both CHEESE_PLANT and CHEESE_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|POWDER_MISC_PLANT}}
|
| Classifies the material as plant powder, allowing its storage in food stockpiles under "Milled Plant".

|-
| {{text_anchor|POWDER_MISC_CREATURE}}
|
| Classifies the material as creature powder, allowing its storage in food stockpiles under "Bone Meal". Unlike milled plants, such as sugar and flour, "Bone Meal" barrels or pots may not contain bags. Custom reactions using this product better use buckets or jugs instead.

|-
| {{text_anchor|POWDER_MISC}}
|
| Classifies the material as generic powder. Implied by both POWDER_MISC_PLANT and POWDER_MISC_CREATURE. Exact behavior unknown, possibly vestigial.

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

|-
| {{text_anchor|STOCKPILE_GLOB_PASTE}}
|
| Classifies the material as milled paste, allowing its storage in food stockpiles under "Paste".

|-
| {{text_anchor|STOCKPILE_GLOB_PRESSED}}
|
| Classifies the material as pressed goods, allowing its storage in food stockpiles under "Pressed Material".

|-
| {{text_anchor|STOCKPILE_PLANT_GROWTH}}
|
| Classifies the material as a plant growth (e.g. fruits, leaves), allowing its storage in food stockpiles under Plant Growth/Fruit.

|-
| {{text_anchor|LIQUID_MISC_PLANT}}
|
| Classifies the material as a plant extract, allowing its storage in food stockpiles under "Extract (Plant)".

|-
| {{text_anchor|LIQUID_MISC_CREATURE}}
|
| Classifies the material as a creature extract, allowing its storage in food stockpiles under "Extract (Animal)".

|-
| {{text_anchor|LIQUID_MISC_OTHER}}
|
| Classifies the material as a miscellaneous liquid, allowing its storage in food stockpiles under "Misc. Liquid" along with lye.

|-
| {{text_anchor|LIQUID_MISC}}
|
| Classifies the material as a generic liquid. Implied by LIQUID_MISC_PLANT, LIQUID_MISC_CREATURE, and LIQUID_MISC_OTHER. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|STRUCTURAL_PLANT_MAT}}
|
| Classifies the material as a plant, allowing its storage in food stockpiles under "Plants".

|-
| {{text_anchor|SEED_MAT}}
|
| Classifies the material as a plant seed, allowing its storage in food stockpiles under "Seeds".

|-
| {{text_anchor|BONE}}
|
| Classifies the material as bone, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|WOOD}}
|
| Classifies the material as wood, allowing its use for carpenters and storage in wood stockpiles. Entities opposed to killing plants (i.e. [[Elf|Elves]]) will refuse to accept these items in trade.

|-
| {{text_anchor|THREAD_PLANT}}
|
| Classifies the material as plant fiber, allowing its use for clothiers and storage in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".

|-
| {{text_anchor|TOOTH}}
|
| Classifies the material as tooth, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|HORN}}
|
| Classifies the material as horn, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|HAIR}}
|
| Classifies the material as hair, allowing for its use for spinners and restriction from refuse stockpiles by material.

|-
| {{text_anchor|PEARL}}
|
| Classifies the material as pearl, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|SHELL}}
|
| Classifies the material as shell, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|LEATHER}}
|
| Classifies the material as leather, allowing its use for leatherworkers and storage in leather stockpiles.

|-
| {{text_anchor|SILK}}
|
| Classifies the material as silk, allowing its use for clothiers and storage in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".

|-
| {{text_anchor|SOAP}}
|
| Classifies the material as soap, allowing it to be used as a bath detergent and stored in bar/block stockpiles under "Bars: Other Materials".{{verify}}

|-
| {{text_anchor|GENERATES_MIASMA}}
|
| Material generates miasma when it rots.

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

|-
| {{text_anchor|ROTS}}
|
| Material will rot if not stockpiled appropriately. Currently only affects [[food]] and [[refuse]], other items made of this material will not rot.

|-
| {{text_anchor|NERVOUS_TISSUE}}
|
| In most living creatures, it controls many bodily functions and movements by sending signals around the body. See: [[Nervous tissue]]

|-
| {{text_anchor|BLOOD_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "blood" in Adventurer mode tile descriptions ("Here we have a Dwarf in a slurry of blood.").

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

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

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

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

|-
| {{text_anchor|SWEAT_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "sweat".

|-
| {{text_anchor|TEARS_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "tears".

|-
| {{text_anchor|SPIT_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "spit".

|-
| {{text_anchor|EVAPORATES}}
|
| Contaminants composed of this material evaporate over time, slowly disappearing from the map. Used internally by water.

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

|-
| {{text_anchor|EDIBLE_VERMIN}}
|
| Can be eaten by vermin.

|-
| {{text_anchor|EDIBLE_RAW}}
|
| Can be eaten raw.

|-
| {{text_anchor|EDIBLE_COOKED}}
|
| Can be cooked and then eaten.

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

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

|-
| {{text_anchor|ITEMS_METAL}}
|
| The material can be made into minecarts, wheelbarrows, and stepladders at the metalsmith's forge.

|-
| {{text_anchor|ITEMS_BARRED}}
|
| Equivalent to ITEMS_HARD. Given to [[bone]].

|-
| {{text_anchor|ITEMS_SCALED}}
|
| Equivalent to ITEMS_HARD. Given to [[shell]].

|-
| {{text_anchor|ITEMS_LEATHER}}
|
| Equivalent to ITEMS_SOFT. Given to [[leather]].

|-
| {{text_anchor|ITEMS_SOFT}}
|
| The material can be made into clothing, amulets, bracelets, earrings, backpacks, and quivers, contingent on which workshops accept the material. Given to [[plant fiber]], [[silk]] and [[wool]].

|-
| {{text_anchor|ITEMS_HARD}}
|
| The material can be made into furniture, crafts, mechanisms, and blocks, contingent on which workshops accept the material. Random [[finished goods|crafts]] made from this material include all seven items. Given to [[stone]], [[wood]], [[bone]], [[shell]], [[chitin]], [[nail|claws]], [[tooth|teeth]], [[horn|horns]], [[horn|hooves]] and [[wax|beeswax]]. [[Hair]], [[pearl|pearls]] and eggshells also have the tag.

|-
| {{text_anchor|IS_STONE}}
|
| Used to define that the material is a stone. Allows its usage in [[masonry]] and [[stonecrafting]] and storage in stone stockpiles, among other effects.

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

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

|-
| {{text_anchor|YARN}}
|
| Classifies the material as yarn, allowing its use for clothiers and its storage in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".

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

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

|-
| {{text_anchor|IS_GLASS}}
|
| Used internally by green glass, clear glass, and crystal glass. Appears to only affect the [[Reaction#GLASS_MATERIAL|[GLASS_MATERIAL]]] reaction token. Does not cause the game to treat the material like glass, i.e being referred to as "raw" instead of "rough" in its raw form or being displayed in the "glass" trade/embark category.

|-
| {{text_anchor|IS_CERAMIC}}
|
| Defines the material as a ceramic. Examples include CERAMIC_EARTHENWARE, CERAMIC_STONEWARE and CERAMIC_PORCELAIN.

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

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

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

|-
| {{text_anchor|ITEMS_ANVIL}}
|
| [[Anvil]]s can be made out of this material.

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

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

|-
| {{text_anchor|ITEMS_ARMOR}}
|
| [[Armor]] can be made out of this material.

|-
| {{text_anchor|ITEMS_DELICATE}}
|
| Used internally by amber and coral. Functionally equivalent to ITEMS_HARD.

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

|-
| {{text_anchor|ITEMS_QUERN}}
|
| Querns and millstones can be made out of this material. Does not appear to work.
|}

==Syndrome tokens==
Below is a table with some of the tokens you can use when declaring a [SYNDROME] token. For all the tokens you can use, see the [[Syndrome token]] page.

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

|-
| {{text_anchor|SYN_NAME
|
* text
| Defines the name of the syndrome

|-
| {{text_anchor|SYN_INJECTED}}
|
| Syndrome can be contracted by injection (by a creature)

|-
| {{text_anchor|SYN_CONTACT}}
|
| Syndrome can be contracted on contact (e.g. poison dust or liquid)

|-
| {{text_anchor|SYN_INHALED}}
|
| Syndrome can be contracted by inhalation (e.g. poison vapor or gas)

|-
| {{text_anchor|SYN_INGESTED}}
|
| Syndrome can be contracted by ingestion (when the material is eaten in solid or liquid form)

|-
| {{text_anchor|SYN_AFFECTED_CLASS}}
|
* creature class name
| Adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| {{text_anchor|SYN_IMMUNE_CLASS}}
|
* creature class name
| Makes the class of creatures immune to the syndrome

|-
| {{text_anchor|SYN_AFFECTED_CREATURE}}
|
* creature name
* caste name or ALL
| Adds a specific creature to those affected.

|-
| {{text_anchor|SYN_IMMUNE_CREATURE}}
|
* creature name
* caste name or ALL
| Makes the creature immune to the syndrome

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

|}

==See also==
* [[Inorganic material definition token]]
* [[Syndrome]]
* [[Hardcoded material]]

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

Creature token

2024-07-10T21:13:57Z

Putnam3145: /* T */

{{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 cast respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguish tokens that can be applied to creature only, cast 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 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
|
| Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.{{verify|code}}

|-
| {{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
|
| Found on {{token|LARGE_PREDATOR|c}}s who ambush their prey. Instead of charging relentlessly at prey, the predator will wait till the prey is within a few squares before charging. May or may not work on other creatures. {{verify}}

|-
| {{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}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{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.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.

|-
| {{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
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures. Not currently useful in Fortress mode as doors can no longer be set unpassable for pets.{{version|50.03}}

|-
| {{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. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{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 [[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 to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{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). 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}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

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

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets the creature to be active at twilight 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. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

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

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets the creature to be active during the day 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]. It's also possible for another creature to [[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 colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, 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}}. 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. 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).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

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

|-
| {{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. 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}}.

|-
| {{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, and from a distance. Ostensibly bugged as of v0.47.05.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{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}}
|
|
| 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.

|-
| {{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
|
| Sets the creature to be active at dawn 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. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to 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 on [[experiment|experiments]].
Prevents {{token|LOCAL_POPS_PRODUCE_HEROES|c}} from functioning. 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. Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}. 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 the AI from using ANIMATE interactions unless the newly-animated opposed-to-life 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.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{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]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}}

|-
| {{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
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

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

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

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

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

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets the creature to be active at night in adventure mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. 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
|
| Cannot be [[butcher|butchered]] in adventure mode. Has no effect during fortress mode.

|-
| {{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
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{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 traits. Standard is 0:50:100. See [[Personality trait]] 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 not prevent a caste from spawning.

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

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons 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
|
| Unknown.

|-
| {{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}}
|
|
| 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:

[creature] [verb text] the [description of creature's location]

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
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

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

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

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|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 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. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{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.{{verify}}

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

|-
| {{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. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per 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.

|-
| {{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. Speeds up decay?{{verify}}

|-
| {{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
|
| Sets the creature to be active during the evening 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; while all vanilla attacks use only BODYPART (e.g. ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP), there are other options available.

{| {{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, 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; 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; 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.

|}

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

Creature token

2024-07-10T21:11:29Z

Putnam3145: /* T */

{{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 cast respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguish tokens that can be applied to creature only, cast 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 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
|
| Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.{{verify|code}}

|-
| {{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
|
| Found on {{token|LARGE_PREDATOR|c}}s who ambush their prey. Instead of charging relentlessly at prey, the predator will wait till the prey is within a few squares before charging. May or may not work on other creatures. {{verify}}

|-
| {{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}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{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.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.

|-
| {{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
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures. Not currently useful in Fortress mode as doors can no longer be set unpassable for pets.{{version|50.03}}

|-
| {{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. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{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 [[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 to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{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). 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}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

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

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets the creature to be active at twilight 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. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

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

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets the creature to be active during the day 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]. It's also possible for another creature to [[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 colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, 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}}. 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. 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).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

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

|-
| {{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. 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}}.

|-
| {{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, and from a distance. Ostensibly bugged as of v0.47.05.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{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}}
|
|
| 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.

|-
| {{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
|
| Sets the creature to be active at dawn 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. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to 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 on [[experiment|experiments]].
Prevents {{token|LOCAL_POPS_PRODUCE_HEROES|c}} from functioning. 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. Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}. 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 the AI from using ANIMATE interactions unless the newly-animated opposed-to-life 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.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{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]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}}

|-
| {{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
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

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

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

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

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

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets the creature to be active at night in adventure mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. 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
|
| Cannot be [[butcher|butchered]] in adventure mode. Has no effect during fortress mode.

|-
| {{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
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{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 traits. Standard is 0:50:100. See [[Personality trait]] 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 not prevent a caste from spawning.

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

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons 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
|
| Unknown.

|-
| {{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}}
|
|
| 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:

[creature] [verb text] the [description of creature's location]

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
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

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

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

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|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 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. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{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 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.{{verify}}

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

|-
| {{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. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per 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.

|-
| {{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. Speeds up decay?{{verify}}

|-
| {{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
|
| Sets the creature to be active during the evening 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; while all vanilla attacks use only BODYPART (e.g. ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP), there are other options available.

{| {{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, 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; 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; 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.

|}

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

Interaction token

2024-06-23T20:44:23Z

Putnam3145:

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

The following [[token]]s can be used to define and use interactions. (''It appears that, at least in order to make the big list make a little more sense, [[Necromancer#Modding|some]] [[Interaction_examples|examples]] of those may be necessary.'')

__TOC__
{{clear}}

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

|-
| {{text anchor|INTERACTION}}
| Global
| ID
| Used to start defining a new interaction. The term "interaction ID" refers to the text specified within this token; this is used to make reference to the interaction in various other places.

|-
| {{text anchor|EXPERIMENT_ONLY}}
| Global
|
| Disallows use of the interaction in play, but if the interaction animates or resurrects corpses, or has an I_SOURCE:EXPERIMENT tag, it can be used in worldgen. Animation and resurrection interactions do not need I_SOURCE:EXPERIMENT to work in worldgen.

|-
| {{text anchor|I_SOURCE}}
| Global
| type
| Defines what things are capable of triggering this interaction - multiple sources may be specified. Valid values:
* '''CREATURE_ACTION''' - Specifies that the interaction may be used in conjunction with [[Creature_token#CAN_DO_INTERACTION|[CAN_DO_INTERACTION]]] and [[Syndrome#CE_CAN_DO_INTERACTION|[CE_CAN_DO_INTERACTION]]], but it isn't actually necessary for this. It might exist simply to allow for the inclusion of IS_ tokens (detailed below) to be applied when the interaction is used in this context.
* '''ATTACK''' - Allows the interaction to be used in conjunction with [[Creature_token#SPECIALATTACK_INTERACTION|[SPECIALATTACK_INTERACTION]]] and [[Syndrome#CE_SPECIAL_ATTACK_INTERACTION|[CE_SPECIAL_ATTACK_INTERACTION]]].
* '''INGESTION''' - Allows the interaction to be used in conjunction with [[Syndrome#CE_BODY_MAT_INTERACTION|[CE_BODY_MAT_INTERACTION]]].
* '''DEITY''' - Allows the interaction to be inflicted upon mortals by the gods, for reasons dictated by [[Interaction_token#IS_USAGE_HINT|[IS_USAGE_HINT]]].
* '''SECRET''' - Allows the interaction to act as a secret which can be learnt and passed on to others, as specified via [[Interaction_token#IS_SECRET|[IS_SECRET]]]. Appropriate [[Interaction_token#I_EFFECT|interaction effects]] with a [[Interaction_token#IE_TARGET|creature target]] will be applied to individuals who learn the secret. It is possible to set restrictions on who may learn the secret by using creature target tokens as described below. Also see [[Interaction_token#IS_SECRET_GOAL|[IS_SECRET_GOAL]]] and [[Interaction_token#IS_SPHERE|[IS_SPHERE]]].
* '''REGION''' - Allows the interaction to take place spontaneously in regions specified using [[Interaction_token#IS_REGION|[IS_REGION]]]. Also see [[Interaction_token#IS_FREQUENCY|[IS_FREQUENCY]]] and [[Interaction_token#IE_INTERMITTENT|[IE_INTERMITTENT]]].
* '''DISTURBANCE''' - Allows the interaction to take place spontaneously in disturbed [[tomb|tombs]]; generated interactions with this token are used to create [[mummy|mummies]].
* '''UNDERGROUND_SPECIAL''' - Allows the interaction to take place spontaneously in [[Demonic fortress|curious underground structures]] (which no longer generate); generated interactions with this token used to be used to produce [[undead|zombies]] when creating the structure's inhabitants.
* '''EXPERIMENT''' - This can be used by NIGHT_CREATURE_EXPERIMENTERs while "performing horrible experiments" in worldgen. Only seems relevant for interactions that target living creatures. Note that all NIGHT_CREATURE_EXPERIMENTERs have access to generated experiments, and due to the large number of generated experiments available custom experiment interactions will tend to show up very rarely.

|-
| {{text anchor|IS_HIST_STRING_1}}
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure; this is displayed in legends mode following the name of the historical figure who performed the interaction and preceding the name of the targeted historical figure (or, in the case of [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]], the historical figure from whom the consumed material was extracted).

[IS_HIST_STRING_1: cursed]

|-
| {{text anchor|IS_HIST_STRING_2}}
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure; this is displayed in legends mode after the name of the historical figure who was targeted by the interaction. In the case of [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]], it is displayed after the name of the historical figure from whom the consumed material was extracted.

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

|-
| {{text anchor|IS_TRIGGER_STRING}}
| Within I_SOURCE
| text
| Displayed as an announcement when the interaction is carried out during play. The text follows the name of the target unit, and is preceded by [[Interaction_token#IS_TRIGGER_STRING_SECOND|IS_TRIGGER_STRING_SECOND]] or [[Interaction_token#IS_TRIGGER_STRING_THIRD|IS_TRIGGER_STRING_THIRD]]. May be limited to [[Interaction_token#I_SOURCE|[I_SOURCE:DEITY]]] and [[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]] interactions at present; this still needs to be tested.

[IS_TRIGGER_STRING: been infected with a contagious ghoulish condition]

|-
| {{text anchor|IS_TRIGGER_STRING_SECOND}}
| Within I_SOURCE
| text
| Presented before the [[Interaction_token#IS_TRIGGER_STRING|IS_TRIGGER_STRING]] when describing the event in the second person.

[IS_TRIGGER_STRING_SECOND: have]

|-
| {{text anchor|IS_TRIGGER_STRING_THIRD}}
| Within I_SOURCE
| text
| Presented before the [[Interaction_token#IS_TRIGGER_STRING|IS_TRIGGER_STRING]] when describing the event in the third person.

[IS_TRIGGER_STRING_THIRD: has]

|-
| {{text anchor|IS_NAME}}
| Within I_SOURCE
| string
| Generally used with [[Interaction_token#I_SOURCE|[I_SOURCE:SECRET]]] interactions to describe what the secret is about (though it may be used to name any I_SOURCE). This name is engraved onto the appropriate secret-containing slabs from worldgen, and is used in legends mode when describing the secret being learnt by historical figures.

[IS_NAME:the secrets of life and death]

|-
| {{text anchor|IS_SPHERE}}
| Within I_SOURCE:SECRET
| [[Sphere#Available_spheres|sphere]]
| Indicates the [[sphere]] to which this secret pertains. Only one sphere can be defined for each [I_SOURCE:SECRET] token, so several [I_SOURCE:SECRET] tokens are required to make a secret belong to multiple spheres.

|-
| {{text anchor|IS_SECRET_GOAL}}
| Within I_SOURCE:SECRET
| Secret Goal token
| Indicates why somebody would want to learn the secret. Valid values:
* '''STAY_ALIVE'''
* '''MAINTAIN_ENTITY_STATUS'''
* '''START_A_FAMILY'''
* '''RULE_THE_WORLD'''
* '''CREATE_A_GREAT_WORK_OF_ART'''
* '''CRAFT_A_MASTERWORK'''
* '''BRING_PEACE_TO_THE_WORLD'''
* '''BECOME_A_LEGENDARY_WARRIOR'''
* '''MASTER_A_SKILL'''
* '''FALL_IN_LOVE'''
* '''SEE_THE_GREAT_NATURAL_SITES'''
* '''IMMORTALITY'''
* '''MAKE_A_GREAT_DISCOVERY'''
* '''ATTAIN_RANK_IN_SOCIETY'''
* '''BATHE_WORLD_IN_CHAOS'''
However, currently only IMMORTALITY will result in a secret being pursued during worldgen.

|-
| {{text anchor|IS_SECRET}}
| Within I_SOURCE:SECRET
| Secret Flag
| Indicates how the secret can be learned. Valid values:
* '''SUPERNATURAL_LEARNING_POSSIBLE''' - gods may gift the secret to their worshippers. Secrets with [[Interaction_token#IS_SPHERE|[IS_SPHERE]]] specified may only be granted by gods who have at least one matching sphere.
* '''MUNDANE_RESEARCH_POSSIBLE''' - the secret can be researched by mundane means. This doesn't do anything at present. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222].
* '''MUNDANE_TEACHING_POSSIBLE''' - the secret can be taught to apprentices
* '''MUNDANE_RECORDING_POSSIBLE:TITLE_SET:NAME_SET''' - the secret can be written in books whose title and name are taken from the specified text sets. If this tag is present, a slab will be created upon learning the secret by supernatural means.

|-
| {{text anchor|IS_USAGE_HINT}}
| Within I_SOURCE:DEITY
| Usage Hint token
| Indicates why a deity would choose to perform this interaction. See [[Interaction_token#USAGE_HINT|CDI:USAGE_HINT]] below for valid values - in this context, '''MINOR_BLESSING''', '''MEDIUM_BLESSING''', '''MINOR_CURSE''', '''MEDIUM_CURSE''', and '''MAJOR_CURSE''' are the only values that make sense.

|-
| {{text anchor|IS_REGION}}
| Within I_SOURCE:REGION
| Region type
| Indicates what types of regions are capable of performing this interaction. This token may be specified several times per I_SOURCE to permit multiple terrain/alignment types. Valid values:

* '''ANY''' permits the interaction to occur in all regions, regardless of terrain or alignment

[[Biome|Terrain]]:

* '''DESERT'''
* '''FOREST'''
* '''GLACIER'''
* '''GRASSLAND'''
* '''HILLS'''
* '''LAKE'''
* '''MOUNTAINS'''
* '''OCEAN'''
* '''SWAMP'''
* '''TUNDRA'''
* '''ANY_TERRAIN''' permits the interaction to occur in all regions which meet alignment specifications

[[Surroundings#Combinations & characteristics of surroundings|Alignment]]:

* '''NORMAL_ALLOWED'''
* '''EVIL_ALLOWED'''
* '''GOOD_ALLOWED'''
* '''SAVAGE_ALLOWED'''
* '''EVIL_ONLY'''
* '''GOOD_ONLY'''
* '''SAVAGE_ONLY'''

|-
| {{text anchor|IS_FREQUENCY}}
| Within I_SOURCE
| Probability
| When used with [[Interaction_token#I_SOURCE|[I_SOURCE:REGION]]], determines how likely it is for the region(s) specified via [[Interaction_token#IS_REGION|[IS_REGION]]] to possess this interaction.

Note: it appears that regions aren't allowed to possess more than a single regional interaction at present.

|-
| {{text anchor|I_TARGET}}
| Global
| ID, type
| Defines the targets available for subsequent use with [[Interaction_token#I_EFFECT|[I_EFFECT]]] tokens. Multiple targets may be specified; the precise target(s) used with each interaction effect are indicated via their ID (see [[Interaction_token#IE_TARGET|[IE_TARGET]]]). Valid values:
* '''CORPSE''' - The target is a [[Item_token#CORPSE|CORPSE]] or [[Item_token#CORPSEPIECE|CORPSEPIECE]] item.
* '''CREATURE''' - The target is a [[Creature|unit]].
* '''MATERIAL''' - This is a valid target for use in [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] interaction effects, and is used to set the material or flow type of the emission. This information, in turn, is either obtained from an [[Interaction_token#IT_MATERIAL|[IT_MATERIAL]]] token or by using [[Interaction_token#IT_LOCATION|[IT_LOCATION:CONTEXT_MATERIAL]]]. Using the latter implies that the precise emission info will be provided when defining [[Interaction_token#Breath_attacks|how an interaction user can use the interaction in question via CDI tokens]], enabling one to create 'template' material emission interactions such as the MATERIAL_EMISSION and MATERIAL_EMISSION_WITH_HIDE interactions included in the vanilla raws.
* '''LOCATION''' - The target is a [[tile|local map tile]]. If used with [[Interaction_token#IT_LOCATION|[IT_LOCATION:CONTEXT_CREATURE_OR_LOCATION]]], creatures at the target tile are also valid targets.

|-
| {{text anchor|IT_LOCATION}}
| Within I_TARGET
| Location
| This is often included after [[Interaction_token#I_TARGET|[I_TARGET]]] token to add more detail about the target. Valid values:
* '''CONTEXT_CREATURE''' - Used with CREATURE to target the whole unit.
* '''CONTEXT_BP''' - Used with CREATURE to target the body part specified in [[Interaction_token#BP_REQUIRED|[CDI:BP_REQUIRED]]].
* '''CONTEXT_LOCATION''' - Used with LOCATION to target only a tile.
* '''CONTEXT_CREATURE_OR_LOCATION''' - Used with LOCATION to allow for targetting of both creatures and tiles.
* '''CONTEXT_ITEM''' - Used with CORPSE.
* '''CONTEXT_REGION''' - Can only be used by [[Interaction_token#I_SOURCE|[I_SOURCE:REGION]]] interactions.
* '''CONTEXT_MATERIAL''' - Used with MATERIAL if you want an [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] to obtain the emission material/flow type from [[Interaction_token#MATERIAL|[CDI:MATERIAL]]] or [[Interaction_token#FLOW|[CDI:FLOW]]].
* '''RANDOM_NEARBY_LOCATION''' - Used with LOCATION. Targets a location from somewhere random within a number of squares from another LOCATION target specified by its target ID. For example, [I_TARGET:B:LOCATION] with [IT_LOCATION:RANDOM_NEARBY_LOCATION:A:5] will randomly select a tile lying somewhere within a radius of 5 tiles from [I_TARGET:A:LOCATION]. A walkable path between the two locations must exist.

|-
| {{text anchor|IT_MANUAL_INPUT}}
| Within I_TARGET
| text
| Tells the adventure mode player what they should be selecting. If not specified, the player will only be able to target themselves.

|-
| {{text anchor|IT_AFFECTED_CREATURE}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| CREATURE:CASTE
| Specifies specific creatures the interaction can target.

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

|-
| {{text anchor|IT_IMMUNE_CREATURE}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| CREATURE:CASTE
| Specifies specific creatures the interaction cannot target.

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

|-
| {{text anchor|IT_REQUIRES}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature token or property
| Indicates that the target must have the specified property. Valid values:
* '''FIT_FOR_ANIMATION''' - Any corpse or body part that can become a zombie (heads, hands, etc.)
* '''FIT_FOR_RESURRECTION''' - The target corpse's UPPERBODY must be attached.
* '''HAS_BLOOD'''
* '''MORTAL'''
* '''NO_AGING'''
* '''STERILE'''
* Creature token: '''BLOODSUCKER, CAN_LEARN, CAN_SPEAK, CRAZED, EXTRAVISION, MISCHIEVOUS''' (or '''MISCHIEVIOUS'''), '''NO_CONNECTIONS_FOR_MOVEMENT, NO_DIZZINESS, NO_DRINK, NO_EAT, NO_FEVERS, NO_PHYS_ATT_GAIN, NO_PHYS_ATT_RUST, NO_SLEEP, NO_THOUGHT_CENTER_FOR_MOVEMENT, NOBREATHE, NOEMOTION, NOEXERT, NOFEAR, NONAUSEA, NOPAIN, NOSTUN, NOT_LIVING, NOTHOUGHT, OPPOSED_TO_LIFE, PARALYZEIMMUNE, SUPERNATURAL, TRANCES, UTTERANCES'''

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

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

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

|-
| {{text anchor|IT_MATERIAL}}
| Within I_TARGET:MATERIAL
| type
| Specifies the type of material the interaction targets; currently only used for [[Interaction_token#I_EFFECT|MATERIAL_EMISSION]] interaction effects. See [[Interaction_token#Breath_Attacks_Types|Breath Attack Types]]. Valid values:
* '''FLOW''':Breath attack token - The emission will consist of the specified special flow type.
* '''MATERIAL''':[[Material token]]:Breath attack token - The emission will consist of the specified material dispersed in the specified manner.
* '''CONTEXT_MATERIAL''' - Indicates the emission details should be obtained from [[Interaction_token#MATERIAL|[CDI:MATERIAL]]] or [[Interaction_token#FLOW|[CDI:FLOW]]].

|-
| {{text anchor|I_EFFECT}}
| Global
| type
| Specifies what the interaction does to the targets. Multiple [I_EFFECT]s may be specified in a single interaction, and the same type may be used more than once. Valid values:

* '''ADD_SYNDROME''' - Adds one or more syndromes to a valid creature target. You must specify the syndrome details just below this interaction effect using the <code>[[Syndrome#SYNDROME|[SYNDROME]]]</code> tag followed by the relevant syndrome tokens. See [[syndrome#The anatomy of a syndrome|here]] for more information.

* '''ANIMATE''' - Raises the target corpse/bodypart as an [[undead]] unit. The zombie will always be hostile to life and will retain no information about its original personality/loyalties. Syndromes can also be specified within this tag. If a regional interaction contains this effect, affected regions will have undead wildlife.

* '''RESURRECT''' - Takes a target corpse and returns the creature to life. This can be used on parts that are not FIT_FOR_RESURRECTION, but only the main part (with an UPPERBODY attached) will remain loyal to its original faction. Syndromes can also be specified within this tag.

* '''CLEAN''' - Removes [[Contaminant|contaminants]] from a valid creature target. See {{token|IE_GRIME_LEVEL|in}} and {{token|IE_SYNDROME_TAG|in}}.

* '''CONTACT''' - Causes the creatures to touch.

* '''MATERIAL_EMISSION''' - Causes a particular material to be emitted. Used by [[evil weather]] and the MATERIAL_EMISSION interaction.

* '''HIDE''' - Allows the creature to [[Ambusher|hide]] even if another creature can see it.

* '''CREATE_ITEM''' - Creates an item as described by {{token|IE_ITEM|in}} and {{token|IE_ITEM_QUALITY|in}}.

* '''CHANGE_ITEM_QUALITY''' - Alters an item's quality level as indicated by either {{token|IE_CHANGE_QUALITY|in}} or {{token|IE_SET_QUALITY|in}}. When targeting a unit, all items equipped by that unit will be affected.

* '''SUMMON_UNIT''' - Creates a new unit at the target. The type of unit can either be specified using the {{token|CREATURE|in}} token, or made to be randomly selected as indicated by a variety of flag-based tokens: {{token|IE_CREATURE_FLAG|in}}, {{token|IE_FORBIDDEN_CREATURE_FLAG|in}}, {{token|IE_CREATURE_CASTE_FLAG|in}}, {{token|IE_FORBIDDEN_CREATURE_CASTE_FLAG|in}}, {{token|IE_HAVE_FAST_EFFORTLESS_GAIT_SPEED|in}} and/or {{token|IE_ALL_SLOW_EFFORTLESS_GAIT_SPEED|in}}. See also {{token|IE_TIME_RANGE|in}} and {{token|IE_MAKE_PET_IF_POSSIBLE|in}}.

* '''PROPEL_UNIT''' - Applies a force specified using {{token|IE_PROPEL_FORCE|in}} to a unit to knock it back.

* '''CHANGE_WEATHER''' - Changes the weather as specified by {{token|IE_ADD_WEATHER|in}} and/or {{token|IE_REMOVE_WEATHER|in}}.

* '''RAISE_GHOST''' - Present in version 0.47.01 and accepted as a valid I_EFFECT token, but does not have an effect currently.

|-
| {{text anchor|IE_ARENA_NAME}}
| Within I_EFFECT
| text
| Allows the interaction effect to be applied directly to newly spawned creatures in [[object testing arena|arena mode]]. The specified name is used to represent it within the creature creation [[Object_testing_arena#Effects|effects list]].

|-
| {{text anchor|IE_TARGET}}
| Within I_EFFECT
| ID
| Specifies which [[Interaction_token#I_TARGET|I_TARGET]] a particular interaction effect will be applied to. For example, in an interaction with the token [I_TARGET:B:CREATURE], 'B' is the ID used to indicate this target option. [I_EFFECT:ADD_SYNDROME] followed by [IE_TARGET:B] would therefore apply the syndrome to this target. Certain types of interaction effects require multiple IE_TARGET tokens in a specific order to function properly. A few effects do not require a target at all.

|-
| {{text anchor|IE_INTERMITTENT}}
| Within I_EFFECT
| Frequency
| Only appears to work with [I_SOURCE:REGION] interactions. Indicates that the effect happens intermittently and specifies roughly how often. Regional interactions aren't able to use effects which lack this token. Valid values:
* '''WEEKLY'''

Note: DAILY, MONTHLY and YEARLY also exist in the string dump but don't appear to work at present.

|-
| {{text anchor|IE_IMMEDIATE}}
| Within I_EFFECT
|
| Indicates that the effect happens immediately.

|-
| {{text anchor|IE_LOCATION}}
| Within I_EFFECT
| Location Hint
| Prevents the interaction effect from manifesting unless the target is in a location which meets the specified criteria.
Valid values:
* '''IN_WATER'''
* '''IN_MAGMA'''
* '''NO_WATER'''
* '''NO_MAGMA'''
* '''NO_THICK_FOG'''
* '''OUTSIDE'''
A [[Water#Depth|depth]] of 1/7 is sufficient for IN_WATER and IN_MAGMA.

Note: NO_THICK_FOG and OUTSIDE are accepted as valid location hints when specified with IE_LOCATION, but don't appear to work. It's possible that they're currently only implemented for use with <code>[[Interaction_token#LOCATION_HINT|[CDI:LOCATION_HINT]]]</code>.

|-
| {{text anchor|IE_ADD_WEATHER}}
| Within I_EFFECT:CHANGE_WEATHER
| type
| Indicates what type of weather is added. Valid values:
* '''FOG_MIST'''
* '''FOG_NORMAL'''
* '''FOG_THICK'''
* '''FRONT_WARM'''
* '''FRONT_COLD'''
* '''FRONT_OCCLUDED'''
* '''STRATUS_ALTO'''
* '''STRATUS_PROPER'''
* '''STRATUS_NIMBUS'''
* '''CUMULUS_MED'''
* '''CUMULUS_MULTI'''
* '''CUMULUS_NIMBUS'''
* '''CIRRUS'''

|-
| {{text anchor|IE_REMOVE_WEATHER}}
| Within I_EFFECT:CHANGE_WEATHER
| type
| Indicates what type of weather is removed. See [[Interaction_token#IE_ADD_WEATHER|above]] for a list of valid weather types.

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

|-
| {{text anchor|IE_SYNDROME_TAG}}
| Within I_EFFECT:CLEAN
| syndrome trigger flag
| When a creature cleans off a [[contaminant]] which is associated with a [[syndrome]], the syndrome will be contracted if it has a matching [[Syndrome#The_anatomy_of_a_syndrome|trigger flag]]. This is what enables [[cat]]s to become slightly inebriated when licking off [[alcohol]]. '''SYN_INGESTED''' appears to be the only syndrome trigger flag that works in this context.

|-
| {{text anchor|IE_PROPEL_FORCE}}
| Within I_EFFECT:PROPEL_UNIT
| amount
| Indicates the amount of force that the target will be propelled with.

|-
| {{text anchor|IE_ITEM}}
| Within I_EFFECT:CREATE_ITEM
| <probability>:<quantity>:[[item token]]:[[material token]]
| Defines what item will be created.

|-
| {{text anchor|IE_ITEM_QUALITY}}
| Within I_EFFECT:CREATE_ITEM
| <[[Item_quality|quality]]> OR <minimum [[Item_quality|quality]]>:<maximum [[Item_quality|quality]]>
| Defines what [[Item quality|quality]] the created item shall have. Can either be specified in the form of a single, fixed quality (it seems that ARTIFACT can only be used in this manner), or a minimum and maximum level (in which case the quality is selected randomly). Valid values (numerals only except for ARTIFACT):
* '''0''' = ordinary
* '''1''' = well-crafted
* '''2''' = finely crafted
* '''3''' = superior quality
* '''4''' = exceptional
* '''5''' = masterwork
* '''ARTIFACT'''

|-
| {{text anchor|IE_SET_QUALITY}}
| Within I_EFFECT:CHANGE_ITEM_QUALITY
| [[Interaction_token#IE_ITEM_QUALITY|quality level]]
| Defines a fixed [[Item_quality|quality]] level which the affected item(s) will be set to (decreasing or increasing in quality as necessary). See [[Interaction_token#IE_ITEM_QUALITY|above]] for a list of valid quality levels (but note that ARTIFACT cannot be used in this effect).

|-
| {{text anchor|IE_CHANGE_QUALITY}}
| Within I_EFFECT:CHANGE_ITEM_QUALITY
| amount
| Determines how much the [[Item_quality|quality]] of the item(s) will be changed. For instance, improving a well-crafted -item- ([[Interaction_token#IE_ITEM_QUALITY|quality level]] 1) by 2 will turn it into a superior-quality *item* (quality level 3). A negative value can be used to decrease quality. Quality cannot be increased beyond level 5 (masterwork) or decreased below level 0 (ordinary).

|-
| {{text anchor|CREATURE}}
| Within I_EFFECT:SUMMON_UNIT
| <creature token>:<caste token>
| Indicates which specific creature will be created when using this interaction. ANY can be used in place of a specific caste token. Only one [CREATURE] may currently be specified per interaction effect.

|-
| {{text anchor|IE_CREATURE_FLAG}}
| Within I_EFFECT:SUMMON_UNIT
| <[[Interaction_token#Creature_and_Caste_Flags|creature flag]]>
| When this token is added to a random creature summoning effect, it narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]]. This token may be used multiple times per interaction effect; creatures which lack any of the indicated flags will never be summoned.

|-
| {{text anchor|IE_FORBIDDEN_CREATURE_FLAG}}
| Within I_EFFECT:SUMMON_UNIT
| <[[Interaction_token#Creature_and_Caste_Flags|creature flag]]>
| When this token is added to a random creature summoning effect, any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] will be excluded from the selection. This token may be used multiple times per interaction effect; creatures which possess any of the indicated flags will never be summoned.

|-
| {{text anchor|IE_CREATURE_CASTE_FLAG}}
| Within I_EFFECT:SUMMON_UNIT
| <[[Interaction_token#Creature_and_Caste_Flags|caste flag]]>
| When this token is added to a random creature summoning effect, it narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. This token may be used multiple times per interaction effect; creatures which lack any of the indicated flags will never be summoned.

|-
| {{text anchor|IE_FORBIDDEN_CREATURE_CASTE_FLAG}}
| Within I_EFFECT:SUMMON_UNIT
| <[[Interaction_token#Creature_and_Caste_Flags|caste flag]]>
| When this token is added to a random creature summoning effect, it excludes any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. This token may be used multiple times per interaction effect; creatures which possess any of the indicated flags will never be summoned.

|-
| {{text anchor|IE_HAVE_FAST_EFFORTLESS_GAIT_SPEED}}
| Within I_EFFECT:SUMMON_UNIT
| <minimum [[Gait#Speed|gait speed]]>
| When this token is added to a random creature summoning effect, it narrows down the selection to creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] less than or equal to the specified <minimum gait speed> ("less than" because lower is faster in the scale used for [[Gait#Speed|gait speed]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

|-
| {{text anchor|IE_ALL_SLOW_EFFORTLESS_GAIT_SPEED}}
| Within I_EFFECT:SUMMON_UNIT
| <maximum [[Gait#Speed|gait speed]]>
| When this token is added to a random creature summoning effect, it excludes any creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] value less than or equal to the specified <maximum gait speed> (note that larger values are slower in the scale used for [[Gait#Speed|gait speed]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

|-
| {{text anchor|IE_TIME_RANGE}}
| Within I_EFFECT:SUMMON_UNIT
| <minimum [[Time|ticks]]>:<maximum [[Time|ticks]]>
| The summoned unit vanishes in a puff of smoke once a certain amount of time has elapsed. The time limit is a randomly selected number of ticks within the specified minimum-maximum time range. The unit will persist indefinitely if this token is omitted.

|-
| {{text anchor|IE_MAKE_PET_IF_POSSIBLE}}
| Within I_EFFECT:SUMMON_UNIT
|
| Makes the summoned unit behave as a pet of the unit who performed the summoning interaction.

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

|}

==Usage==
To enable a particular type of creature to use an interaction directly, the [[creature token]] <code>[[Creature_token#CAN_DO_INTERACTION|[CAN_DO_INTERACTION:<interaction name>]]]</code> should be added to its creature raws (replacing '<interaction name>' with the ID of the desired interaction; for an interaction called <code>[INTERACTION:CLEANING]</code> in the raws, the ID would be "CLEANING"), followed by a series of [CDI:...] tokens as detailed below.

Interactions can also be granted to individual creatures via [[syndrome]]s using the syndrome effect token <code>[[Syndrome#CE_CAN_DO_INTERACTION|[CE_CAN_DO_INTERACTION]]]</code> followed by <code>[[Interaction_token#INTERACTION|[CDI:INTERACTION:<interaction name>]]]</code> and additional CDI tokens as required.

The following is a list of valid CDI tokens. Precede them with "CDI:" in the style of <code>[CDI:ADV_NAME:Clean]</code>, for example.
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| {{text anchor|INTERACTION}}
| ID
| Specifies which interaction can be performed. This is only needed following [[Syndrome#Special_Effects|CE_CAN_DO_INTERACTION]]; there's no need to include this after [[Creature_token#CAN_DO_INTERACTION|CAN_DO_INTERACTION]] as the latter allows you to specify the interaction directly (as explained [[Interaction_token#Usage|above]]).

|-
| {{text anchor|ADV_NAME}}
| text
| Specifies the name of the interaction as it will appear on the [[Adventurer_mode|adventure mode]] 'powers/abilities' menu.

|-
| {{text anchor|TARGET}}
| target ID, target types
| Specifies how the creature chooses what to target. Target ID refers to an I_TARGET defined in the interaction itself. Multiple target types can be specified. If no target is specified, creature will target any available target within range, even through walls. Valid target types:
* '''LINE_OF_SIGHT''' - the source needs to be able to see the target
* '''TOUCHABLE''' - the source needs to be able to touch the target
* '''DISTURBER_ONLY''' - the target must be whoever disturbed the source (this is currently only relevant to [[mummy|mummies]], allowing them to curse solely the unit who disturbed their [[tomb|resting place]])
* '''SELF_ALLOWED''' - the target can be the source
* '''SELF_ONLY''' - the target '''must''' be the source

|-
| {{text anchor|TARGET_RANGE}}
| target ID, range
| Determines the maximum distance from the interaction user (in [[tile]]s) at which something can be considered a valid target. For [[Interaction_token#SOLID_GLOB|SOLID_GLOB]], [[Interaction_token#SHARP_ROCK|SHARP_ROCK]], [[Interaction_token#LIQUID_GLOB|LIQUID_GLOB]] and [[Interaction_token#FIREBALL|FIREBALL]] breath attacks, also determines how far the projectiles can fly before falling to the ground.

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

|-
| {{text anchor|LOCATION_HINT}}
| Location Hint
| Prevents CPU-controlled creatures from using the interaction unless they are in a location which meets the specified criteria. See [[Interaction_token#IE_LOCATION|above]] for a list of valid location hint values.

|-
| {{text anchor|USAGE_HINT}}
| Usage hint token
| Indicates when and how CPU-controlled creatures will use the interaction. If no hint is specified in fortress mode, the interaction will be performed at the every opportunity in combat. Multiple usage hints may be specified. Valid values:
* '''GREETING''' - Creatures will target 'friendly' creatures, usually at random.
* '''ATTACK''' - Targets enemy creatures in combat. If the interaction specifies SELF_ONLY, CPU-controlled creatures will never use it.
* '''DEFEND''' - Used in combat. Creature will target itself.
* '''FLEEING''' - Used when fleeing an enemy. Creature will target itself.
* '''CLEAN_SELF''' - Creature targets itself when its body is covered with [[contaminant]]s.
* '''CLEAN_FRIEND''' - As above, but targets other friendly units instead.
* '''NEGATIVE_SOCIAL_RESPONSE''' - Used when a creature is expressing contempt (for example, to a murderer). This is used in the default spitting interaction, for example.
* '''TORMENT''' - This is also used in the default spitting interaction, and is presumably used in a similar context.
* '''MINOR_BLESSING''' - Used in divination dice blessings. Targets the roller.
* '''MEDIUM_BLESSING''' - Used in divination dice blessings. Targets the roller.
* '''MINOR_CURSE''' - Used in divination dice curses. Targets the roller.
* '''MEDIUM_CURSE''' - Used in divination dice curses. Targets the roller.
* '''MAJOR_CURSE''' - Used in disturbance and deity curses. Targets the tomb disturber/temple defiler.

|-
| {{text anchor|WAIT_PERIOD}}
| number
| The creature must wait the specified number of [[time|ticks]] before being able to use the interaction again. The delay defaults to 20 ticks if this is omitted. Setting it to 0 removes the delay altogether.
Note: A WAIT_PERIOD of 10 is 10 ticks long in [[fortress mode]], but only 1 tick long in [[adventurer mode]].

|-
| {{text anchor|FREE_ACTION}}
|
| Indicates that performing the interaction doesn't take any time.

|-
| {{text anchor|BP_REQUIRED}}
| Body part criteria
| Indicates that a particular body part must be present in order to perform the interaction. Criteria are '''BY_CATEGORY:'''[[Body_token#CATEGORY|category]], '''BY_TYPE:'''type (GRASP, for example), or '''BY_TOKEN:'''[[Body_token#BP|token]] (uses the body part ID). See [[Body_token|body token]].

|-
| {{text anchor|VERBAL}}
|
| Only creatures that [[Creature_token#CAN_SPEAK|can speak]] will be able to use the interaction. Might also be needed for VERBAL_SPEECH.

|-
| {{text anchor|VERBAL_SPEECH}}
| text set
| Specifies what the creature says when they perform the interaction. Text sets are defined in text_* raws.

|-
| {{text anchor|CAN_BE_MUTUAL}}
|
| Presumably allows two creatures with the same interaction to use it on each other simultaneously, for example, cats cleaning each other.

|-
| {{text anchor|VERB}}
| self:other:mutual
| When a creature uses the interaction, a combat report message will be displayed in the form:

[interaction user(s)] [VERB text] [target creature (if applicable)]

The 'self' text is presented when describing the interaction in the second person (that is, when the interaction is carried out by the player character in [[adventure mode]]), the 'other' text is presented when describing it in the third person, and the 'mutual' text is presented when the interaction is carried out in a [[Interaction_token#CAN_BE_MUTUAL|mutual]] fashion.

[CDI:VERB:lick:licks:lick each other]

[CDI:VERB:gesture:gestures:NA]

|-
| {{text anchor|VERB_REVERSE}}
| ?
| ?

|-
| {{text anchor|TARGET_VERB}}
| self:other
| When a creature uses the interaction, a message will display, describing the target as doing this.
[CDI:TARGET_VERB:shudder and begin to move:shudders and begins to move]

|-
| {{text anchor|FLOW}}
| [[#Breath Attack Types|Breath attack token]]
| Can be used with interactions that have [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] and [[Interaction_token#IT_LOCATION|[IT_LOCATION:CONTEXT_MATERIAL]]] (or [[Interaction_token#IT_MATERIAL|[IT_MATERIAL:CONTEXT_MATERIAL]]]) to make the interaction emit a special flow type. Valid values:
* '''[[Interaction_token#FIREBALL|FIREBALL]]'''
* '''[[Interaction_token#FIREJET|FIREJET]]'''
* '''[[Interaction_token#DRAGONFIRE|DRAGONFIRE]]'''.

|-
| {{text anchor|MATERIAL}}
| [[Material token]]:[[Interaction_token#Breath_Attack_Types|Breath attack token]]
| Can be used with interactions that have [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] and [[Interaction_token#IT_LOCATION|[IT_LOCATION:CONTEXT_MATERIAL]]] (or [[Interaction_token#IT_MATERIAL|[IT_MATERIAL:CONTEXT_MATERIAL]]]) to make the interaction emit the specified material in the manner described by the [[Interaction_token#Breath_Attack_Types|breath attack token]] used.

|}

==Breath attacks==
Breath attacks are controlled by the MATERIAL_EMISSION interaction, like so:

[CAN_DO_INTERACTION:MATERIAL_EMISSION]
[CDI:ADV_NAME:Breath custom material]
[CDI:USAGE_HINT:ATTACK]
[CDI:BP_REQUIRED:BY_CATEGORY:MOUTH]
[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]
[CDI:TARGET:C:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:C:15]
[CDI:MAX_TARGET_NUMBER:C:1]
[CDI:WAIT_PERIOD:50]

The most important part is this line:

[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]

The CDI refers to CAN_DO_INTERACTION; the MATERIAL states that this line shows what the material is. LOCAL_CREATURE_MAT:CUSTOMMATERIAL is your material, and TRAILING_VAPOR_FLOW refers to the breath attack type. Other types are seen below. Also important is this line:

[CDI:TARGET:C:LINE_OF_SIGHT]

LINE_OF_SIGHT refers to where the target C may be; others include SELF_ALLOWED (presumably like LINE_OF_SIGHT, but with the creature allowed to target itself), SELF_ONLY (preferable for undirected attacks and TOUCHABLE (for up-close attacks, as trailing flows tend to be).

===Breath Attack Types===

'''[CDI:MATERIAL:<[[material token]]>:<material emission type>]'''

Is used to emit a specific material in a specific manner. A list of valid emission types can be found below.

Examples:

[CDI:MATERIAL:INORGANIC:GABBRO:[[Interaction_token#SHARP_ROCK|SHARP_ROCK]]]
shoots a sharp [[gabbro]] rock
[CDI:MATERIAL:PLANT_MAT:GRASS_CAVE_WHEAT:MILL:[[Interaction_token#UNDIRECTED_DUST|UNDIRECTED_DUST]]]
releases a cloud of [[Cave wheat|dwarven wheat flour]]
[CDI:MATERIAL:CREATURE_MAT:DWARF:TEARS:[[Interaction_token#SPATTER_LIQUID|SPATTER_LIQUID]]]
creates a pool of [[dwarf|dwarven]] tears

'''[CDI:FLOW:<flow emission type>]'''

Is used to emit one of the special hardcoded flow types ([[Interaction_token#FIREBALL|FIREBALL]], [[Interaction_token#FIREJET|FIREJET]] or [[Interaction_token#DRAGONFIRE|DRAGONFIRE]]).

Example:

[CDI:FLOW:[[Interaction_token#DRAGONFIRE|DRAGONFIRE]]]

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Usage Type
! Description
|-
| {{text anchor|TRAILING_DUST_FLOW}}
| MATERIAL
| Shoots a trail of solid dust at the target. Appears to use [[cave-in]] dust physics, as the dust cloud will fling around anything it comes in contact with (including the creature who emitted it), making it capable of smashing creatures into the ground and flinging them over walls. Creatures caught in the dust cloud will be [[contaminant|covered]] with dust; this will trigger any associated [[Syndrome#SYN_CONTACT|contact syndromes]].
|-
| {{text anchor|TRAILING_VAPOR_FLOW}}
| MATERIAL
| Shoots a trail of liquid mist at the target. Creatures caught in the vapor will be [[contaminant|covered]] with the condensed liquid; this will trigger any associated [[Syndrome#SYN_CONTACT|contact syndromes]].
|-
| {{text anchor|TRAILING_GAS_FLOW}}
| MATERIAL
| Shoots a trail of gaseous substance at the target. This can be inhaled, triggering any associated [[Syndrome#SYN_INHALED|inhalation syndromes]].
|-
| {{text anchor|TRAILING_ITEM_FLOW}}:[[item token]]
| MATERIAL
| Shoots a "cloud" of items at the target, leaving piles of this item on the floor. Note that this does ''not'' create the actual items or use falling item mechanics (meaning no flying daggers or Touhou-style barrages, unfortunately). Instead, this token acts as [[Interaction_token#TRAILING_GAS_FLOW|TRAILING_GAS_FLOW]], except that the material will use its ''normal'' temperature - for example, a breath attack of steel anvils will envelop the target in a "burst of steel".
|-
| {{text anchor|UNDIRECTED_DUST}}
| MATERIAL
| The creature releases a cloud of solid dust which spreads and dissipates. Similar to [[Interaction_token#TRAILING_DUST_FLOW|TRAILING_DUST_FLOW]], but undirected, thus affecting a larger area but losing the distance - range is roughly the same as that of a cave-in. Creature will attack as normal. <s>DO NOT USE THIS TAG UNLESS YOU WANT TO KILL THE CREATURE AND EVERYTHING NEAR IT AND SEND PEOPLE FLYING.</s> You know you want to.
|-
| {{text anchor|UNDIRECTED_VAPOR}}
| MATERIAL
| The creature releases a cloud of liquid mist which spreads and dissipates. Similar to [[Interaction_token#TRAILING_VAPOR_FLOW|TRAILING_VAPOR_FLOW]], but undirected, thus affecting a larger area but losing the distance.
|-
| {{text anchor|UNDIRECTED_GAS}}
| MATERIAL
| The creature releases a cloud of gaseous material which spreads and dissipates. Similar to [[Interaction_token#TRAILING_GAS_FLOW|TRAILING_GAS_FLOW]], but undirected, thus affecting a larger area but losing the distance.
|-
| {{text anchor|UNDIRECTED_ITEM_CLOUD}}:[[item token]]
| MATERIAL
| The creature releases a "cloud" of items at the target, leaving piles of this item on the floor. The same comments apply as [[Interaction_token#TRAILING_ITEM_FLOW|TRAILING_ITEM_FLOW]].
|-
| {{text anchor|WEATHER_CREEPING_DUST}}
| MATERIAL
| Creates a cloud of creeping dust. Not usable by creatures.
|-
| {{text anchor|WEATHER_CREEPING_VAPOR}}
| MATERIAL
| Creates a cloud of creeping vapor. Not usable by creatures.
|-
| {{text anchor|WEATHER_CREEPING_GAS}}
| MATERIAL
| Creates a cloud of gas that appears at the edge of the map and slowly creeps across the map. Not usable by creatures.
|-
| {{text anchor|WEATHER_FALLING_MATERIAL}}
| MATERIAL
| Causes it to start raining a particular material. If the material is solid at the outdoor temperatures, it will snow the material instead. Can transfer [[Syndrome#SYN_CONTACT|contact syndromes]]. Regardless of the nature of the material, being caught in it will give dwarves the negative [[thought]] of being 'caught in freakish weather lately'. Not usable by creatures.
|-
| {{text anchor|SOLID_GLOB}}
| MATERIAL
| Shoots a [[Item_token#GLOB|solid glob]] of spinning substance at the target, leaving a symbol similar to broken arrows, if it misses. Essentially a projectile weapon. If the [[Interaction_token#WAIT_PERIOD|cooldown rate]] is short enough, some creatures with this breath attack will not move, preferring instead to hold position and shoot globs at their enemies, even when they are right next to them.
|-
| {{text anchor|SHARP_ROCK}}
| MATERIAL
| Just like [[Interaction_token#SOLID_GLOB|SOLID_GLOB]], but more harmful, as it shoots a sharpened [[Item_token#ROCK|solid chunk]] of material instead.
|-
| {{text anchor|LIQUID_GLOB}}
| MATERIAL
| Shoots a [[Item_token#LIQUID_MISC|liquid glob]] of substance at the target. [[Syndrome#SYN_CONTACT|Contact syndromes]] will take effect if the glob hits the target's exposed skin.
|-
| {{text anchor|SPATTER_POWDER}}
| MATERIAL
| Creates a [[contaminant|pile of powder]] at the specified location.
|-
| {{text anchor|SPATTER_LIQUID}}
| MATERIAL
| Creates a [[contaminant|pool of liquid]] at the specified location.
|-
| {{text anchor|WEB_SPRAY}}
| MATERIAL
| Emits a burst of [[web]]s that entangle target creatures.
|-
| {{text anchor|DRAGONFIRE}}
| FLOW
| Emits a wide cone of [[dragon]] [[fire]] that burns target creatures at a scorching {{ct|50000}}.
|-
| {{text anchor|FIREJET}}
| FLOW
| Emits a narrow cone of [[fire]] that burns target creatures at {{ct|11000}}.
|-
| {{text anchor|FIREBALL}}
| FLOW
| Emits a fireball that burns the target creature.
|}

Keep in mind that you can give a creature multiple breath attacks, which appears to make the creature choose between them at random. Creatures cannot use the WEATHER effects, these being reserved for regional interactions.

One major difference between GAS, VAPOR, and DUST is that if the material cannot exist in the specified state at the current temperature, it will automatically be created at a temperature allowing it to exist. So if you create a vapor spray that uses rock or metal as a material, that spray will be created at the material's melting point, setting everything it touches on fire. You can also create a freezing spray by using a custom material that has extremely low melting and/or boiling points.

If you give a creature a material breath attack, be aware that it will be caught in the attack more frequently than its targets. Make sure to make your creatures immune to their own breath weapons!

==Creature and Caste Flags==

Certain interaction and syndrome effects (currently limited to [[Interaction_token#I_EFFECT|[IE_SUMMON_UNIT]]] and [[Syndrome#CE_BODY_TRANSFORMATION|[CE_BODY_TRANSFORMATION]]]) permit modders to specify the required/forbidden creature and caste flags of the desired creature(s). These are a collection of internal flags which are derived from [[Creature_token|creature tokens]] but are not necessarily identical to them. The following lists contain creature and caste flag names as provided by Toady One in a FotF reply [http://www.bay12forums.com/smf//index.php?topic=169696.msg8099138#msg8099138] (valid as of 0.47.04).

{{gamedata|title=Creature Flags|
ALL_CASTES_ALIVE
ARTIFICIAL_HIVEABLE
BIOME_DESERT_BADLAND
BIOME_DESERT_ROCK
BIOME_DESERT_SAND
BIOME_FOREST_TAIGA
BIOME_FOREST_TEMPERATE_BROADLEAF
BIOME_FOREST_TEMPERATE_CONIFER
BIOME_FOREST_TROPICAL_CONIFER
BIOME_FOREST_TROPICAL_DRY_BROADLEAF
BIOME_FOREST_TROPICAL_MOIST_BROADLEAF
BIOME_GLACIER
BIOME_GRASSLAND_TEMPERATE
BIOME_GRASSLAND_TROPICAL
BIOME_LAKE_TEMPERATE_BRACKISHWATER
BIOME_LAKE_TEMPERATE_FRESHWATER
BIOME_LAKE_TEMPERATE_SALTWATER
BIOME_LAKE_TROPICAL_BRACKISHWATER
BIOME_LAKE_TROPICAL_FRESHWATER
BIOME_LAKE_TROPICAL_SALTWATER
BIOME_MARSH_TEMPERATE_FRESHWATER
BIOME_MARSH_TEMPERATE_SALTWATER
BIOME_MARSH_TROPICAL_FRESHWATER
BIOME_MARSH_TROPICAL_SALTWATER
BIOME_MOUNTAIN
BIOME_OCEAN_ARCTIC
BIOME_OCEAN_TEMPERATE
BIOME_OCEAN_TROPICAL
BIOME_POOL_TEMPERATE_BRACKISHWATER
BIOME_POOL_TEMPERATE_FRESHWATER
BIOME_POOL_TEMPERATE_SALTWATER
BIOME_POOL_TROPICAL_BRACKISHWATER
BIOME_POOL_TROPICAL_FRESHWATER
BIOME_POOL_TROPICAL_SALTWATER
BIOME_RIVER_TEMPERATE_BRACKISHWATER
BIOME_RIVER_TEMPERATE_FRESHWATER
BIOME_RIVER_TEMPERATE_SALTWATER
BIOME_RIVER_TROPICAL_BRACKISHWATER
BIOME_RIVER_TROPICAL_FRESHWATER
BIOME_RIVER_TROPICAL_SALTWATER
BIOME_SAVANNA_TEMPERATE
BIOME_SAVANNA_TROPICAL
BIOME_SHRUBLAND_TEMPERATE
BIOME_SHRUBLAND_TROPICAL
BIOME_SUBTERRANEAN_CHASM
BIOME_SUBTERRANEAN_LAVA
BIOME_SUBTERRANEAN_WATER
BIOME_SWAMP_MANGROVE
BIOME_SWAMP_TEMPERATE_FRESHWATER
BIOME_SWAMP_TEMPERATE_SALTWATER
BIOME_SWAMP_TROPICAL_FRESHWATER
BIOME_SWAMP_TROPICAL_SALTWATER
BIOME_TUNDRA
DOES_NOT_EXIST
EQUIPMENT
EQUIPMENT_WAGON
EVIL
FANCIFUL
GENERATED
GOOD
HAS_ANY_BENIGN
HAS_ANY_CANNOT_BREATHE_AIR
HAS_ANY_CANNOT_BREATHE_WATER
HAS_ANY_CAN_SWIM
HAS_ANY_CARNIVORE
HAS_ANY_COMMON_DOMESTIC
HAS_ANY_CURIOUS_BEAST
HAS_ANY_DEMON
HAS_ANY_FEATURE_BEAST
HAS_ANY_FLIER
HAS_ANY_FLY_RACE_GAIT
HAS_ANY_GRASP
HAS_ANY_GRAZER
HAS_ANY_HAS_BLOOD
HAS_ANY_IMMOBILE
HAS_ANY_INTELLIGENT_LEARNS
HAS_ANY_INTELLIGENT_SPEAKS
HAS_ANY_LARGE_PREDATOR
HAS_ANY_LOCAL_POPS_CONTROLLABLE
HAS_ANY_LOCAL_POPS_PRODUCE_HEROES
HAS_ANY_MEGABEAST
HAS_ANY_MISCHIEVIOUS
HAS_ANY_NATURAL_ANIMAL
HAS_ANY_NIGHT_CREATURE
HAS_ANY_NIGHT_CREATURE_BOGEYMAN
HAS_ANY_NIGHT_CREATURE_EXPERIMENTER
HAS_ANY_NIGHT_CREATURE_HUNTER
HAS_ANY_NIGHT_CREATURE_NIGHTMARE
HAS_ANY_NOT_FIREIMMUNE
HAS_ANY_NOT_FLIER
HAS_ANY_NOT_LIVING
HAS_ANY_OUTSIDER_CONTROLLABLE
HAS_ANY_POWER
HAS_ANY_RACE_GAIT
HAS_ANY_SEMIMEGABEAST
HAS_ANY_SLOW_LEARNER
HAS_ANY_SUPERNATURAL
HAS_ANY_TITAN
HAS_ANY_UNIQUE_DEMON
HAS_ANY_UTTERANCES
HAS_ANY_VERMIN_HATEABLE
HAS_ANY_VERMIN_MICRO
HAS_FEMALE
HAS_MALE
LARGE_ROAMING
LOOSE_CLUSTERS
MATES_TO_BREED
MUNDANE
OCCURS_AS_ENTITY_RACE
SAVAGE
SMALL_RACE - applies to any vermin creature
TWO_GENDERS
UBIQUITOUS
VERMIN_EATER
VERMIN_FISH
VERMIN_GROUNDER
VERMIN_ROTTER
VERMIN_SOIL
VERMIN_SOIL_COLONY
}}

{{gamedata|title=Caste Flags|
ADOPTS_OWNER
ALCOHOL_DEPENDENT
ALL_ACTIVE
AMBUSHPREDATOR
AQUATIC_UNDERSWIM
ARENA_RESTRICTED
AT_PEACE_WITH_WILDLIFE
BENIGN
BLOODSUCKER
BONECARN
CANNOT_BREATHE_AIR
CANNOT_CLIMB
CANNOT_JUMP
CANOPENDOORS
CAN_BREATHE_WATER
CAN_LEARN / INTELLIGENT_LEARNS
CAN_SPEAK / INTELLIGENT_SPEAKS
CAN_SWIM
CAN_SWIM_INNATE
CARNIVORE
CAVE_ADAPT
COLONY_EXTERNAL
COMMON_DOMESTIC
CONVERTED_SPOUSE
COOKABLE_LIVE
CRAZED
CREPUSCULAR
CURIOUS_BEAST
CURIOUS_BEAST_EATER
CURIOUS_BEAST_GUZZLER
CURIOUS_BEAST_ITEM
DEMON
DIE_WHEN_VERMIN_BITE
DIURNAL
DIVE_HUNTS_VERMIN
EQUIPS
EXTRAVISION
FEATURE_ATTACK_GROUP
FEATURE_BEAST
FIREIMMUNE
FIREIMMUNE_SUPER
FISHITEM
FLEEQUICK
FLIER
GELDABLE
GETS_INFECTIONS_FROM_ROT
GETS_WOUND_INFECTIONS
GNAWER
GRAZER
HASSHELL
HAS_BABYSTATE
HAS_BLOOD
HAS_CHILDSTATE
HAS_COLOR
HAS_FLY_RACE_GAIT
HAS_GLOW_COLOR
HAS_GLOW_TILE
HAS_GRASP
HAS_NERVES
HAS_PUS
HAS_RACE_GAIT
HAS_ROTTABLE
HAS_SECRETION
HAS_SOLDIER_TILE
HAS_SOUND_ALERT
HAS_SOUND_PEACEFUL_INTERMITTENT
HAS_TILE
HUNTS_VERMIN
IMMOBILE
IMMOBILE_LAND
IMMOLATE
ITEMCORPSE
LAIR_HUNTER
LARGE_PREDATOR
LAYS_EGGS
LAYS_UNUSUAL_EGGS
LIGAMENTS
LIGHT_GEN
LISP
LOCAL_POPS_CONTROLLABLE
LOCAL_POPS_PRODUCE_HEROES
LOCKPICKER
MAGICAL
MAGMA_VISION
MANNERISM_BREATH
MANNERISM_EYELIDS
MANNERISM_LAUGH
MANNERISM_POSTURE
MANNERISM_SIT
MANNERISM_SMILE
MANNERISM_STRETCH
MANNERISM_WALK
MATUTINAL
MEANDERER
MEGABEAST
MILKABLE
MISCHIEVIOUS
MOUNT
MOUNT_EXOTIC
MULTIPART_FULL_VISION
MULTIPLE_LITTER_RARE
NATURAL_ANIMAL
NIGHT_CREATURE
NIGHT_CREATURE_BOGEYMAN
NIGHT_CREATURE_EXPERIMENTER
NIGHT_CREATURE_HUNTER
NIGHT_CREATURE_NIGHTMARE
NOBONES
NOBREATHE
NOCTURNAL
NOEMOTION
NOEXERT
NOFEAR
NOMEAT
NONAUSEA
NOPAIN
NOSKIN
NOSKULL
NOSMELLYROT
NOSTUCKINS
NOSTUN
NOTHOUGHT
NOT_BUTCHERABLE
NOT_LIVING
NO_AUTUMN
NO_CONNECTIONS_FOR_MOVEMENT
NO_DIZZINESS
NO_DRINK
NO_EAT
NO_FEVERS
NO_PHYS_ATT_GAIN
NO_PHYS_ATT_RUST
NO_SLEEP
NO_SPRING
NO_SUMMER
NO_THOUGHT_CENTER_FOR_MOVEMENT
NO_UNIT_TYPE_COLOR
NO_VEGETATION_PERTURB
NO_WINTER
OPPOSED_TO_LIFE
OUTSIDER_CONTROLLABLE
PACK_ANIMAL
PARALYZEIMMUNE
PATTERNFLIER
PEARL
PET
PET_EXOTIC
POWER
REMAINS_ON_VERMIN_BITE_DEATH
REMAINS_UNDETERMINED
RETURNS_VERMIN_KILLS_TO_OWNER
SEMIMEGABEAST
SLOW_LEARNER
SPOUSE_CONVERSION_TARGET
SPOUSE_CONVERTER
SPREAD_EVIL_SPHERES_IF_RULER
STANCE_CLIMBER
STRANGE_MOODS
SUPERNATURAL
TENDONS
THICKWEB
TITAN
TRAINABLE_HUNTING
TRAINABLE_WAR
TRANCES
TRAPAVOID
UNIQUE_DEMON
UTTERANCES
VEGETATION
VERMIN_GOBBLER
VERMIN_HATEABLE
VERMIN_MICRO
VERMIN_NOFISH
VERMIN_NOROAM
VERMIN_NOTRAP
VESPERTINE
WAGON_PULLER
WEBBER
WEBIMMUNE
}}

==See Also==
* [[Syndrome]]
* [[Interaction examples]]

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

Interaction token

2024-06-23T20:42:55Z

Putnam3145: /* Usage */

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

The following [[token]]s can be used to define and use interactions. (''It appears that, at least in order to make the big list make a little more sense, [[Necromancer#Modding|some]] [[Interaction_examples|examples]] of those may be necessary.'')

__TOC__
{{clear}}

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

|-
| {{text anchor|INTERACTION}}
| Global
| ID
| Used to start defining a new interaction. The term "interaction ID" refers to the text specified within this token; this is used to make reference to the interaction in various other places.

|-
| {{text anchor|EXPERIMENT_ONLY}}
| Global
|
| Disallows use of the interaction in play, but if the interaction animates or resurrects corpses, or has an I_SOURCE:EXPERIMENT tag, it can be used in worldgen. Animation and resurrection interactions do not need I_SOURCE:EXPERIMENT to work in worldgen.

|-
| {{text anchor|I_SOURCE}}
| Global
| type
| Defines what things are capable of triggering this interaction - multiple sources may be specified. Valid values:
* '''CREATURE_ACTION''' - Specifies that the interaction may be used in conjunction with [[Creature_token#CAN_DO_INTERACTION|[CAN_DO_INTERACTION]]] and [[Syndrome#CE_CAN_DO_INTERACTION|[CE_CAN_DO_INTERACTION]]], but it isn't actually necessary for this. It might exist simply to allow for the inclusion of IS_ tokens (detailed below) to be applied when the interaction is used in this context.
* '''ATTACK''' - Allows the interaction to be used in conjunction with [[Creature_token#SPECIALATTACK_INTERACTION|[SPECIALATTACK_INTERACTION]]] and [[Syndrome#CE_SPECIAL_ATTACK_INTERACTION|[CE_SPECIAL_ATTACK_INTERACTION]]].
* '''INGESTION''' - Allows the interaction to be used in conjunction with [[Syndrome#CE_BODY_MAT_INTERACTION|[CE_BODY_MAT_INTERACTION]]].
* '''DEITY''' - Allows the interaction to be inflicted upon mortals by the gods, for reasons dictated by [[Interaction_token#IS_USAGE_HINT|[IS_USAGE_HINT]]].
* '''SECRET''' - Allows the interaction to act as a secret which can be learnt and passed on to others, as specified via [[Interaction_token#IS_SECRET|[IS_SECRET]]]. Appropriate [[Interaction_token#I_EFFECT|interaction effects]] with a [[Interaction_token#IE_TARGET|creature target]] will be applied to individuals who learn the secret. It is possible to set restrictions on who may learn the secret by using creature target tokens as described below. Also see [[Interaction_token#IS_SECRET_GOAL|[IS_SECRET_GOAL]]] and [[Interaction_token#IS_SPHERE|[IS_SPHERE]]].
* '''REGION''' - Allows the interaction to take place spontaneously in regions specified using [[Interaction_token#IS_REGION|[IS_REGION]]]. Also see [[Interaction_token#IS_FREQUENCY|[IS_FREQUENCY]]] and [[Interaction_token#IE_INTERMITTENT|[IE_INTERMITTENT]]].
* '''DISTURBANCE''' - Allows the interaction to take place spontaneously in disturbed [[tomb|tombs]]; generated interactions with this token are used to create [[mummy|mummies]].
* '''UNDERGROUND_SPECIAL''' - Allows the interaction to take place spontaneously in [[Demonic fortress|curious underground structures]] (which no longer generate); generated interactions with this token used to be used to produce [[undead|zombies]] when creating the structure's inhabitants.
* '''EXPERIMENT''' - This can be used by NIGHT_CREATURE_EXPERIMENTERs while "performing horrible experiments" in worldgen. Only seems relevant for interactions that target living creatures. Note that all NIGHT_CREATURE_EXPERIMENTERs have access to generated experiments, and due to the large number of generated experiments available custom experiment interactions will tend to show up very rarely.

|-
| {{text anchor|IS_HIST_STRING_1}}
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure; this is displayed in legends mode following the name of the historical figure who performed the interaction and preceding the name of the targeted historical figure (or, in the case of [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]], the historical figure from whom the consumed material was extracted).

[IS_HIST_STRING_1: cursed]

|-
| {{text anchor|IS_HIST_STRING_2}}
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure; this is displayed in legends mode after the name of the historical figure who was targeted by the interaction. In the case of [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]], it is displayed after the name of the historical figure from whom the consumed material was extracted.

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

|-
| {{text anchor|IS_TRIGGER_STRING}}
| Within I_SOURCE
| text
| Displayed as an announcement when the interaction is carried out during play. The text follows the name of the target unit, and is preceded by [[Interaction_token#IS_TRIGGER_STRING_SECOND|IS_TRIGGER_STRING_SECOND]] or [[Interaction_token#IS_TRIGGER_STRING_THIRD|IS_TRIGGER_STRING_THIRD]]. May be limited to [[Interaction_token#I_SOURCE|[I_SOURCE:DEITY]]] and [[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]] interactions at present; this still needs to be tested.

[IS_TRIGGER_STRING: been infected with a contagious ghoulish condition]

|-
| {{text anchor|IS_TRIGGER_STRING_SECOND}}
| Within I_SOURCE
| text
| Presented before the [[Interaction_token#IS_TRIGGER_STRING|IS_TRIGGER_STRING]] when describing the event in the second person.

[IS_TRIGGER_STRING_SECOND: have]

|-
| {{text anchor|IS_TRIGGER_STRING_THIRD}}
| Within I_SOURCE
| text
| Presented before the [[Interaction_token#IS_TRIGGER_STRING|IS_TRIGGER_STRING]] when describing the event in the third person.

[IS_TRIGGER_STRING_THIRD: has]

|-
| {{text anchor|IS_NAME}}
| Within I_SOURCE
| string
| Generally used with [[Interaction_token#I_SOURCE|[I_SOURCE:SECRET]]] interactions to describe what the secret is about (though it may be used to name any I_SOURCE). This name is engraved onto the appropriate secret-containing slabs from worldgen, and is used in legends mode when describing the secret being learnt by historical figures.

[IS_NAME:the secrets of life and death]

|-
| {{text anchor|IS_SPHERE}}
| Within I_SOURCE:SECRET
| [[Sphere#Available_spheres|sphere]]
| Indicates the [[sphere]] to which this secret pertains. Only one sphere can be defined for each [I_SOURCE:SECRET] token, so several [I_SOURCE:SECRET] tokens are required to make a secret belong to multiple spheres.

|-
| {{text anchor|IS_SECRET_GOAL}}
| Within I_SOURCE:SECRET
| Secret Goal token
| Indicates why somebody would want to learn the secret. Valid values:
* '''STAY_ALIVE'''
* '''MAINTAIN_ENTITY_STATUS'''
* '''START_A_FAMILY'''
* '''RULE_THE_WORLD'''
* '''CREATE_A_GREAT_WORK_OF_ART'''
* '''CRAFT_A_MASTERWORK'''
* '''BRING_PEACE_TO_THE_WORLD'''
* '''BECOME_A_LEGENDARY_WARRIOR'''
* '''MASTER_A_SKILL'''
* '''FALL_IN_LOVE'''
* '''SEE_THE_GREAT_NATURAL_SITES'''
* '''IMMORTALITY'''
* '''MAKE_A_GREAT_DISCOVERY'''
* '''ATTAIN_RANK_IN_SOCIETY'''
* '''BATHE_WORLD_IN_CHAOS'''
However, currently only IMMORTALITY will result in a secret being pursued during worldgen.

|-
| {{text anchor|IS_SECRET}}
| Within I_SOURCE:SECRET
| Secret Flag
| Indicates how the secret can be learned. Valid values:
* '''SUPERNATURAL_LEARNING_POSSIBLE''' - gods may gift the secret to their worshippers. Secrets with [[Interaction_token#IS_SPHERE|[IS_SPHERE]]] specified may only be granted by gods who have at least one matching sphere.
* '''MUNDANE_RESEARCH_POSSIBLE''' - the secret can be researched by mundane means. This doesn't do anything at present. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222].
* '''MUNDANE_TEACHING_POSSIBLE''' - the secret can be taught to apprentices
* '''MUNDANE_RECORDING_POSSIBLE:TITLE_SET:NAME_SET''' - the secret can be written in books whose title and name are taken from the specified text sets. If this tag is present, a slab will be created upon learning the secret by supernatural means.

|-
| {{text anchor|IS_USAGE_HINT}}
| Within I_SOURCE:DEITY
| Usage Hint token
| Indicates why a deity would choose to perform this interaction. See [[Interaction_token#USAGE_HINT|CDI:USAGE_HINT]] below for valid values - in this context, '''MINOR_BLESSING''', '''MEDIUM_BLESSING''', '''MINOR_CURSE''', '''MEDIUM_CURSE''', and '''MAJOR_CURSE''' are the only values that make sense.

|-
| {{text anchor|IS_REGION}}
| Within I_SOURCE:REGION
| Region type
| Indicates what types of regions are capable of performing this interaction. This token may be specified several times per I_SOURCE to permit multiple terrain/alignment types. Valid values:

* '''ANY''' permits the interaction to occur in all regions, regardless of terrain or alignment

[[Biome|Terrain]]:

* '''DESERT'''
* '''FOREST'''
* '''GLACIER'''
* '''GRASSLAND'''
* '''HILLS'''
* '''LAKE'''
* '''MOUNTAINS'''
* '''OCEAN'''
* '''SWAMP'''
* '''TUNDRA'''
* '''ANY_TERRAIN''' permits the interaction to occur in all regions which meet alignment specifications

[[Surroundings#Combinations & characteristics of surroundings|Alignment]]:

* '''NORMAL_ALLOWED'''
* '''EVIL_ALLOWED'''
* '''GOOD_ALLOWED'''
* '''SAVAGE_ALLOWED'''
* '''EVIL_ONLY'''
* '''GOOD_ONLY'''
* '''SAVAGE_ONLY'''

|-
| {{text anchor|IS_FREQUENCY}}
| Within I_SOURCE
| Probability
| When used with [[Interaction_token#I_SOURCE|[I_SOURCE:REGION]]], determines how likely it is for the region(s) specified via [[Interaction_token#IS_REGION|[IS_REGION]]] to possess this interaction.

Note: it appears that regions aren't allowed to possess more than a single regional interaction at present.

|-
| {{text anchor|I_TARGET}}
| Global
| ID, type
| Defines the targets available for subsequent use with [[Interaction_token#I_EFFECT|[I_EFFECT]]] tokens. Multiple targets may be specified; the precise target(s) used with each interaction effect are indicated via their ID (see [[Interaction_token#IE_TARGET|[IE_TARGET]]]). Valid values:
* '''CORPSE''' - The target is a [[Item_token#CORPSE|CORPSE]] or [[Item_token#CORPSEPIECE|CORPSEPIECE]] item.
* '''CREATURE''' - The target is a [[Creature|unit]].
* '''MATERIAL''' - This is a valid target for use in [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] interaction effects, and is used to set the material or flow type of the emission. This information, in turn, is either obtained from an [[Interaction_token#IT_MATERIAL|[IT_MATERIAL]]] token or by using [[Interaction_token#IT_LOCATION|[IT_LOCATION:CONTEXT_MATERIAL]]]. Using the latter implies that the precise emission info will be provided when defining [[Interaction_token#Breath_attacks|how an interaction user can use the interaction in question via CDI tokens]], enabling one to create 'template' material emission interactions such as the MATERIAL_EMISSION and MATERIAL_EMISSION_WITH_HIDE interactions included in the vanilla raws.
* '''LOCATION''' - The target is a [[tile|local map tile]]. If used with [[Interaction_token#IT_LOCATION|[IT_LOCATION:CONTEXT_CREATURE_OR_LOCATION]]], creatures at the target tile are also valid targets.

|-
| {{text anchor|IT_LOCATION}}
| Within I_TARGET
| Location
| This is often included after [[Interaction_token#I_TARGET|[I_TARGET]]] token to add more detail about the target. Valid values:
* '''CONTEXT_CREATURE''' - Used with CREATURE to target the whole unit.
* '''CONTEXT_BP''' - Used with CREATURE to target the body part specified in [[Interaction_token#BP_REQUIRED|[CDI:BP_REQUIRED]]].
* '''CONTEXT_LOCATION''' - Used with LOCATION to target only a tile.
* '''CONTEXT_CREATURE_OR_LOCATION''' - Used with LOCATION to allow for targetting of both creatures and tiles.
* '''CONTEXT_ITEM''' - Used with CORPSE.
* '''CONTEXT_REGION''' - Can only be used by [[Interaction_token#I_SOURCE|[I_SOURCE:REGION]]] interactions.
* '''CONTEXT_MATERIAL''' - Used with MATERIAL if you want an [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] to obtain the emission material/flow type from [[Interaction_token#MATERIAL|[CDI:MATERIAL]]] or [[Interaction_token#FLOW|[CDI:FLOW]]].
* '''RANDOM_NEARBY_LOCATION''' - Used with LOCATION. Targets a location from somewhere random within a number of squares from another LOCATION target specified by its target ID. For example, [I_TARGET:B:LOCATION] with [IT_LOCATION:RANDOM_NEARBY_LOCATION:A:5] will randomly select a tile lying somewhere within a radius of 5 tiles from [I_TARGET:A:LOCATION]. A walkable path between the two locations must exist.

|-
| {{text anchor|IT_MANUAL_INPUT}}
| Within I_TARGET
| text
| Tells the adventure mode player what they should be selecting. If not specified, the player will only be able to target themselves.

|-
| {{text anchor|IT_AFFECTED_CREATURE}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| CREATURE:CASTE
| Specifies specific creatures the interaction can target.

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

|-
| {{text anchor|IT_IMMUNE_CREATURE}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| CREATURE:CASTE
| Specifies specific creatures the interaction cannot target.

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

|-
| {{text anchor|IT_REQUIRES}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature token or property
| Indicates that the target must have the specified property. Valid values:
* '''FIT_FOR_ANIMATION''' - Any corpse or body part that can become a zombie (heads, hands, etc.)
* '''FIT_FOR_RESURRECTION''' - The target corpse's UPPERBODY must be attached.
* '''HAS_BLOOD'''
* '''MORTAL'''
* '''NO_AGING'''
* '''STERILE'''
* Creature token: '''BLOODSUCKER, CAN_LEARN, CAN_SPEAK, CRAZED, EXTRAVISION, MISCHIEVOUS''' (or '''MISCHIEVIOUS'''), '''NO_CONNECTIONS_FOR_MOVEMENT, NO_DIZZINESS, NO_DRINK, NO_EAT, NO_FEVERS, NO_PHYS_ATT_GAIN, NO_PHYS_ATT_RUST, NO_SLEEP, NO_THOUGHT_CENTER_FOR_MOVEMENT, NOBREATHE, NOEMOTION, NOEXERT, NOFEAR, NONAUSEA, NOPAIN, NOSTUN, NOT_LIVING, NOTHOUGHT, OPPOSED_TO_LIFE, PARALYZEIMMUNE, SUPERNATURAL, TRANCES, UTTERANCES'''

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

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

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

|-
| {{text anchor|IT_MATERIAL}}
| Within I_TARGET:MATERIAL
| type
| Specifies the type of material the interaction targets; currently only used for [[Interaction_token#I_EFFECT|MATERIAL_EMISSION]] interaction effects. See [[Interaction_token#Breath_Attacks_Types|Breath Attack Types]]. Valid values:
* '''FLOW''':Breath attack token - The emission will consist of the specified special flow type.
* '''MATERIAL''':[[Material token]]:Breath attack token - The emission will consist of the specified material dispersed in the specified manner.
* '''CONTEXT_MATERIAL''' - Indicates the emission details should be obtained from [[Interaction_token#MATERIAL|[CDI:MATERIAL]]] or [[Interaction_token#FLOW|[CDI:FLOW]]].

|-
| {{text anchor|I_EFFECT}}
| Global
| type
| Specifies what the interaction does to the targets. Multiple [I_EFFECT]s may be specified in a single interaction, and the same type may be used more than once. Valid values:

* '''ADD_SYNDROME''' - Adds one or more syndromes to a valid creature target. You must specify the syndrome details just below this interaction effect using the <code>[[Syndrome#SYNDROME|[SYNDROME]]]</code> tag followed by the relevant syndrome tokens. See [[syndrome#The anatomy of a syndrome|here]] for more information.

* '''ANIMATE''' - Raises the target corpse/bodypart as an [[undead]] unit. The zombie will always be hostile to life and will retain no information about its original personality/loyalties. Syndromes can also be specified within this tag. If a regional interaction contains this effect, affected regions will have undead wildlife.

* '''RESURRECT''' - Takes a target corpse and returns the creature to life. This can be used on parts that are not FIT_FOR_RESURRECTION, but only the main part (with an UPPERBODY attached) will remain loyal to its original faction. Syndromes can also be specified within this tag.

* '''CLEAN''' - Removes [[Contaminant|contaminants]] from a valid creature target. See {{token|IE_GRIME_LEVEL|in}} and {{token|IE_SYNDROME_TAG|in}}.

* '''CONTACT''' - Causes the creatures to touch.

* '''MATERIAL_EMISSION''' - Causes a particular material to be emitted. Used by [[evil weather]] and the MATERIAL_EMISSION interaction.

* '''HIDE''' - Allows the creature to [[Ambusher|hide]] even if another creature can see it.

* '''CREATE_ITEM''' - Creates an item as described by {{token|IE_ITEM|in}} and {{token|IE_ITEM_QUALITY|in}}.

* '''CHANGE_ITEM_QUALITY''' - Alters an item's quality level as indicated by either {{token|IE_CHANGE_QUALITY|in}} or {{token|IE_SET_QUALITY|in}}. When targeting a unit, all items equipped by that unit will be affected.

* '''SUMMON_UNIT''' - Creates a new unit at the target. The type of unit can either be specified using the {{token|CREATURE|in}} token, or made to be randomly selected as indicated by a variety of flag-based tokens: {{token|IE_CREATURE_FLAG|in}}, {{token|IE_FORBIDDEN_CREATURE_FLAG|in}}, {{token|IE_CREATURE_CASTE_FLAG|in}}, {{token|IE_FORBIDDEN_CREATURE_CASTE_FLAG|in}}, {{token|IE_HAVE_FAST_EFFORTLESS_GAIT_SPEED|in}} and/or {{token|IE_ALL_SLOW_EFFORTLESS_GAIT_SPEED|in}}. See also {{token|IE_TIME_RANGE|in}} and {{token|IE_MAKE_PET_IF_POSSIBLE|in}}.

* '''PROPEL_UNIT''' - Applies a force specified using {{token|IE_PROPEL_FORCE|in}} to a unit to knock it back.

* '''CHANGE_WEATHER''' - Changes the weather as specified by {{token|IE_ADD_WEATHER|in}} and/or {{token|IE_REMOVE_WEATHER|in}}.

* '''RAISE_GHOST''' - Present in version 0.47.01 and accepted as a valid I_EFFECT token, but does not have an effect currently.

|-
| {{text anchor|IE_ARENA_NAME}}
| Within I_EFFECT
| text
| Allows the interaction effect to be applied directly to newly spawned creatures in [[object testing arena|arena mode]]. The specified name is used to represent it within the creature creation [[Object_testing_arena#Effects|effects list]].

|-
| {{text anchor|IE_TARGET}}
| Within I_EFFECT
| ID
| Specifies which [[Interaction_token#I_TARGET|I_TARGET]] a particular interaction effect will be applied to. For example, in an interaction with the token [I_TARGET:B:CREATURE], 'B' is the ID used to indicate this target option. [I_EFFECT:ADD_SYNDROME] followed by [IE_TARGET:B] would therefore apply the syndrome to this target. Certain types of interaction effects require multiple IE_TARGET tokens in a specific order to function properly. A few effects do not require a target at all.

|-
| {{text anchor|IE_INTERMITTENT}}
| Within I_EFFECT
| Frequency
| Only appears to work with [I_SOURCE:REGION] interactions. Indicates that the effect happens intermittently and specifies roughly how often. Regional interactions aren't able to use effects which lack this token. Valid values:
* '''WEEKLY'''

Note: DAILY, MONTHLY and YEARLY also exist in the string dump but don't appear to work at present.

|-
| {{text anchor|IE_IMMEDIATE}}
| Within I_EFFECT
|
| Indicates that the effect happens immediately.

|-
| {{text anchor|IE_LOCATION}}
| Within I_EFFECT
| Location Hint
| Prevents the interaction effect from manifesting unless the target is in a location which meets the specified criteria.
Valid values:
* '''IN_WATER'''
* '''IN_MAGMA'''
* '''NO_WATER'''
* '''NO_MAGMA'''
* '''NO_THICK_FOG'''
* '''OUTSIDE'''
A [[Water#Depth|depth]] of 1/7 is sufficient for IN_WATER and IN_MAGMA.

Note: NO_THICK_FOG and OUTSIDE are accepted as valid location hints when specified with IE_LOCATION, but don't appear to work. It's possible that they're currently only implemented for use with <code>[[Interaction_token#LOCATION_HINT|[CDI:LOCATION_HINT]]]</code>.

|-
| {{text anchor|IE_ADD_WEATHER}}
| Within I_EFFECT:CHANGE_WEATHER
| type
| Indicates what type of weather is added. Valid values:
* '''FOG_MIST'''
* '''FOG_NORMAL'''
* '''FOG_THICK'''
* '''FRONT_WARM'''
* '''FRONT_COLD'''
* '''FRONT_OCCLUDED'''
* '''STRATUS_ALTO'''
* '''STRATUS_PROPER'''
* '''STRATUS_NIMBUS'''
* '''CUMULUS_MED'''
* '''CUMULUS_MULTI'''
* '''CUMULUS_NIMBUS'''
* '''CIRRUS'''

|-
| {{text anchor|IE_REMOVE_WEATHER}}
| Within I_EFFECT:CHANGE_WEATHER
| type
| Indicates what type of weather is removed. See [[Interaction_token#IE_ADD_WEATHER|above]] for a list of valid weather types.

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

|-
| {{text anchor|IE_SYNDROME_TAG}}
| Within I_EFFECT:CLEAN
| syndrome trigger flag
| When a creature cleans off a [[contaminant]] which is associated with a [[syndrome]], the syndrome will be contracted if it has a matching [[Syndrome#The_anatomy_of_a_syndrome|trigger flag]]. This is what enables [[cat]]s to become slightly inebriated when licking off [[alcohol]]. '''SYN_INGESTED''' appears to be the only syndrome trigger flag that works in this context.

|-
| {{text anchor|IE_PROPEL_FORCE}}
| Within I_EFFECT:PROPEL_UNIT
| amount
| Indicates the amount of force that the target will be propelled with.

|-
| {{text anchor|IE_ITEM}}
| Within I_EFFECT:CREATE_ITEM
| <probability>:<quantity>:[[item token]]:[[material token]]
| Defines what item will be created.

|-
| {{text anchor|IE_ITEM_QUALITY}}
| Within I_EFFECT:CREATE_ITEM
| <[[Item_quality|quality]]> OR <minimum [[Item_quality|quality]]>:<maximum [[Item_quality|quality]]>
| Defines what [[Item quality|quality]] the created item shall have. Can either be specified in the form of a single, fixed quality (it seems that ARTIFACT can only be used in this manner), or a minimum and maximum level (in which case the quality is selected randomly). Valid values (numerals only except for ARTIFACT):
* '''0''' = ordinary
* '''1''' = well-crafted
* '''2''' = finely crafted
* '''3''' = superior quality
* '''4''' = exceptional
* '''5''' = masterwork
* '''ARTIFACT'''

|-
| {{text anchor|IE_SET_QUALITY}}
| Within I_EFFECT:CHANGE_ITEM_QUALITY
| [[Interaction_token#IE_ITEM_QUALITY|quality level]]
| Defines a fixed [[Item_quality|quality]] level which the affected item(s) will be set to (decreasing or increasing in quality as necessary). See [[Interaction_token#IE_ITEM_QUALITY|above]] for a list of valid quality levels (but note that ARTIFACT cannot be used in this effect).

|-
| {{text anchor|IE_CHANGE_QUALITY}}
| Within I_EFFECT:CHANGE_ITEM_QUALITY
| amount
| Determines how much the [[Item_quality|quality]] of the item(s) will be changed. For instance, improving a well-crafted -item- ([[Interaction_token#IE_ITEM_QUALITY|quality level]] 1) by 2 will turn it into a superior-quality *item* (quality level 3). A negative value can be used to decrease quality. Quality cannot be increased beyond level 5 (masterwork) or decreased below level 0 (ordinary).

|-
| {{text anchor|CREATURE}}
| Within I_EFFECT:SUMMON_UNIT
| <creature token>:<caste token>
| Indicates which specific creature will be created when using this interaction. ANY can be used in place of a specific caste token. Only one [CREATURE] may currently be specified per interaction effect.

|-
| {{text anchor|IE_CREATURE_FLAG}}
| Within I_EFFECT:SUMMON_UNIT
| <[[Interaction_token#Creature_and_Caste_Flags|creature flag]]>
| When this token is added to a random creature summoning effect, it narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]]. This token may be used multiple times per interaction effect; creatures which lack any of the indicated flags will never be summoned.

|-
| {{text anchor|IE_FORBIDDEN_CREATURE_FLAG}}
| Within I_EFFECT:SUMMON_UNIT
| <[[Interaction_token#Creature_and_Caste_Flags|creature flag]]>
| When this token is added to a random creature summoning effect, any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] will be excluded from the selection. This token may be used multiple times per interaction effect; creatures which possess any of the indicated flags will never be summoned.

|-
| {{text anchor|IE_CREATURE_CASTE_FLAG}}
| Within I_EFFECT:SUMMON_UNIT
| <[[Interaction_token#Creature_and_Caste_Flags|caste flag]]>
| When this token is added to a random creature summoning effect, it narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. This token may be used multiple times per interaction effect; creatures which lack any of the indicated flags will never be summoned.

|-
| {{text anchor|IE_FORBIDDEN_CREATURE_CASTE_FLAG}}
| Within I_EFFECT:SUMMON_UNIT
| <[[Interaction_token#Creature_and_Caste_Flags|caste flag]]>
| When this token is added to a random creature summoning effect, it excludes any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. This token may be used multiple times per interaction effect; creatures which possess any of the indicated flags will never be summoned.

|-
| {{text anchor|IE_HAVE_FAST_EFFORTLESS_GAIT_SPEED}}
| Within I_EFFECT:SUMMON_UNIT
| <minimum [[Gait#Speed|gait speed]]>
| When this token is added to a random creature summoning effect, it narrows down the selection to creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] less than or equal to the specified <minimum gait speed> ("less than" because lower is faster in the scale used for [[Gait#Speed|gait speed]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

|-
| {{text anchor|IE_ALL_SLOW_EFFORTLESS_GAIT_SPEED}}
| Within I_EFFECT:SUMMON_UNIT
| <maximum [[Gait#Speed|gait speed]]>
| When this token is added to a random creature summoning effect, it excludes any creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] value less than or equal to the specified <maximum gait speed> (note that larger values are slower in the scale used for [[Gait#Speed|gait speed]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

|-
| {{text anchor|IE_TIME_RANGE}}
| Within I_EFFECT:SUMMON_UNIT
| <minimum [[Time|ticks]]>:<maximum [[Time|ticks]]>
| The summoned unit vanishes in a puff of smoke once a certain amount of time has elapsed. The time limit is a randomly selected number of ticks within the specified minimum-maximum time range. The unit will persist indefinitely if this token is omitted.

|-
| {{text anchor|IE_MAKE_PET_IF_POSSIBLE}}
| Within I_EFFECT:SUMMON_UNIT
|
| Makes the summoned unit behave as a pet of the unit who performed the summoning interaction.

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

|}

==Usage==
To enable a particular type of creature to use an interaction directly, the [[creature token]] <code>[[Creature_token#CAN_DO_INTERACTION|[CAN_DO_INTERACTION:<interaction name>]]]</code> should be added to its creature raws (replacing '<interaction name>' with the ID of the desired interaction; for an interaction called <code>[INTERACTION:CLEANING]</code> in the raws, the ID would be "CLEANING"), followed by a series of [CDI:...] tokens as detailed below.

Interactions can also be granted to individual creatures via [[syndrome]]s using the syndrome effect token <code>[[Syndrome#CE_CAN_DO_INTERACTION|[CE_CAN_DO_INTERACTION]]]</code> followed by <code>[[Interaction_token#INTERACTION|[CDI:INTERACTION:<interaction name>]]]</code> and additional CDI tokens as required.

The following is a list of valid CDI tokens. Precede them with "CDI:" in the style of <code>[CDI:ADV_NAME:Clean]</code>, for example.
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| {{text anchor|INTERACTION}}
| ID
| Specifies which interaction can be performed. This is only needed following [[Syndrome#Special_Effects|CE_CAN_DO_INTERACTION]]; there's no need to include this after [[Creature_token#CAN_DO_INTERACTION|CAN_DO_INTERACTION]] as the latter allows you to specify the interaction directly (as explained [[Interaction_token#Usage|above]]).

|-
| {{text anchor|ADV_NAME}}
| text
| Specifies the name of the interaction as it will appear on the [[Adventurer_mode|adventure mode]] 'powers/abilities' menu.

|-
| {{text anchor|TARGET}}
| target ID, target types
| Specifies how the creature chooses what to target. Target ID refers to an I_TARGET defined in the interaction itself. Multiple target types can be specified. If no target is specified, creature will target any available target within range, even through walls. Valid target types:
* '''LINE_OF_SIGHT''' - the source needs to be able to see the target
* '''TOUCHABLE''' - the source needs to be able to touch the target
* '''DISTURBER_ONLY''' - the target must be whoever disturbed the source (this is currently only relevant to [[mummy|mummies]], allowing them to curse solely the unit who disturbed their [[tomb|resting place]])
* '''SELF_ALLOWED''' - the target can be the source
* '''SELF_ONLY''' - the target '''must''' be the source

|-
| {{text anchor|TARGET_RANGE}}
| target ID, range
| Determines the maximum distance from the interaction user (in [[tile]]s) at which something can be considered a valid target. For [[Interaction_token#SOLID_GLOB|SOLID_GLOB]], [[Interaction_token#SHARP_ROCK|SHARP_ROCK]], [[Interaction_token#LIQUID_GLOB|LIQUID_GLOB]] and [[Interaction_token#FIREBALL|FIREBALL]] breath attacks, also determines how far the projectiles can fly before falling to the ground.

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

|-
| {{text anchor|LOCATION_HINT}}
| Location Hint
| Prevents CPU-controlled creatures from using the interaction unless they are in a location which meets the specified criteria. See [[Interaction_token#IE_LOCATION|above]] for a list of valid location hint values.

|-
| {{text anchor|USAGE_HINT}}
| Usage hint token
| Indicates when and how CPU-controlled creatures will use the interaction. If no hint is specified in fortress mode, the interaction will be performed at the every opportunity in combat. Multiple usage hints may be specified. Valid values:
* '''GREETING''' - Creatures will target 'friendly' creatures, usually at random.
* '''ATTACK''' - Targets enemy creatures in combat. If the interaction specifies SELF_ONLY, CPU-controlled creatures will never use it.
* '''DEFEND''' - Used in combat. Creature will target itself.
* '''FLEEING''' - Used when fleeing an enemy. Creature will target itself.
* '''CLEAN_SELF''' - Creature targets itself when its body is covered with [[contaminant]]s.
* '''CLEAN_FRIEND''' - As above, but targets other friendly units instead.
* '''NEGATIVE_SOCIAL_RESPONSE''' - Used when a creature is expressing contempt (for example, to a murderer). This is used in the default spitting interaction, for example.
* '''TORMENT''' - This is also used in the default spitting interaction, and is presumably used in a similar context.
* '''MINOR_BLESSING''' - Used in divination dice blessings. Targets the roller.
* '''MEDIUM_BLESSING''' - Used in divination dice blessings. Targets the roller.
* '''MINOR_CURSE''' - Used in divination dice curses. Targets the roller.
* '''MEDIUM_CURSE''' - Used in divination dice curses. Targets the roller.
* '''MAJOR_CURSE''' - Used in disturbance and deity curses. Targets the tomb disturber/temple defiler.

|-
| {{text anchor|WAIT_PERIOD}}
| number
| The creature must wait the specified number of [[time|ticks]] before being able to use the interaction again. The delay defaults to 20 ticks if this is omitted. Setting it to 0 removes the delay altogether.
Note: A WAIT_PERIOD of 10 is 10 ticks long in [[fortress mode]], but only 1 tick long in [[adventurer mode]].

|-
| {{text anchor|FREE_ACTION}}
|
| Indicates that performing the interaction doesn't take any time.

|-
| {{text anchor|BP_REQUIRED}}
| Body part criteria
| Indicates that a particular body part must be present in order to perform the interaction. Criteria are '''BY_CATEGORY:'''[[Body_token#CATEGORY|category]], '''BY_TYPE:'''type (GRASP, for example), or '''BY_TOKEN:'''[[Body_token#BP|token]] (uses the body part ID). See [[Body_token|body token]].

|-
| {{text anchor|VERBAL}}
|
| Only creatures that [[Creature_token#CAN_SPEAK|can speak]] will be able to use the interaction. Might also be needed for VERBAL_SPEECH.

|-
| {{text anchor|VERBAL_SPEECH}}
| text object
| Specifies what the creature says when they perform the interaction. Text objects are defined in text_* raws.

|-
| {{text anchor|CAN_BE_MUTUAL}}
|
| Presumably allows two creatures with the same interaction to use it on each other simultaneously, for example, cats cleaning each other.

|-
| {{text anchor|VERB}}
| self:other:mutual
| When a creature uses the interaction, a combat report message will be displayed in the form:

[interaction user(s)] [VERB text] [target creature (if applicable)]

The 'self' text is presented when describing the interaction in the second person (that is, when the interaction is carried out by the player character in [[adventure mode]]), the 'other' text is presented when describing it in the third person, and the 'mutual' text is presented when the interaction is carried out in a [[Interaction_token#CAN_BE_MUTUAL|mutual]] fashion.

[CDI:VERB:lick:licks:lick each other]

[CDI:VERB:gesture:gestures:NA]

|-
| {{text anchor|VERB_REVERSE}}
| ?
| ?

|-
| {{text anchor|TARGET_VERB}}
| self:other
| When a creature uses the interaction, a message will display, describing the target as doing this.
[CDI:TARGET_VERB:shudder and begin to move:shudders and begins to move]

|-
| {{text anchor|FLOW}}
| [[#Breath Attack Types|Breath attack token]]
| Can be used with interactions that have [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] and [[Interaction_token#IT_LOCATION|[IT_LOCATION:CONTEXT_MATERIAL]]] (or [[Interaction_token#IT_MATERIAL|[IT_MATERIAL:CONTEXT_MATERIAL]]]) to make the interaction emit a special flow type. Valid values:
* '''[[Interaction_token#FIREBALL|FIREBALL]]'''
* '''[[Interaction_token#FIREJET|FIREJET]]'''
* '''[[Interaction_token#DRAGONFIRE|DRAGONFIRE]]'''.

|-
| {{text anchor|MATERIAL}}
| [[Material token]]:[[Interaction_token#Breath_Attack_Types|Breath attack token]]
| Can be used with interactions that have [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] and [[Interaction_token#IT_LOCATION|[IT_LOCATION:CONTEXT_MATERIAL]]] (or [[Interaction_token#IT_MATERIAL|[IT_MATERIAL:CONTEXT_MATERIAL]]]) to make the interaction emit the specified material in the manner described by the [[Interaction_token#Breath_Attack_Types|breath attack token]] used.

|}

==Breath attacks==
Breath attacks are controlled by the MATERIAL_EMISSION interaction, like so:

[CAN_DO_INTERACTION:MATERIAL_EMISSION]
[CDI:ADV_NAME:Breath custom material]
[CDI:USAGE_HINT:ATTACK]
[CDI:BP_REQUIRED:BY_CATEGORY:MOUTH]
[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]
[CDI:TARGET:C:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:C:15]
[CDI:MAX_TARGET_NUMBER:C:1]
[CDI:WAIT_PERIOD:50]

The most important part is this line:

[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]

The CDI refers to CAN_DO_INTERACTION; the MATERIAL states that this line shows what the material is. LOCAL_CREATURE_MAT:CUSTOMMATERIAL is your material, and TRAILING_VAPOR_FLOW refers to the breath attack type. Other types are seen below. Also important is this line:

[CDI:TARGET:C:LINE_OF_SIGHT]

LINE_OF_SIGHT refers to where the target C may be; others include SELF_ALLOWED (presumably like LINE_OF_SIGHT, but with the creature allowed to target itself), SELF_ONLY (preferable for undirected attacks and TOUCHABLE (for up-close attacks, as trailing flows tend to be).

===Breath Attack Types===

'''[CDI:MATERIAL:<[[material token]]>:<material emission type>]'''

Is used to emit a specific material in a specific manner. A list of valid emission types can be found below.

Examples:

[CDI:MATERIAL:INORGANIC:GABBRO:[[Interaction_token#SHARP_ROCK|SHARP_ROCK]]]
shoots a sharp [[gabbro]] rock
[CDI:MATERIAL:PLANT_MAT:GRASS_CAVE_WHEAT:MILL:[[Interaction_token#UNDIRECTED_DUST|UNDIRECTED_DUST]]]
releases a cloud of [[Cave wheat|dwarven wheat flour]]
[CDI:MATERIAL:CREATURE_MAT:DWARF:TEARS:[[Interaction_token#SPATTER_LIQUID|SPATTER_LIQUID]]]
creates a pool of [[dwarf|dwarven]] tears

'''[CDI:FLOW:<flow emission type>]'''

Is used to emit one of the special hardcoded flow types ([[Interaction_token#FIREBALL|FIREBALL]], [[Interaction_token#FIREJET|FIREJET]] or [[Interaction_token#DRAGONFIRE|DRAGONFIRE]]).

Example:

[CDI:FLOW:[[Interaction_token#DRAGONFIRE|DRAGONFIRE]]]

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Usage Type
! Description
|-
| {{text anchor|TRAILING_DUST_FLOW}}
| MATERIAL
| Shoots a trail of solid dust at the target. Appears to use [[cave-in]] dust physics, as the dust cloud will fling around anything it comes in contact with (including the creature who emitted it), making it capable of smashing creatures into the ground and flinging them over walls. Creatures caught in the dust cloud will be [[contaminant|covered]] with dust; this will trigger any associated [[Syndrome#SYN_CONTACT|contact syndromes]].
|-
| {{text anchor|TRAILING_VAPOR_FLOW}}
| MATERIAL
| Shoots a trail of liquid mist at the target. Creatures caught in the vapor will be [[contaminant|covered]] with the condensed liquid; this will trigger any associated [[Syndrome#SYN_CONTACT|contact syndromes]].
|-
| {{text anchor|TRAILING_GAS_FLOW}}
| MATERIAL
| Shoots a trail of gaseous substance at the target. This can be inhaled, triggering any associated [[Syndrome#SYN_INHALED|inhalation syndromes]].
|-
| {{text anchor|TRAILING_ITEM_FLOW}}:[[item token]]
| MATERIAL
| Shoots a "cloud" of items at the target, leaving piles of this item on the floor. Note that this does ''not'' create the actual items or use falling item mechanics (meaning no flying daggers or Touhou-style barrages, unfortunately). Instead, this token acts as [[Interaction_token#TRAILING_GAS_FLOW|TRAILING_GAS_FLOW]], except that the material will use its ''normal'' temperature - for example, a breath attack of steel anvils will envelop the target in a "burst of steel".
|-
| {{text anchor|UNDIRECTED_DUST}}
| MATERIAL
| The creature releases a cloud of solid dust which spreads and dissipates. Similar to [[Interaction_token#TRAILING_DUST_FLOW|TRAILING_DUST_FLOW]], but undirected, thus affecting a larger area but losing the distance - range is roughly the same as that of a cave-in. Creature will attack as normal. <s>DO NOT USE THIS TAG UNLESS YOU WANT TO KILL THE CREATURE AND EVERYTHING NEAR IT AND SEND PEOPLE FLYING.</s> You know you want to.
|-
| {{text anchor|UNDIRECTED_VAPOR}}
| MATERIAL
| The creature releases a cloud of liquid mist which spreads and dissipates. Similar to [[Interaction_token#TRAILING_VAPOR_FLOW|TRAILING_VAPOR_FLOW]], but undirected, thus affecting a larger area but losing the distance.
|-
| {{text anchor|UNDIRECTED_GAS}}
| MATERIAL
| The creature releases a cloud of gaseous material which spreads and dissipates. Similar to [[Interaction_token#TRAILING_GAS_FLOW|TRAILING_GAS_FLOW]], but undirected, thus affecting a larger area but losing the distance.
|-
| {{text anchor|UNDIRECTED_ITEM_CLOUD}}:[[item token]]
| MATERIAL
| The creature releases a "cloud" of items at the target, leaving piles of this item on the floor. The same comments apply as [[Interaction_token#TRAILING_ITEM_FLOW|TRAILING_ITEM_FLOW]].
|-
| {{text anchor|WEATHER_CREEPING_DUST}}
| MATERIAL
| Creates a cloud of creeping dust. Not usable by creatures.
|-
| {{text anchor|WEATHER_CREEPING_VAPOR}}
| MATERIAL
| Creates a cloud of creeping vapor. Not usable by creatures.
|-
| {{text anchor|WEATHER_CREEPING_GAS}}
| MATERIAL
| Creates a cloud of gas that appears at the edge of the map and slowly creeps across the map. Not usable by creatures.
|-
| {{text anchor|WEATHER_FALLING_MATERIAL}}
| MATERIAL
| Causes it to start raining a particular material. If the material is solid at the outdoor temperatures, it will snow the material instead. Can transfer [[Syndrome#SYN_CONTACT|contact syndromes]]. Regardless of the nature of the material, being caught in it will give dwarves the negative [[thought]] of being 'caught in freakish weather lately'. Not usable by creatures.
|-
| {{text anchor|SOLID_GLOB}}
| MATERIAL
| Shoots a [[Item_token#GLOB|solid glob]] of spinning substance at the target, leaving a symbol similar to broken arrows, if it misses. Essentially a projectile weapon. If the [[Interaction_token#WAIT_PERIOD|cooldown rate]] is short enough, some creatures with this breath attack will not move, preferring instead to hold position and shoot globs at their enemies, even when they are right next to them.
|-
| {{text anchor|SHARP_ROCK}}
| MATERIAL
| Just like [[Interaction_token#SOLID_GLOB|SOLID_GLOB]], but more harmful, as it shoots a sharpened [[Item_token#ROCK|solid chunk]] of material instead.
|-
| {{text anchor|LIQUID_GLOB}}
| MATERIAL
| Shoots a [[Item_token#LIQUID_MISC|liquid glob]] of substance at the target. [[Syndrome#SYN_CONTACT|Contact syndromes]] will take effect if the glob hits the target's exposed skin.
|-
| {{text anchor|SPATTER_POWDER}}
| MATERIAL
| Creates a [[contaminant|pile of powder]] at the specified location.
|-
| {{text anchor|SPATTER_LIQUID}}
| MATERIAL
| Creates a [[contaminant|pool of liquid]] at the specified location.
|-
| {{text anchor|WEB_SPRAY}}
| MATERIAL
| Emits a burst of [[web]]s that entangle target creatures.
|-
| {{text anchor|DRAGONFIRE}}
| FLOW
| Emits a wide cone of [[dragon]] [[fire]] that burns target creatures at a scorching {{ct|50000}}.
|-
| {{text anchor|FIREJET}}
| FLOW
| Emits a narrow cone of [[fire]] that burns target creatures at {{ct|11000}}.
|-
| {{text anchor|FIREBALL}}
| FLOW
| Emits a fireball that burns the target creature.
|}

Keep in mind that you can give a creature multiple breath attacks, which appears to make the creature choose between them at random. Creatures cannot use the WEATHER effects, these being reserved for regional interactions.

One major difference between GAS, VAPOR, and DUST is that if the material cannot exist in the specified state at the current temperature, it will automatically be created at a temperature allowing it to exist. So if you create a vapor spray that uses rock or metal as a material, that spray will be created at the material's melting point, setting everything it touches on fire. You can also create a freezing spray by using a custom material that has extremely low melting and/or boiling points.

If you give a creature a material breath attack, be aware that it will be caught in the attack more frequently than its targets. Make sure to make your creatures immune to their own breath weapons!

==Creature and Caste Flags==

Certain interaction and syndrome effects (currently limited to [[Interaction_token#I_EFFECT|[IE_SUMMON_UNIT]]] and [[Syndrome#CE_BODY_TRANSFORMATION|[CE_BODY_TRANSFORMATION]]]) permit modders to specify the required/forbidden creature and caste flags of the desired creature(s). These are a collection of internal flags which are derived from [[Creature_token|creature tokens]] but are not necessarily identical to them. The following lists contain creature and caste flag names as provided by Toady One in a FotF reply [http://www.bay12forums.com/smf//index.php?topic=169696.msg8099138#msg8099138] (valid as of 0.47.04).

{{gamedata|title=Creature Flags|
ALL_CASTES_ALIVE
ARTIFICIAL_HIVEABLE
BIOME_DESERT_BADLAND
BIOME_DESERT_ROCK
BIOME_DESERT_SAND
BIOME_FOREST_TAIGA
BIOME_FOREST_TEMPERATE_BROADLEAF
BIOME_FOREST_TEMPERATE_CONIFER
BIOME_FOREST_TROPICAL_CONIFER
BIOME_FOREST_TROPICAL_DRY_BROADLEAF
BIOME_FOREST_TROPICAL_MOIST_BROADLEAF
BIOME_GLACIER
BIOME_GRASSLAND_TEMPERATE
BIOME_GRASSLAND_TROPICAL
BIOME_LAKE_TEMPERATE_BRACKISHWATER
BIOME_LAKE_TEMPERATE_FRESHWATER
BIOME_LAKE_TEMPERATE_SALTWATER
BIOME_LAKE_TROPICAL_BRACKISHWATER
BIOME_LAKE_TROPICAL_FRESHWATER
BIOME_LAKE_TROPICAL_SALTWATER
BIOME_MARSH_TEMPERATE_FRESHWATER
BIOME_MARSH_TEMPERATE_SALTWATER
BIOME_MARSH_TROPICAL_FRESHWATER
BIOME_MARSH_TROPICAL_SALTWATER
BIOME_MOUNTAIN
BIOME_OCEAN_ARCTIC
BIOME_OCEAN_TEMPERATE
BIOME_OCEAN_TROPICAL
BIOME_POOL_TEMPERATE_BRACKISHWATER
BIOME_POOL_TEMPERATE_FRESHWATER
BIOME_POOL_TEMPERATE_SALTWATER
BIOME_POOL_TROPICAL_BRACKISHWATER
BIOME_POOL_TROPICAL_FRESHWATER
BIOME_POOL_TROPICAL_SALTWATER
BIOME_RIVER_TEMPERATE_BRACKISHWATER
BIOME_RIVER_TEMPERATE_FRESHWATER
BIOME_RIVER_TEMPERATE_SALTWATER
BIOME_RIVER_TROPICAL_BRACKISHWATER
BIOME_RIVER_TROPICAL_FRESHWATER
BIOME_RIVER_TROPICAL_SALTWATER
BIOME_SAVANNA_TEMPERATE
BIOME_SAVANNA_TROPICAL
BIOME_SHRUBLAND_TEMPERATE
BIOME_SHRUBLAND_TROPICAL
BIOME_SUBTERRANEAN_CHASM
BIOME_SUBTERRANEAN_LAVA
BIOME_SUBTERRANEAN_WATER
BIOME_SWAMP_MANGROVE
BIOME_SWAMP_TEMPERATE_FRESHWATER
BIOME_SWAMP_TEMPERATE_SALTWATER
BIOME_SWAMP_TROPICAL_FRESHWATER
BIOME_SWAMP_TROPICAL_SALTWATER
BIOME_TUNDRA
DOES_NOT_EXIST
EQUIPMENT
EQUIPMENT_WAGON
EVIL
FANCIFUL
GENERATED
GOOD
HAS_ANY_BENIGN
HAS_ANY_CANNOT_BREATHE_AIR
HAS_ANY_CANNOT_BREATHE_WATER
HAS_ANY_CAN_SWIM
HAS_ANY_CARNIVORE
HAS_ANY_COMMON_DOMESTIC
HAS_ANY_CURIOUS_BEAST
HAS_ANY_DEMON
HAS_ANY_FEATURE_BEAST
HAS_ANY_FLIER
HAS_ANY_FLY_RACE_GAIT
HAS_ANY_GRASP
HAS_ANY_GRAZER
HAS_ANY_HAS_BLOOD
HAS_ANY_IMMOBILE
HAS_ANY_INTELLIGENT_LEARNS
HAS_ANY_INTELLIGENT_SPEAKS
HAS_ANY_LARGE_PREDATOR
HAS_ANY_LOCAL_POPS_CONTROLLABLE
HAS_ANY_LOCAL_POPS_PRODUCE_HEROES
HAS_ANY_MEGABEAST
HAS_ANY_MISCHIEVIOUS
HAS_ANY_NATURAL_ANIMAL
HAS_ANY_NIGHT_CREATURE
HAS_ANY_NIGHT_CREATURE_BOGEYMAN
HAS_ANY_NIGHT_CREATURE_EXPERIMENTER
HAS_ANY_NIGHT_CREATURE_HUNTER
HAS_ANY_NIGHT_CREATURE_NIGHTMARE
HAS_ANY_NOT_FIREIMMUNE
HAS_ANY_NOT_FLIER
HAS_ANY_NOT_LIVING
HAS_ANY_OUTSIDER_CONTROLLABLE
HAS_ANY_POWER
HAS_ANY_RACE_GAIT
HAS_ANY_SEMIMEGABEAST
HAS_ANY_SLOW_LEARNER
HAS_ANY_SUPERNATURAL
HAS_ANY_TITAN
HAS_ANY_UNIQUE_DEMON
HAS_ANY_UTTERANCES
HAS_ANY_VERMIN_HATEABLE
HAS_ANY_VERMIN_MICRO
HAS_FEMALE
HAS_MALE
LARGE_ROAMING
LOOSE_CLUSTERS
MATES_TO_BREED
MUNDANE
OCCURS_AS_ENTITY_RACE
SAVAGE
SMALL_RACE - applies to any vermin creature
TWO_GENDERS
UBIQUITOUS
VERMIN_EATER
VERMIN_FISH
VERMIN_GROUNDER
VERMIN_ROTTER
VERMIN_SOIL
VERMIN_SOIL_COLONY
}}

{{gamedata|title=Caste Flags|
ADOPTS_OWNER
ALCOHOL_DEPENDENT
ALL_ACTIVE
AMBUSHPREDATOR
AQUATIC_UNDERSWIM
ARENA_RESTRICTED
AT_PEACE_WITH_WILDLIFE
BENIGN
BLOODSUCKER
BONECARN
CANNOT_BREATHE_AIR
CANNOT_CLIMB
CANNOT_JUMP
CANOPENDOORS
CAN_BREATHE_WATER
CAN_LEARN / INTELLIGENT_LEARNS
CAN_SPEAK / INTELLIGENT_SPEAKS
CAN_SWIM
CAN_SWIM_INNATE
CARNIVORE
CAVE_ADAPT
COLONY_EXTERNAL
COMMON_DOMESTIC
CONVERTED_SPOUSE
COOKABLE_LIVE
CRAZED
CREPUSCULAR
CURIOUS_BEAST
CURIOUS_BEAST_EATER
CURIOUS_BEAST_GUZZLER
CURIOUS_BEAST_ITEM
DEMON
DIE_WHEN_VERMIN_BITE
DIURNAL
DIVE_HUNTS_VERMIN
EQUIPS
EXTRAVISION
FEATURE_ATTACK_GROUP
FEATURE_BEAST
FIREIMMUNE
FIREIMMUNE_SUPER
FISHITEM
FLEEQUICK
FLIER
GELDABLE
GETS_INFECTIONS_FROM_ROT
GETS_WOUND_INFECTIONS
GNAWER
GRAZER
HASSHELL
HAS_BABYSTATE
HAS_BLOOD
HAS_CHILDSTATE
HAS_COLOR
HAS_FLY_RACE_GAIT
HAS_GLOW_COLOR
HAS_GLOW_TILE
HAS_GRASP
HAS_NERVES
HAS_PUS
HAS_RACE_GAIT
HAS_ROTTABLE
HAS_SECRETION
HAS_SOLDIER_TILE
HAS_SOUND_ALERT
HAS_SOUND_PEACEFUL_INTERMITTENT
HAS_TILE
HUNTS_VERMIN
IMMOBILE
IMMOBILE_LAND
IMMOLATE
ITEMCORPSE
LAIR_HUNTER
LARGE_PREDATOR
LAYS_EGGS
LAYS_UNUSUAL_EGGS
LIGAMENTS
LIGHT_GEN
LISP
LOCAL_POPS_CONTROLLABLE
LOCAL_POPS_PRODUCE_HEROES
LOCKPICKER
MAGICAL
MAGMA_VISION
MANNERISM_BREATH
MANNERISM_EYELIDS
MANNERISM_LAUGH
MANNERISM_POSTURE
MANNERISM_SIT
MANNERISM_SMILE
MANNERISM_STRETCH
MANNERISM_WALK
MATUTINAL
MEANDERER
MEGABEAST
MILKABLE
MISCHIEVIOUS
MOUNT
MOUNT_EXOTIC
MULTIPART_FULL_VISION
MULTIPLE_LITTER_RARE
NATURAL_ANIMAL
NIGHT_CREATURE
NIGHT_CREATURE_BOGEYMAN
NIGHT_CREATURE_EXPERIMENTER
NIGHT_CREATURE_HUNTER
NIGHT_CREATURE_NIGHTMARE
NOBONES
NOBREATHE
NOCTURNAL
NOEMOTION
NOEXERT
NOFEAR
NOMEAT
NONAUSEA
NOPAIN
NOSKIN
NOSKULL
NOSMELLYROT
NOSTUCKINS
NOSTUN
NOTHOUGHT
NOT_BUTCHERABLE
NOT_LIVING
NO_AUTUMN
NO_CONNECTIONS_FOR_MOVEMENT
NO_DIZZINESS
NO_DRINK
NO_EAT
NO_FEVERS
NO_PHYS_ATT_GAIN
NO_PHYS_ATT_RUST
NO_SLEEP
NO_SPRING
NO_SUMMER
NO_THOUGHT_CENTER_FOR_MOVEMENT
NO_UNIT_TYPE_COLOR
NO_VEGETATION_PERTURB
NO_WINTER
OPPOSED_TO_LIFE
OUTSIDER_CONTROLLABLE
PACK_ANIMAL
PARALYZEIMMUNE
PATTERNFLIER
PEARL
PET
PET_EXOTIC
POWER
REMAINS_ON_VERMIN_BITE_DEATH
REMAINS_UNDETERMINED
RETURNS_VERMIN_KILLS_TO_OWNER
SEMIMEGABEAST
SLOW_LEARNER
SPOUSE_CONVERSION_TARGET
SPOUSE_CONVERTER
SPREAD_EVIL_SPHERES_IF_RULER
STANCE_CLIMBER
STRANGE_MOODS
SUPERNATURAL
TENDONS
THICKWEB
TITAN
TRAINABLE_HUNTING
TRAINABLE_WAR
TRANCES
TRAPAVOID
UNIQUE_DEMON
UTTERANCES
VEGETATION
VERMIN_GOBBLER
VERMIN_HATEABLE
VERMIN_MICRO
VERMIN_NOFISH
VERMIN_NOROAM
VERMIN_NOTRAP
VESPERTINE
WAGON_PULLER
WEBBER
WEBIMMUNE
}}

==See Also==
* [[Syndrome]]
* [[Interaction examples]]

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

Graphics token

2024-05-18T06:55:40Z

Putnam3145:

{{Quality|Exceptional}}
{{av}}
{{Modding}}
:{{for/see|an explanation of how to use the various graphics types|[[Graphics]]}}

The <code>[OBJECT:GRAPHICS]</code> [[token]] defines the use of various tile-based graphics in the game. As of version 50.01, graphics tokens have been greatly expanded to accommodate the release of the Steam & Itch premium version. These tokens, and explanations on how to use them, are listed below; the list will expand as the tokens are discovered and understood.

== Creature Graphics ==
Creature graphics are found within graphics_creature_x files (such as graphics_creature_domestic or graphics_creature_layered). All graphics files must begin with the file name, followed by the <code>[OBJECT:GRAPHICS]</code> type that tells the game that the file contains graphics definitions. A more detailed explanation on how to use these can be found in [[Graphics#Creature_Graphics|creature graphics]].

=== Types ===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Type
! Arguments
! Description

|-
| {{text anchor|CREATURE_GRAPHICS}}
|
* [[Creature token|creature id]]
| The simplest and most common form of creature graphics for defining one sprite for each [[#Condition|basic condition]].

Further conditions are required for this to function following the [[Graphics#Basic_Graphics|creature graphics]] format. Accepts [[Graphics#Large_Graphics|large graphics tokens]].

Additionally used to start defining a [[Graphics#Layered_Graphics|layered graphics]] set.

|-
| {{text anchor|CREATURE_CASTE_GRAPHICS}}
|
* [[Creature token|creature id]]
* [[Caste|Caste ID]]
| Nearly the same as {{token|CREATURE_GRAPHICS|g}}, but allows a separate sprite to be defined for each caste.
A simple alternative to [[Graphics#Layered Graphics|Layered Graphics]].

Requires conditions defined in [[Graphics#Basic_Graphics|creature graphics]] format. Accepts [[Graphics#Large_Graphics|large graphics tokens]].

|-
| {{text anchor|STATUE_CREATURE_GRAPHICS}}
|
* [[Creature token|creature id]]
| Format for beginning a [[Graphics#Statue_Graphics|creature statue definition]]. Defines a 1x2 vertical rectangle to be displayed when a statue depicts one of these creatures.

|-
| {{text anchor|STATUE_CREATURE_CASTE_GRAPHICS}}
|
* [[Creature token|creature id]]
* [[Caste|Caste ID]]
| Format for beginning a [[Graphics#Statue_Graphics|creature statue definition]] while specifying caste. Defines a 1x2 vertical rectangle to be displayed when a statue depicts one of these creatures.

|-
| {{text anchor|TILE_GRAPHICS_RECTANGLE}}
|
* [[Creature token|creature id]]
| Graphics for a 3x2 rectangle; for creatures, this is used exclusively for representing Forgotten Beasts based on their body parts. Uses [[Graphics#Forgotten_Beast_Graphics|forgotten beast graphics]]. It's also, however, used for interface graphics, see [[graphics_interface.txt]].

|}

=== Conditions ===
Different graphics can be defined for the same creature based on some properties about it. Below is a list of all the basic "creature texture" types that can be used as additional conditions to various basic sprites.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text anchor|DEFAULT}} || The default condition that will be displayed unless overwritten by a more specific one below.

|-
| {{text anchor|LAW_ENFORCE}} || Displayed if the unit is law enforcement.

|-
| {{text anchor|TAX_ESCORT}} || Displayed if the unit escorts a tax collector (unused).

|-
| {{text anchor|ANIMATED}} || Displayed if the creature is raised from the dead using an I_EFFECT:ANIMATE interaction.

|-
| {{text anchor|GHOST}} || Displayed if the creature is a ghost.

|-
| {{text anchor|ADVENTURER}} || Displayed if the creature is an adventurer.

|-
| {{text anchor|CORPSE}} || Displayed for corpses.

|}

=== Basic creature sprite types ===

An individual sprite can be of any of the following classes. If "accepts secondary" is "yes", it can also have an extra condition tacked on at the end.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text_anchor|Basic Condition}} || Any of the [[Graphics token#Conditions|above conditions]] can be used on their own, as the default for that condition class.

|-
| {{text_anchor|Unit type}} || Any [[Unit type token]] can be used. You may also append a [[Graphics token#Conditions|basic condition as above]] to further specify.

|-
| {{text_anchor|Position}} || Any [[Position token]] can be used, such as MONARCH, BROKER etc. All position tokens are raw-defined; any modded positions can have their own graphics. You may also append a [[Graphics token#Conditions|basic condition as above]] to further specify.

|-
| {{text_anchor|LIST_ICON}} || The default icon for this creature in lists, such as [[Arena]] mode or overall training.

|-
| {{text_anchor|EGG}} || The sprite for a clutch of eggs.

|-
| {{text_anchor|SKELETON}} || The sprite for a rotten corpse.

|-
| {{text_anchor|SKELETON_WITH_SKULL}} || The sprite for a rotten corpse that can have a [[totem]] made from it.

|}

=== Layered Conditions ===
Layers aren't very useful on their own, so they come with a set of conditions to define how when they are displayed and how they interact.

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

|-
| {{text_anchor|LAYER_SET}} ||
* condition
| Creature Graphics
| Begins defining a layer set for a creature's graphics. Valid values of ''condition'' are DEFAULT, PORTRAIT{{version|50.13}}, or CORPSE. Valid values for basic conditions may not work.{{verify}}

|-
| {{text_anchor|LS_PALETTE}}{{version|50.13}} ||
* name
|| Layer Set
|| Begins defining a palette for the layer set. Its name can be referenced by {{token|USE_PALETTE|g}}. Unlike the palettes used to render all [[descriptor color token]]s, it can be of arbitrary length.

|-
| {{text_anchor|LS_PALETTE_FILE}}{{version|50.13}} ||
* file name
| Palette
| The file name of the 8bit RGBA (sometimes called 32bit) in the <tt>/graphics/images</tt> folder of the mod, such as <tt>images/portraits/dwarf_portrait_body_palette.png</tt>.

|-
| {{text_anchor|LS_PALETTE_DEFAULT}}{{version|50.13}} ||
* integer
| Palette
| Defines the default row of a layer set palette, conventionally 0. The exact color values on this row will be replaced on layer images with the colors in the same column, based on what row is passed as an argument to {{token|USE_PALETTE|g}}.

|-
| {{text_anchor|LG_CONDITION_BP}}{{version|50.13}} ||
* selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
* category, type, or token
|| Layer Group
|| Allows the entire layer group (rather than an individual layer) to be switched on and off depending on the conditions of a body part. Should accept the same tokens {{token|CONDITION_BP|g}} does. {{verify}}

|-
| {{text_anchor|END_LAYER_GROUP}} || || Layer Group
| Explicitly marks the end of a layer group, which allows layers after to not belong to any layer group.

|-
| {{text_anchor|CONDITION_ITEM_WORN}} ||
* BY_CATEGORY / BY_TOKEN
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
* Armor type (ARMOR, GLOVES, Etc.)
* Item ID(s)
|| Armor Wieldables || Defines a clothing or armor graphic by the specific part it is equipped to, the type of armor it is, and the internal id of that item.
For example, a condition representing a right handed mitten or glove would be defined as:
<code>[CONDITION_ITEM_WORN:BY_TOKEN:RH:GLOVES:ITEM_GLOVES_MITTENS]</code>
Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).

|-
| {{text_anchor|SHUT_OFF_IF_ITEM_PRESENT}} ||
* BY_CATEGORY / BY_TOKEN
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
* Armor type
* Item ID(s)
|| Armor || Causes the current layer to not be rendered if the creature has one of the items worn or equipped. Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).

|-
| {{text_anchor|CONDITION_CASTE}} ||
* caste name(s)
|| General
|| Displays this layer if the creature is this caste. Only one caste is accepted for each condition, but multiple caste conditions can be used in one layer and the layer will be displayed if any of them match.

|-
| {{text_anchor|CONDITION_DYE}} ||
* dye color
|| Armor
|| Should represent which color the clothing is dyed. Currently nonfunctional.{{version|50.05}}

|-
| {{text_anchor|CONDITION_NOT_DYED}} || || Armor
|| Should check if the clothing is dyed. Currently nonfunctional.{{version|50.05}}

|-
| {{text_anchor|CONDITION_MATERIAL_FLAG}} ||
* material flag
|| Material || Changes graphics based on the material an equipped item is made of. Valid material flags are similar to [[Reaction#Full_token_list|reactant conditions]] including:
* WOVEN_ITEM
* ANY_X_MATERIAL
:with X being:
:* PLANT, SILK, YARN, LEATHER, WOOD, SHELL, BONE, STONE, GEM, TOOTH, HORN, PEARL
* IS_DIVINE_MATERIAL
* NOT_ARTIFACT
* IS_CRAFTED_ARTIFACT
* METAL_ITEM_MATERIAL
* GLASS_MATERIAL
* FIRE_BUILD_SAFE
* MAGMA_BUILD_SAFE
[http://www.bay12forums.com/smf/index.php?topic=169696.msg8442543#msg8442543 among other, less useful ones.]

|-
| {{text_anchor|CONDITION_MATERIAL_TYPE}} ||
* material token
|| Material || Changes graphics based on the material an equipped item is made of. Valid material types take the form <code>METAL:COPPER</code> where copper can be replaced with any weapons-grade metal. General [[material token]]s are '''not''' functional. {{token|CONDITION_MATERIAL_FLAG|g}} is a better option for any material condition other than metal.

|-
| {{text_anchor|CONDITION_PROFESSION_CATEGORY}} ||
* [[Unit type token#Profession Categories|profession category token(s)]]
|| General
|| Checks the profession category of the creature to act as a condition. Multiple profession category tokens can be chained together. You can also use multiple of these tokens instead of listing them all in a single one, but this is functionally identical. Valid Profession tokens which are not categories will be ignored; values that do not match any existing Profession will be treated as <code>NONE</code> and thus apply to doctors, military, etc..

|-
| {{text_anchor|CONDITION_RANDOM_PART_INDEX}} ||
* identifier
* integer index
* integer range
|| General
|| Chooses a random layer among layers with the a CONDITION_RANDOM_PART_INDEX with the same identifier. Index is which option this condition is, out of Range number of options. Ex:
<code>[CONDITION_RANDOM_PART_INDEX:HEAD:3:4]</code>
Is the third possible random head out of four total options. One of these random conditions each will be put into a set of four different sprites to add some random variation in the appearance of the creature's head.

|-
| {{text_anchor|CONDITION_HAUL_COUNT_MIN}} ||
* integer
|| General
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL}}s in vanilla.

|-
| {{text_anchor|CONDITION_HAUL_COUNT_MAX}} ||
* integer
|| General
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL}}s in vanilla.

|-
| {{text_anchor|CONDITION_CHILD}} || || General
|| Checks if the creature is a child or baby.

|-
| {{text_anchor|CONDITION_NOT_CHILD}} || || General
|| Checks if the creature is an adult.

|-
| {{text_anchor|CONDITION_GHOST}} || || General
|| Checks if the creature is a ghost.

|-
| {{text_anchor|CONDITION_SYN_CLASS}} ||
* [[Syndrome#SYN_CLASS|SYN_CLASS]]
|| Syndrome || Changes graphics based on any syndromes the creature is affected by. Vanilla values include:
* ZOMBIE
* NECROMANCER
* VAMPCURSE
* RAISED_UNDEAD
* GHOUL

|-
| {{text_anchor|CONDITION_TISSUE_LAYER}} ||
* BY_CATEGORY
* [[Body_token#CATEGORY|body part category]] or ALL
* [[Body_detail_plan_token#BP_LAYERS|tissue layer]] or ALL
|| Tissue
|| Selects a tissue layer to use for checking other conditions. Ex:
<code>[CONDITION_TISSUE_LAYER:BY_CATEGORY:ALL:SKIN]</code>

|-
| {{text_anchor|TISSUE_MIN_LENGTH}} ||
* integer
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is greater than the integer input.

|-
| {{text_anchor|TISSUE_MAX_LENGTH}} ||
* integer
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is less than the integer input.

|-
| {{text_anchor|TISSUE_MAY_HAVE_COLOR}} ||
* [[Color#Color_tokens|color token(s)]]
|| Tissue
|| Checks the selected tissue's color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.

|-
| {{text_anchor|TISSUE_MAY_HAVE_SHAPING}} ||
* styling token
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s shaping (hairstyle). Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.{{verify}}

|-
| {{text_anchor|TISSUE_NOT_SHAPED}} || || Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.

|-
| {{text_anchor|TISSUE_SWAP}} ||
* IF_MIN_CURLY
* integer
* tile page id
* x position
* y position
| Tissue
| Checks if a tissue is sufficiently curly, and if so swaps to display a different image. The new image is defined by the tile page ID, x position, and y position.

This condition should be within a [LAYER:... ] that has a similar graphic to the on in the TISSUE_SWAP.
The current {{token|CONDITION_TISSUE_LAYER|g}} group must also include a {{token|TISSUE_MIN_LENGTH|g}}.

|-
| {{text_anchor|ITEM_QUALITY}}{{version|50.13}} ||
* integer
| Armor Wieldables{{verify}}
|| Checks the current {{token|CONDITION_ITEM_WORN|g}}'s [[quality]]. 0 is base quality, 5 is masterwork. See [CONDITION_MATERIAL_FLAG:IS_CRAFTED_ARTIFACT] for [[artifact]]-quality items.

|-
| {{text_anchor|USE_PALETTE}}{{version|50.13}} ||
* layer set palette
* row
| General
|| Colors the layer using that row of the layer-set-specific {{token|LS_PALETTE|g}}.

|-
| {{text_anchor|USE_STANDARD_PALETTE_FROM_ITEM}}{{version|50.13}} || || Armor Wieldables{{verify}}
|| Uses the default palette to render the layer based on the [[Material definition token#STATE_COLOR|color]] of the current {{token|CONDITION_ITEM_WORN|g}}.

|-
| {{text_anchor|CONDITION_BP}}{{version|50.13}} ||
* selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
* category, type, or token
| Body
|| Defines a body part graphic using standard [[body token]] selection criteria.

|-
| {{text_anchor|BP_APPEARANCE_MODIFIER_RANGE}}{{version|50.13}} ||
* QUALITY
* minimum
* maximum
| Body
|| Checks if current {{token|CONDITION_BP|g}}'s {{token|BP_APPEARANCE_MODIFIER|c}} falls within the chosen range.

|-
| {{text_anchor|BP_PRESENT}}{{version|50.13}} || || Body
|| Checks if the current {{token|CONDITION_BP|g}} is present and not destroyed, pulped, or severed. Can also be applied to {{token|LG_CONDITION_BP|g}}.

|-
| {{text_anchor|BP_SCARRED}}{{version|50.13}} || || Body
|| Checks if the current {{token|CONDITION_BP|g}} is scarred. Seems to also require {{token|BP_PRESENT|g}} to avoid illogical results. {{verify}}

|}

=== Vermin Conditions ===
Special Conditions for {{token|VERMIN|c}} creature graphics:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text anchor|VERMIN}} || The default graphic for this vermin.

|-
| {{text anchor|VERMIN_ALT}} || Image cycles every 1 second.

|-
| {{text anchor|SWARM_SMALL}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in small groups.

|-
| {{text anchor|SWARM_MEDIUM}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in medium-sized groups.

|-
| {{text anchor|SWARM_LARGE}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in large groups.

|-
| {{text anchor|LIGHT_VERMIN}} || For [[firefly|fireflies]] etc. Does not replace {{token|VERMIN|g}}.

|-
| {{text anchor|LIGHT_VERMIN_ALT}} || Like {{token|VERMIN_ALT|g}} for [[firefly|fireflies]] etc.

|-
| {{text anchor|LIGHT_SWARM_SMALL}} || Like {{token|SWARM_SMALL|g}} for [[firefly|fireflies]] etc. in small groups.

|-
| {{text anchor|LIGHT_SWARM_MEDIUM}} || Like {{token|SWARM_LARGE|g}} for [[firefly|fireflies]] etc. in large groups.

|-
| {{text anchor|LIGHT_SWARM_LARGE}} || Like {{token|SWARM_LARGE|g}} for [[firefly|fireflies]] etc.

|-
| {{text anchor|REMAINS}} || Vermin corpses.

|-
| {{text anchor|HIVE}} || Vermin hives.
|}

== Item Graphics ==
Item graphics can also be defined, but are mostly hardcoded. This section of the wiki needs to be fleshed out. Descriptions of the token functions is provisional.

Item graphics currently do not support LARGE_IMAGE.

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

|-
| {{text_anchor|TILE_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Begins defining tile graphics for an item. Sets default tile graphic.{{verify}}

|-
| {{text_anchor|BOULDER_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for BOULDER items by material; currently all boulders use material palette instead.

|-
| {{text_anchor|ROUGH_GEM_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for ROUGH (gem) items by material; currently all rough gems use material palette instead.

|-
| {{text_anchor|BARS_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID or item ID
| Defines tile graphics variants to use for BAR items by material.

|-
| {{text_anchor|FOOD_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for FOOD items.

|-
| {{text_anchor|CHEESE_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for CHEESE items by material. Unused in vanilla raws.

|-
| {{text_anchor|ARMOR_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for ARMOR items; this is for items not being worn by a creature.

|-
| {{text_anchor|GLOVES_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for GLOVES items; this is for items not being worn by a creature.

|-
| {{text_anchor|HELM_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for HELM items; this is for items not being worn by a creature.

|-
| {{text_anchor|PANTS_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for PANTS items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHOES_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for SHOES items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHOES_GRAPHICS_METAL}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines metal material tile graphics variants for SHOES items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHIELD_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for SHIELD items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHIELD_GRAPHICS_WOODEN}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines wood material tile graphics variants for SHIELD items; this is for items not being worn by a creature.

|-
| {{text_anchor|TOY_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
* Material ID
| Defines tile graphics for TOY items. Material ID in this case is one of STONE, WOOD, METAL, or GLASS.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for TRAPCOMP items.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS_WEAPON_TRAP}}
|
* Tile page ID
* x index
* y index
| Defines tile graphics for TRAPCOMP items when built into a weapon trap; must follow TRAPCOMP_GRAPHICS.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS_UPRIGHT_#X}}
|
* Tile page ID
* x index
* y index
| Defines tile graphics for installed upright spike traps. These comprise two-tile graphics: # is replaced with the number of spikes, 1-10; X is replaced with T (for top graphic tile) or B (bottom graphic tile). This follows the tile graphics definition of either MENACINGSPIKE or SPEAR.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS}}
|
* Item ID
| Begins defining graphics for SIEGEAMMO items.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_STRAIGHT_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for ballista arrows aligned orthogonally on the map; follows SEIGEAMMO_GRAPHICS.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_STRAIGHT_WOOD}}
|
* Tile page ID
* x index
* y index
| Wooden variant of above.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_DIAGONAL_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for ballista arrows aligned diagonally on the map; follows SEIGEAMMO_GRAPHICS.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_DIAGONAL_WOOD}}
|
* Tile page ID
* x index
* y index
| Wood variant of above.

|-
| {{text_anchor|AMMO_GRAPHICS}}
|
* Item ID
| Begins defining graphics for AMMO items.

|-
| {{text_anchor|AMMO_GRAPHICS_STRAIGHT_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for AMMO items aligned orthogonally on the map; follows AMMO_GRAPHICS.

|-
| {{text_anchor|AMMO_GRAPHICS_STRAIGHT_WOOD}}
|
* Tile page ID
* x index
* y index
| Wooden variant of above.

|-
| {{text_anchor|AMMO_GRAPHICS_DIAGONAL_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for AMMO aligned diagonally on the map; follows AMMO_GRAPHICS.

|-
| {{text_anchor|AMMO_GRAPHICS_DIAGONAL_WOOD}}
|
* Tile page ID
* x index
* y index
| Wood variant of above.

|-
| {{text_anchor|WEAPON_GRAPHICS}}
|
* Item ID
| Begins defining graphics for WEAPON items.

|-
| {{text_anchor|WEAPON_GRAPHICS_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines default graphics for WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_MATERIAL}}
|
* Tile page ID
* x index
* y index
| Defines material palette{{verify}} graphics for WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WOOD_GROWN}}
|
* Tile page ID
* x index
* y index
| Defines graphics for grown-wood WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WOOD}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WEAPON_TRAP}}
|
* Tile page ID
* x index
* y index
| Defines graphics for WEAPON item defined by WEAPON_GRAPHICS as it appears installed in a weapon trap; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|TOOL_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines default graphics for TOOL items; also begins defining variant graphics for material or container conditions when followed by tokens below.

|-
| {{text_anchor|ADD_TOOL_GRAPHICS}}
|
* Item ID
| Adds graphics to an existing tool defined with TOOL_GRAPHICS, followed by the tool graphics material or container condition tokens below.

|-
| {{text_anchor|TOOL_GRAPHICS_WOOD}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for wooden TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_STONE}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for stone TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_METAL}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for metal TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_GLASS}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for glass TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_WOOD_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_STONE_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for stone liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_METAL_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for metal (and glass?) liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for the liquid filling a liquid-containing container; follows TOOL_GRAPHICS_CONTAINER_*_LIQUID.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_WOOD_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden containers holding items; follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_STONE_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for stone containers holding items; follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_METAL_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for metal (and glass?) containers holding items; follows ADD_TOOL_GRAPHICS definition for container.
|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_BLD}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items.

|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_BLD_IN_USE}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items that have hives installed.

|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_PRODUCTS}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items that are ready to be harvested.

|-
| {{text_anchor|TOOL_GRAPHICS_SHAPE}}
|
* Shape ID
* Tile page ID
* x index
* y index
| Defines graphics for shaped items; currently used for dice.

|}

== World Map Graphics ==
World map graphics are defined in <code>[[Game_folders_and_files#Game_folder|Dwarf Fortress]]\data\vanilla\vanilla_world_map\graphics\graphics_world_map.txt</code>
Tokens that accept variants have 5 of them:

[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:1]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:2]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:3]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:4]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:5]

Otherwise:

[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>]

==See Also==
*[[Creature token]]
*[[Syndrome]]
*[[Creature examples]]

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

Syndrome

2024-05-04T17:55:43Z

Putnam3145: /* Special Effects */

{{Quality|Masterwork}}
{{av}}
[[File:syndrome_statuses_anim.gif|right]][[File:skin_color_preview.png|thumb|right|What different undead/immortal creatures' skin colors mean, which are also syndromes.]]In ''Dwarf Fortress'', a '''syndrome''' can be thought of as a condition which applies a collection of [[Syndrome#Creature effect tokens|effects]] to [[creature]]s who contract it. Syndromes give rise to several of the game's [[fun|more interesting]] [[Health care|medical]] [[Status_icon|predicaments]], such as [[alcohol]] inebriation, venomous snake bites, and the brain-rotting secretions of certain [[Forgotten beast|uninvited guests]]. That said, the syndrome system isn't functionally restricted to the simulation of disease - many of the game's supernatural features, such as [[werewolf|werewolves]], [[vampire]]s, [[necromancer]]s, [[mummy|mummy curses]] and the [[undead]], are in fact produced by applying various [[Syndrome#Special_Effects|special effects]] to creatures via syndromes.

Graphically, [[Dwarf|dwarves]], [[human]]s, [[elf|elves]], [[goblin]]s and [[kobold]]s with supernatural syndromes will have a different skin color, as seen in the image to the right. Other creatures will appear exactly as they are with no alterations, unless they're undead, in which they will appear with an indigo/blue tint, black eyes and white pupils, as every creature will have a unique undead sprite (including that of children and babies for some creatures).

''"Yeah, I know this. I was looking for [[Syndrome examples|examples]]..."''

==List of syndromes==
In unmodded games, syndromes are generally named after the animal, substance or effect that delivers them. They can cause unpleasant and sometimes fatal [[symptom]]s over a short to long duration, but some will clear up over time or with the assistance of a [[doctor]]. A [[Health care|hospital]] is required to diagnose and potentially treat those that can be helped by treatment. Note that in a world with [[dragon]]s and [[giant elephant]]s, dwarves (and elves and humans) fall into the "small creatures" category for purposes of this discussion.
{| {{prettytable}}
|- bgcolor="#dddddd"
! Syndrome
! Venom
! Acquired
! Short-term Symptoms
! Long-term Symptoms
! Chronic Symptoms
|-
| Adder bite
| adder venom (injected)
| Being bitten by an [[adder]], [[giant adder]] or [[adder man]]
| Strong pain
| Swelling Blisters Nausea
| None
|-
| Bark scorpion sting
| bark scorpion venom (injected)
| Being stung by a [[bark scorpion]], [[giant bark scorpion]] or [[bark scorpion man]]
| Strong pain
| None
| None
|-
| Black mamba bite
| black mamba venom (injected)
| Being bitten by a [[black mamba]], [[giant black mamba]] or [[black mamba man]]
| Dizziness Drowsiness Strong pain Fever Unconsciousness Complete paralysis1
| None
| None
|-
| Blob blisters
| cave blob fluid (contact or ingested)
| Touching a [[cave blob]]
| Mild pain Mild blisters
| None
| None
|-
| Brown recluse spider bite
| brown recluse spider venom (injected)
| Being bitten by a [[brown recluse spider]], [[giant brown recluse spider]] or [[brown recluse spider man]]
| Nausea Fever Pain 
| Severe localized necrosis
| None
|-
| Bumblebee sting
| bumblebee venom (injected)
| Being stung by a [[bumblebee]] worker
| Pain Strong swelling
| None
| None
|-
| Bushmaster bite
| bushmaster venom (injected)
| Being bitten by a [[bushmaster]], [[giant bushmaster]] or [[bushmaster man]]
| Strong pain Mild bleeding Dizziness Nausea Unconsciousness Complete paralysis1
| None
| None
|-
| Cave floater sickness
| cave floater gas (inhaled or ingested)
| Expelled from [[cave floater]]
| Mild nausea
| Fever Strong drowsiness (delayed) Strong dizziness (delayed)
| None
|-
| Cave spider bite
| cave spider venom (injected)
| Being bitten by a [[cave spider]]
| None
| None
| Very mild dizziness
|-
| Copperhead snake bite
| copperhead snake venom (injected)
| Being bitten by a [[copperhead snake]], [[giant copperhead snake]] or [[copperhead snake man]]
| Pain Swelling Nausea
| None
| None
|-
| Giant cave spider bite
| giant cave spider venom (injected)
| Being bitten by a [[giant cave spider]]
| Size-dependant paralysis.
| Death by asphyxiation, in small targets. Large targets are generally unhindered...unless you count the high probability of being eaten by the giant cave spider as a hindrance.
| None, not that it really matters.
|-
| Gila monster bite
| gila monster venom (injected)
| Being bitten by a [[gila monster]], [[giant gila monster]] or [[gila monster man]]
| Pain Mild swelling
| None
| None
|-
| Gnomeblight
| [[gnomeblight]] (contact, inhaled, injected, or ingested)
| Purposely exposing oneself to the extract. Only affects [[mountain gnome]]s and [[dark gnome]]s.
| None
| Severe systemic necrosis2
| None
|-
| Giant desert scorpion sting
| giant desert scorpion venom (injected)
| Being stung by a [[giant desert scorpion]]
| Necrosis of the brain and nervous system
| '''Certain death'''
| None, not that it really matters.
|-
| Helmet snake bite
| helmet snake venom (injected)
| Being bitten by a [[helmet snake]]
| Minor bleeding
| Fever Nausea Dizziness Localized swelling Localized oozing Localized bruising Strong pain Intense localized necrosis Possible loss of limb
| None
|-
| Honey bee sting
| honey bee venom (injected)
| Being stung by a [[honey bee]] worker
| Pain Strong swelling
| None
| None
|-
| Inebriation
| [[Alcohol]] (consumed/injected)
| Consuming alcoholic drinks
| Nausea Dizziness Unconsciousness Personality changes Euphoria Erratic behavior Trouble breathing
| None
| None
|-
| Iron man cough
| iron man gas (inhaled)
| Expelled by [[iron man]]
| Coughing blood
| None
| None
|-
| King cobra bite
| king cobra venom (injected)
| Being bitten by a [[king cobra]]
| Complete paralysis1 Pain, dizziness, drowsiness
| None
| None
|-
| Phantom spider bite
| phantom spider venom (injected)
| Being bitten by a [[phantom spider]]
| None
| Numbness and mild dizziness
| None
|-
| Platypus sting
| platypus venom (injected)
| Being kicked by a [[platypus]], [[giant platypus]] or [[platypus man]]
| Pain and swelling
| Extreme pain, swelling possibly to the point of necrosis
| None
|-
| Rattlesnake bite
| rattlesnake venom (injected)
| Being bitten by a [[rattlesnake]], [[giant rattlesnake]] or [[rattlesnake man]]
| Pain, nausea, blisters, swelling, bruising
| Severe localized necrosis
| None
|-
| Serpent man bite
| serpent man venom (injected)
| Being bitten by a [[serpent man]]
| Complete paralysis1
| None
| None
|-
| Mummy's curse
| [[Mummy|Disturbance interaction]].
| Being cursed by a [[mummy]], when caught raiding their tombs
| None
| None
| 20% chance of any skill roll failing, regardless of skill.
|-
| Vampirism
| [[Deity|Divine]] curse
| Drinking the blood of a [[vampire]]. Toppling statues in shrines and temples (random chance), rolling divination dice too frequently.
| None
| None
| Victim becomes a [[vampire]].
|-
| Werebeast curse
| [[Deity|Divine]] curse
| Being bitten by a [[werebeast]], toppling statues in shrines and temples (random chance), rolling divination dice too frequently.
| None
| None
| Victim becomes a [[werebeast]].
|-
| Necromancy
| [[Deity|Divine]] 'curse'
| Reading a book/slab that contains the secrets of life and death.
| None
| None
| Reader becomes a [[necromancer]].
|-
| evil rain sickness3
|rowspan=7| Random
| Being caught outside in [[Weather#Evil weather|freakish weather]] in an evil [[biome]]
|rowspan=7| Random
|rowspan=7| Random
|rowspan=7| Random
|-
| evil cloud sickness4
| Being caught in a [[Weather#Evil weather|creeping cloud]] in an evil [[biome]]
|-
| beast sickness5
| Encounters with [[forgotten beast]]s
|-
| titan sickness5
| Encounters with [[titan]]s
|-
| night sickness5
| Encounters with [[nightmare]]s or [[experiment]]s
|-
| demon sickness5
| Encounters with [[demon]]s
|-
| divine sickness5
| Encounters with [[angel]]s
|}
: 1. For small creatures such as humans and dwarves, paralysis tends to result in suffocation.
: 2. Necrosis of the brain will eventually result in death once the brain rots away completely.
: 3. Evil rain typically only causes minor symptoms such as blisters, bruising, coughing blood, dizziness, fever, nausea, oozing, and pain.
: 4. Evil clouds either cause major symptoms (as with beast/titan/demon sicknesses) or permanently transform creatures into [[Undead|zombie-like]] forms.
: 5. [[Titan]]s, [[forgotten beast]]s, [[nightmare]]s, [[experiment]]s, [[demon]]s and [[angel]]s have a chance to have a randomized syndrome. These range from mildly hazardous (mild [[Symptom#Blisters|blisters]] from inhaling boiling blood) to instantly fatal (severe necrosis from a contact poison attached to a breath weapon/creature made of blood).

==The anatomy of a syndrome==
To recap, syndromes are "diseases" which inflict effects upon creatures who acquire them. Mechanically, they're composed of a bunch of different syndrome tokens which detail [[Syndrome#Basic syndrome tokens|how it works]] and [[Syndrome#Creature effect tokens|what it does]]. Syndrome acquisition can be boiled down into two main routes: (1) via materials and (2) via interactions. Unlike most objects in the game, syndromes aren't defined in their own raw file; they're instead built up within the raw definition of the material or interaction effect to which they are tied, as described below.
{{Modding}}
'''1) Transmission via Materials'''
Any material (be it [[Material_token#INORGANIC|inorganic]], [[Material_token#CREATURE_MAT|creature-derived]], or [[Material_token#PLANT_MAT|plant-derived]]) can have one or more syndromes added to it, simply by defining the syndrome within the material's own raw definition. The addition of certain tokens (detailed [[Syndrome#SYN_CONTACT|below]]) to the syndrome will determine what must be done to the material so as to transmit the syndrome to a creature; the current modes of transmission are as follows: [[Syndrome#SYN_CONTACT|bodily contact]] with the material, [[Syndrome#SYN_INGESTED|ingestion]] or [[Syndrome#SYN_INHALED|inhalation]] of the material, or [[Syndrome#SYN_INJECTED|injection]] of the material into the bloodstream. Any combination of transmission modes can be specified per syndrome.

Here's the material definition of [[giant cave spider]] venom with its associated syndrome as an example:

''(See [[Giant cave spider/raw|here]] for the complete creature raw.)''
[USE_MATERIAL_TEMPLATE:POISON:CREATURE_EXTRACT_TEMPLATE]
[STATE_NAME:ALL_SOLID:frozen giant cave spider venom]
[STATE_ADJ:ALL_SOLID:frozen giant cave spider venom]
[STATE_NAME:LIQUID:giant cave spider venom]
[STATE_ADJ:LIQUID:giant cave spider venom]
[STATE_NAME:GAS:boiling giant cave spider venom]
[STATE_ADJ:GAS:boiling giant cave spider venom]
[PREFIX:NONE]
[ENTERS_BLOOD]
'''[SYNDROME]'''
'''[SYN_NAME:giant cave spider bite]'''
'''[SYN_AFFECTED_CLASS:GENERAL_POISON]'''
'''[SYN_IMMUNE_CREATURE:SPIDER_CAVE_GIANT:ALL]'''
'''[SYN_INJECTED]'''
'''[CE_PARALYSIS:SEV:100:PROB:100:RESISTABLE:SIZE_DILUTES:START:5:PEAK:10:END:20]'''

In the above, the non-bolded section consists of various [[material definition token]]s used to define and customise the venom material. (USE_MATERIAL_TEMPLATE defines a material called 'POISON', and creates it using the template 'CREATURE_EXTRACT_TEMPLATE' as a basis, which is then altered by the other tokens placed below it. See [[Material_definition_token#STATE_NAME|STATE_NAME]], [[Material_definition_token#STATE_ADJ|STATE_ADJ]], and [[Material_definition_token#PREFIX|PREFIX]] for more information about these tokens). The relevance of [[Material_definition_token#ENTERS_BLOOD|ENTERS_BLOOD]] in this context is explained below.

The bolded section consists of the syndrome definition, which is initiated using the [[Syndrome#SYNDROME|[SYNDROME]]] token. The tokens placed after this (which are described in further detail [[Syndrome#Basic syndrome tokens|below]]) flesh out the syndrome - in this case they name it "giant cave spider bite", make it work only against creatures belonging to the 'GENERAL_POISON' [[Creature token#CREATURE_CLASS|creature class]], render giant cave spiders immune to it, and cause creatures to contract it if the venom is injected into them. The creature effect at the very bottom makes the syndrome inflict progressive complete paralysis upon the victim after a short delay, for what would be a relatively short-lived period were it not for the fact that most small creatures tend to suffocate before the effect wears off (that, or they get eaten by the giant cave spider that caused it).

Great, so how do we get this lethal venom into a creature's bloodstream to transmit the syndrome? Giant cave spiders are able to do this via the [[Creature token#SPECIALATTACK_INJECT_EXTRACT|SPECIALATTACK_INJECT_EXTRACT]] token appended to their bite attack as such:
[SPECIALATTACK_INJECT_EXTRACT:LOCAL_CREATURE_MAT:POISON:LIQUID:100:100]
This makes their bites inject 100 units of the 'POISON' material in its liquid [[Material_definition_token#Material_States|state]]. Note that '[[Material_token#LOCAL_CREATURE_MAT|LOCAL_CREATURE_MAT]]:POISON' indicates that the 'POISON' material is defined amidst the same creature raws where the attack was detailed i.e. within the SPIDER_CAVE_GIANT creature definition; we could have written '[[Material_token#CREATURE_MAT|CREATURE_MAT]]:SPIDER_CAVE_GIANT:POISON' instead for the same result. Also note that we can make the attack inject any material we want it to, not just creature-associated materials. (Want your spider to inject molten [[gold]] into its victims to melt them from the inside out instead of bothering with syndromes? Simply replace 'LOCAL_CREATURE_MAT:POISON:LIQUID' with '[[Material_token#INORGANIC|INORGANIC]]:GOLD:LIQUID' and you're good to go).

Note that [ENTERS_BLOOD] must be added to the material definition for injection attacks making use of this material to function properly. Without this token, the material would simply [[contaminant|splatter]] over the attacked bodypart instead of entering the bloodstream, so the above syndrome, which relies solely on the [[Syndrome#SYN_INJECTED|injectable]] transmission route, wouldn't be contracted. [ENTERS_BLOOD] can of course be left out intentionally, if the aim is to cover creatures with a material that transmits syndromes [[Syndrome#SYN_CONTACT|on contact]]. Keep in mind that splattering in lieu of injection also occurs with blunt attacks, on attacked body parts devoid of [[Tissue_definition_token#VASCULAR|VASCULAR]] tissue, and on [[Creature token#BLOOD|bloodless]] victims (including creatures who've had their blood removed via [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG:HAS_BLOOD]]).

A fun variation on typical creature venoms is to add a [[Syndrome#SYN_CONTACT|contact-transmissible]] syndrome to the creature's [[Creature token#BLOOD|blood]] material - this tends to end poorly for any predator that chooses to attack them.

'''2) Transmission via Interactions'''

The [[Interaction token|interaction]] system can be used to add syndromes to creatures directly via certain interaction effects, most notably [[Interaction token#I_EFFECT|I_EFFECT:ADD_SYNDROME]]. After placing this I_EFFECT in an interaction definition, the syndrome to be added is defined beneath it in exactly the same manner as that used for the material-bound syndromes described above. (Note that any [[Interaction_token#IE_TARGET|IE_ tokens]] used with this I_EFFECT can be placed before or after the syndrome definition; the order doesn’t really matter). The [[Interaction token#I_EFFECT| ANIMATE]] and [[Interaction token#I_EFFECT| RESURRECT]] interaction effects also allow syndromes to be tied to them in the same manner; in this case the syndrome is applied to the target creature after it is animated or resurrected respectively.

See [[Syndrome#Spreading_diseases|below]] for an example of a syndrome-transmitting interaction.

==Basic syndrome tokens==

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

|-
| {{text anchor|SYNDROME}}
|
| Used to begin defining a new syndrome.

|-
| {{text anchor|SYN_NAME}}
| <your text>
| Used to specify the name of the syndrome as it appears in-game. Names don't have to be unique; it's perfectly acceptable to have multiple syndromes with identical names.

For example, this name is displayed when <nowiki>[</nowiki>[[Syndrome#CE_FEEL_EMOTION|CE_FEEL_EMOTION:<...>]]] causes an emotional reaction {{dftext|Urist is |0:1}}{{dftext|<emotion>|6:0}}{{dftext| due to <your_syn_name>.|0:1}}

|-
| {{text anchor|SYN_CLASS}}
| <your text>
| Can be included to create a syndrome class and assign the syndrome to it, for use with the [[Interaction token#IT_CANNOT_HAVE_SYNDROME_CLASS|IT_CANNOT_HAVE_SYNDROME_CLASS]] interaction token. Can be specified more than once to assign the syndrome to multiple classes. Other syndromes can also be assigned to the same class.

|-
| {{text anchor|SYN_CONTACT}}
|
| If the syndrome is tied to a material, creatures who come into contact with this material will contract the syndrome if this token is included in the syndrome definition. Contact transmission occurs when a creature's body becomes [[contaminant|contaminated]] with the material (visible as [material name] 'smear', 'dusting' or 'covering' over body parts when viewing the creature's inventory). Note that contact with [[item]]s made of a syndrome-inducing material currently doesn't result in transmission.

Methods of getting a material contaminant onto a creature's body include:
* [[Creature token#SECRETION|secretions]]
* [[Interaction_token#LIQUID_GLOB|liquid projectiles]] (contaminate struck body parts if exposed)
* [[Interaction_token#TRAILING_VAPOR_FLOW|vapor]] and [[Interaction_token#TRAILING_DUST_FLOW|dust clouds]] (contaminate all external body parts, even if covered)
* [[Interaction_token#SPATTER_LIQUID|puddles]] and [[Interaction_token#SPATTER_POWDER|dust piles]] ([[Body_token#STANCE|STANCE]] body parts become contaminated if the creature walks into them [[clothing|barefoot]], and all uncovered external body parts are contaminated if the creature is [[Status icon#Non-flashing|prone]])
* [[Interaction_token#WEATHER_FALLING_MATERIAL|freakish rain]] (contaminates all external body parts, even if covered, if the creature is outside)
* unprotected bodily contact with a contaminated creature (including performing or receiving body part attacks such as punches and [[wrestling]] moves, creature collisions, as well as [[Interaction_token#I_EFFECT|CONTACT]] interaction effects, if the involved body parts are exposed)
* items [[Material_definition_token#MELTING_POINT|melting]] whilst equipped or hauled (this contaminates the body part that was holding them if exposed)
* striking the creature's body with a contaminated item (see below)

It is possible to use this token for syndromes intended to be applied via envenomed weapons (but also check out [[Syndrome#SYN_INJECTED|SYN_INJECTED]]). When a creature's body is struck with an item which is contaminated with a contact syndrome-inducing material, the syndrome will be transmitted to the struck creature, even if the attack doesn't pierce the flesh. Syndrome transmission in this context often occurs in the absence of a visible contaminant on the body.

Contact transmission only appears to occur at the moment of contamination (which is to say, when a new bodily spatter is created). If the syndrome ends (once all its [[Syndrome#Creature_effect_tokens|creature effects]] reach their END point, at which point it will be removed from the creature), it will NOT be reapplied by the original syndrome-inducing contaminant (assuming it hasn't been cleaned off yet); the creature will need to be recontaminated with the causative material for this to occur. (Note that in the case of [[Creature token#SECRETION|secretions]], the secreted contaminants are continuously reapplied to the secretory body parts, so any associated short-lasting contact syndromes allowed to target the secreting creature can potentially be reapplied at the rate of secretion; this may work differently in [[adventurer mode]]).

|-
| {{text anchor|SYN_INGESTED}}
|
| If the syndrome is tied to a material, creatures who [[food|eat]] or drink substances comprising, containing or [[contaminant|contaminated]] with this material will contract the syndrome if this token is included. This includes [[kitchen|prepared meals]] when any of the constituent ingredients contains the material in question.

This also applies to [[creature token#GRAZER|grazing]] creatures which happen to munch on a [[plant token#GRASS|grass]] that has an ingestion-triggered syndrome tied to any of its constituent materials.

|-
| {{text anchor|SYN_INHALED}}
|
| If the syndrome is tied to a material, creatures who inhale the material will contract the syndrome if this token is included. Materials can only be inhaled in their [[Material_definition_token#BOILING_POINT|gaseous]] state, which is attainable by [[temperature|boiling]], or in the form of a [[Interaction_token#TRAILING_GAS_FLOW|TRAILING_GAS_FLOW]], [[Interaction_token#UNDIRECTED_GAS|UNDIRECTED_GAS]] or [[Interaction_token#WEATHER_CREEPING_GAS|WEATHER_CREEPING_GAS]]. Creatures can also be made to [[Tissue_definition_token#TISSUE_LEAKS|leak]] [[Tissue_definition_token#TISSUE_MAT_STATE|gaseous tissue]] when damaged.

Note that {{token|AQUATIC|c}} creatures never inhale gaseous materials, and creatures which do breathe air aren't guaranteed to inhale gases when exposed to them for a short time. Contrary to what one might expect, creatures with {{token|NOBREATHE|c}} are in fact capable of contracting inhalation syndromes; this is presumably a bug.

|-
| {{text anchor|SYN_INJECTED}}
|
| If the syndrome is tied to a material, the injection of this material into a creature's bloodstream will cause it to contract the syndrome if this token is included. Injection can be carried out as part of a creature attack via [[Creature_token#SPECIALATTACK_INJECT_EXTRACT|SPECIALATTACK_INJECT_EXTRACT]], or by piercing the flesh of a creature with an [[item]] that has been [[contaminant|contaminated]] with the material. Thus, this token can be used as a more specific alternative to [[Syndrome#SYN_CONTACT|SYN_CONTACT]] for syndromes intended to be administered by envenomed weapons.

For injection to work, the material definition must include [[Material_definition_token#ENTERS_BLOOD|ENTERS_BLOOD]], the attacked body part needs to have [[Tissue_definition_token#VASCULAR|VASCULAR]] tissue, and the intended victim must have [[Creature token#BLOOD|BLOOD]] (so it won't work on creatures with the [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG:HAS_BLOOD]] syndrome effect). Getting the weapon "lodged into the wound" isn't a requirement.

|-
| {{text anchor|SYN_AFFECTED_CLASS}}
| <[[Creature token#CREATURE_CLASS|creature class]]>
| If this is included, only creatures which belong to the specified [[Creature token#CREATURE_CLASS|creature class]] (as well as creatures which pass the [[Syndrome#SYN_AFFECTED_CREATURE|SYN_AFFECTED_CREATURE]] check if this is included) will be able to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures which have at least one matching class will be considered susceptible. If [[Syndrome#SYN_IMMUNE_CLASS|SYN_IMMUNE_CLASS]] and/or [[Syndrome#SYN_IMMUNE_CREATURE|SYN_IMMUNE_CREATURE]] are included, creatures which fail these checks will be unable to contract the syndrome even if they pass this class check.

|-
| {{text anchor|SYN_IMMUNE_CLASS}}
| <[[Creature token#CREATURE_CLASS|creature class]]>
| If this is included, creatures which belong to the specified [[Creature token#CREATURE_CLASS|creature class]] will be unable to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures with at least one matching class will be considered immune (unless overridden by [[Syndrome#SYN_AFFECTED_CREATURE|SYN_AFFECTED_CREATURE]]).

|-
| {{text anchor|SYN_AFFECTED_CREATURE}}
| <creature>:<[[Creature_token#CASTE|caste]]>
| If this is included, only the specified creature (and, if [[Syndrome#SYN_AFFECTED_CLASS|SYN_AFFECTED_CLASS]] is included, also creatures which pass this check as explained above) will be able to contract the syndrome. This token can be used multiple times per syndrome. If used alongside [[Syndrome#SYN_IMMUNE_CLASS|SYN_IMMUNE_CLASS]], the specified creature will be able to contract the syndrome regardless of this class check.

DWARF:FEMALE is an example of a valid <creature>:<caste> combination; "ALL" can be used in place of a specific caste so as to indicate that this applies to all castes of the specified creature.

|-
| {{text anchor|SYN_IMMUNE_CREATURE}}
| <creature>:<[[Creature_token#CASTE|caste]]>
| If this is included, the specified creature will be unable to contract the syndrome (even if it matches [[Syndrome#SYN_AFFECTED_CLASS|SYN_AFFECTED_CLASS]]). It can be specified multiple times per syndrome. As above, "ALL" can be used in place of a specific caste.

|-
| {{text anchor|SYN_NO_HOSPITAL}}
|
| Prevents creatures from being admitted to [[health care|hospital]] for problems arising directly as a result of the syndrome's effects, no matter how bad they get.

|-
| {{text anchor|SYN_IDENTIFIER}}
| <your text>
| This token can be included to give a syndrome an identifier which can be shared between multiple syndromes. Only one identifier may be specified per syndrome.

Syndrome identifiers can be used in conjunction with the [[Creature token#SYNDROME_DILUTION_FACTOR|SYNDROME_DILUTION_FACTOR]] creature token to alter a creature’s innate resistance to the relevant [[Syndrome#Symptomatic effects|effects]] of any syndromes that possess the specified identifier. For example, every [[alcohol|alcoholic beverage]] in unmodded games comes with its own copy of an intoxicating syndrome, each of which has a <code>[SYN_IDENTIFIER:INEBRIATION]</code> token. All [[dwarf|dwarves]] have <code>[SYNDROME_DILUTION_FACTOR:INEBRIATION:150]</code>, which decreases the severity of any effects derived from a syndrome with the INEBRIATION identifier, thus enabling them to better handle all forms of alcohol.

When a creature gets a new syndrome with the same SYN_IDENTIFIER, it merges the effects of the new syndrome into the old one, resetting any overlapping syndrome effects to their PEAK time. If the new one comes with a [[Syndrome#SYN_CONCENTRATION_ADDED|SYN_CONCENTRATION_ADDED]] token, it will additionally adjust the first syndrome's concentration on any overlapping syndrome effects as described below. Taking the above example once again, a sober dwarf drinking their first alcoholic beverage would be exposed to an INEBRIATION syndrome, contracting it and having its effects manifest normally. If the dwarf were to have another drink before the effects of this first syndrome have all worn off (by reaching their [[Syndrome#Creature effect tokens|END]] point), then exposure to the second INEBRIATION syndrome would increase the severity of the original syndrome's effects, making the dwarf progressively more intoxicated, and reset the timer on inebriation to its PEAK.

|-
| {{text anchor|SYN_CONCENTRATION_ADDED}}
| <amount>:<max>
| Syndrome concentration is essentially a quantity which impacts the severity of the syndrome's relevant [[Syndrome#Symptomatic effects|effects]]. The higher the syndrome's concentration, the greater its severity. When a syndrome is contracted, the value specified in <amount> is its initial concentration level.

As described above, if a creature is exposed to a syndrome with a particular [[Syndrome#SYN_IDENTIFIER|SYN_IDENTIFIER]] when already possessing an active syndrome with the same identifier, then this later syndrome isn't contracted, instead contributing to the original syndrome's concentration as indicated by its SYN_CONCENTRATION_ADDED token, if present. The syndrome in question will increase the original syndrome's concentration by <amount> whenever the creature is exposed to it, until its specified <max> concentration is reached by the original syndrome, causing subsequent exposure to this particular syndrome to do nothing (that is, until the original syndrome ends, at which point a new one may be contracted normally). Should the creature be exposed to a different syndrome with the same identifier and a higher <max> value, the concentration will of course increase further.

For example, all forms of [[alcohol]] in the vanilla game have a syndrome with <code>[SYN_IDENTIFIER:INEBRIATION]</code> and <code>[SYN_CONCENTRATION_ADDED:100:1000]</code>. When alcohol is first drunk, the creature contracts the relevant inebriating syndrome at a concentration level of 100. Every subsequent drink will increase the concentration of this first syndrome by a further 100, intensifying its effects, until it plateaus at concentration level 1000. Once all the effects of the original syndrome have ended, the cycle can be started anew (assuming the drinker hasn't died of [[Alcohol#Alcohol_poisoning|alcohol poisoning]] yet). As described by Toady, "Each 100 of <amount> will contribute SEV in general to each effect (before [[Creature token#SYNDROME_DILUTION_FACTOR|dilution]]), <max> goes up to 1000. The concentration does not decrease, but will stay at the maximum attained until the syndrome wears off."

Some of the generated interaction-derived syndromes come with <code>[SYN_CONCENTRATION_ADDED:1000:0]</code>. According to Toady, this "was a precaution after I had one bug with effects not fully manifesting due to low levels. It may not be necessary, but I decided to give everybody a full dose of the juice until I could get a closer look at it." [http://www.bay12forums.com/smf/index.php?topic=169696.msg8083872#msg8083872]
|}

==Creature Effect Tokens==
Each and every syndrome has a number of creature effect tokens, represented by CE_X - these lovely little beauties determine exactly how the poor creature suffering from the syndrome is affected. An example CE token is as follows:

[CE_NECROSIS:SEV:100:PROB:100:LOCALIZED:VASCULAR_ONLY:RESISTABLE:START:50:PEAK:1000:END:2000]

In this example, we have an effect that will always cause severe necrosis in whichever bodypart it touches, so long as that bodypart is vascular and that the creature is not able to resist it in some manner. The effect begins shortly after the syndrome is contracted, peaks 1000 [[time|time units]] afterwards, and finally ceases another 1000 time units later.

As a general rule of thumb, so long as CE_X starts the string and START/(PEAK/END) ends it, the order of the intervening tokens isn't important.

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

|-
| {{text anchor|CE_X}}
|
| The effect type. This can be a number of different tokens, as detailed in the tables that follow this one.

|-
| {{text anchor|SEV}}
| <amount>
| The severity of the effect. Higher values appear to be worse, with SEV:1000 CE_NECROSIS causing a part to near-instantly become rotten. Can go as high as 2147483647, and can be negative.

|-
| {{text anchor|PROB}}
| <amount>
| The probability of the effect actually manifesting in the victim, as a percentage. 100 means always, 1 means a 1 in 100 chance.

|-
| {{text anchor|BP}}
| <body part>:<tissue>
| (Optional; overridden by [[Syndrome#LOCALIZED|LOCALIZED]]) Specifies which body parts and tissues the effect is to be applied to. Not every effect requires a target!

<body part> can be BY_CATEGORY:X to target body parts with a matching [CATEGORY:X] [[body token]] (or ALL to affect everything), BY_TYPE:X to target body parts having a particular type (UPPERBODY, LOWERBODY, HEAD, GRASP, or STANCE), or BY_TOKEN:X to target individual body parts by their ID as specified by the [BP] token of the body plan definition. For example, if you wanted to target the lungs of a creature, you would use BP:BY_CATEGORY:LUNG:ALL. The effect would act on all body parts within the creature with the CATEGORY tag LUNG and affect all tissue layers. For another example, say you wanted to cause the skin to rot off a creature - you could use BP:BY_CATEGORY:ALL:SKIN, targeting the SKIN tissue on all body parts. Multiple targets can be given in one effect by placing the BP tokens end to end. This is one of the most powerful and useful aspects of the syndrome system, as it allows you to selectively target body parts relevant to the contagion, like lungs for coal dust inhalation, or the eyes for exposure to an acid gas.

|-
| {{text anchor|LOCALIZED}}
|
| (Optional; overrides [[Syndrome#BP|BP]] tokens) This tag causes an effect to ignore all BP tokens and then forces the game to attempt to apply the effect to the limb that came into contact with the contagion - i.e. the part that was bitten by the creature injecting the syndrome material, or the one that was splattered by a contact contagion. If an effect can not be applied to the contacted limb (such as IMPAIR_FUNCTION on a non-organ) then this token makes the effect do nothing. This token also makes inhaled syndromes have no effect.

|-
| {{text anchor|VASCULAR_ONLY}}
|
| (Optional) This effect only affects tissue layers with the VASCULAR token.

|-
| {{text anchor|MUSCULAR_ONLY}}
|
| (Optional) This effect only affects tissue layers with the MUSCULAR token.

|-
| {{text anchor|SIZE_DILUTES}}
|
| (Optional) This token presumably causes the severity of the effect to scale with the size of the creature compared to the size of the dose of contagion they received, but has yet to be extensively tested.

|-
| {{text anchor|SIZE_DELAYS}}
|
| (Optional) As above, this token has yet to be tested but presumably delays the onset of an effect according to the size of the victim.

|-
| {{text anchor|CAN_BE_HIDDEN}}
|
| (Optional) Can be hidden by a unit assuming a secret identity, such as a [[vampire]]. {{verify}}

|-
| {{text anchor|RESISTABLE}} (sic)
|
| (Optional) Determines if the effect can be hindered by the target creature's [[Attribute#Disease_resistance|disease resistance attribute]]. Without this token, disease resistance is ignored. (yes, it's spelled incorrectly)

|-
| {{text anchor|DWF_STRETCH}}
| <amount>
| (Optional) Multiplies the duration values of the effect by the specified amount in Fortress mode.

|-
| {{text anchor|ABRUPT_START}}
|
| (Optional) Makes the effect begin immediately rather than ramping up.

|-
| {{text anchor|ABRUPT_END}}
|
| (Optional) Makes the effect end immediately rather than ramping down.

|-
| {{text anchor|ABRUPT}}
|
| (Optional) Combination of ABRUPT_START and ABRUPT_END.

|-
| {{text anchor|START}}
| <time>
| Determines the time after exposure, in ticks, when the effect starts. Required for all effects.

|-
| {{text anchor|PEAK}}
| <time>
| (Optional) Determines the time after exposure, in ticks, when the effect reaches its peak intensity.

|-
| {{text anchor|END}}
| <time>
| (Optional) Determines the time after exposure, in ticks, when the effect ends.
|}

A key point that needs to be understood with regards to damaging syndrome effects such as [[Syndrome#CE_BRUISING|bruising]] is that they deal a quantity of damage (based on the effect's SEV and other modifiers) '''every [[time|tick]]''', and this damage accumulates over time. Thus, even a bruising effect at the lowest possible severity value '''will''' eventually lead to destruction of the affected body part(s) if the effect has a long enough duration. Similarly, [[Syndrome#Healing_Effects|healing effects]] undo a specific amount of damage every tick whilst the effect lasts.

===Symptomatic Effects===

The following table contains [[Syndrome#Creature effect tokens|creature effect tokens]] which cause purely medical [[symptom]]s.

Non-targeted effects will ignore any BP tokens and LOCALIZED tokens.

The details of this table are still being thrashed out by modders, so if you have anything to add, please don't hesitate to hit the edit button!

{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| {{text anchor|CE_BRUISING}}
| Yes
| Causes the targeted body part to undergo bruising.
|-
| {{text anchor|CE_BLISTERS}}
| Yes
| Covers the targeted body part with blisters.
|-
| {{text anchor|CE_OOZING}}
| Yes
| Causes pus to ooze from the afflicted body part.
|-
| {{text anchor|CE_BLEEDING}}
| Yes
| Causes the targeted body part to start bleeding, with heavy enough bleeding resulting in the death of the sufferer. Some conditions seem to cause bleeding to be fatal no matter how weak.
|-
| {{text anchor|CE_SWELLING}}
| Yes
| Causes the targeted body part to swell up. Extreme swelling may lead to necrosis.
|-
| {{text anchor|CE_NECROSIS}}
| Yes
| Causes the targeted body part to rot, with associated tissue damage, miasma emission and bleeding. The victim slowly bleeds to death if the wound is not treated. Badly necrotic limbs will require amputation.
|-
| {{text anchor|CE_NUMBNESS}}
| Optional
| Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage. If no target is specified this applies to all body parts.
|-
| {{text anchor|CE_PAIN}}
| Optional
| Afflicts the targeted body part with intense pain. If no target is specified this applies to all body parts.
|-
| {{text anchor|CE_PARALYSIS}}
| Optional
| Causes complete paralysis of the affected body part. Paralysis on a limb may lead to motor nerve damage. If no target is specified this causes total paralysis, which can lead to suffocation of smaller creatures.
|-
| {{text anchor|CE_IMPAIR_FUNCTION}}
| Yes
| An organ afflicted with this effect is rendered inoperable - for example, if both lungs are impaired the creature can't breathe and will suffocate. This token only affects organs, not limbs. Note that this effect is currently bugged, and will not "turn off" until the creature receives a wound to cause its body parts to update.
|-
| {{text anchor|CE_DIZZINESS}}
| No
| Inflicts the Dizziness condition, occasional fainting and a general slowdown in movement and work speed.
|-
| {{text anchor|CE_DROWSINESS}}
| No
| Causes the Drowsiness condition.
|-
| {{text anchor|CE_UNCONSCIOUSNESS}}
| No
| Renders the creature unconscious.
|-
| {{text anchor|CE_FEVER}}
| No
| Causes the Fever condition.
|-
| {{text anchor|CE_NAUSEA}}
| No
| Causes the Nausea condition, and heavy vomiting. Can eventually lead to dehydration and death.
|-
| {{text anchor|CE_COUGH_BLOOD}}
| No
| This effect results in the sufferer periodically coughing blood, which stains the tile they're on and requires cleanup. It doesn't appear to be lethal, but may cause minor bleeding damage.
|-
| {{text anchor|CE_VOMIT_BLOOD}}
| No
| This effect results in the sufferer periodically vomiting blood, which stains the tile they're on and requires cleanup. It doesn't appear to be lethal, but may cause minor bleeding damage.
|}

===Healing Effects===
Most of the [[Syndrome#Symptomatic_Effects|above]] effects have counterparts to alleviate [[symptom]]s and heal physical damage:
{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| {{text anchor|CE_REDUCE_PAIN}}
| Yes
| Decreases the severity of pain produced by wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the pain is decreased.
|-
| {{text anchor|CE_REDUCE_SWELLING}}
| Yes
| Decreases the severity of swelling on the targeted body part.
|-
| {{text anchor|CE_REDUCE_PARALYSIS}}
| Yes
| Decreases the severity of any paralysis effects on the targeted body part.
|-
| {{text anchor|CE_REDUCE_DIZZINESS}}
| No
| Decreases the severity of any dizziness the creature has.
|-
| {{text anchor|CE_REDUCE_NAUSEA}}
| No
| Decreases the severity of any nausea the creature has.
|-
| {{text anchor|CE_REDUCE_FEVER}}
| No
| Decreases the severity of any fever the creature has.
|-
| {{text anchor|CE_STOP_BLEEDING}}
| Yes
| Decreases the severity of the bleeding of any wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the bleeding is decreased.
|-
| {{text anchor|CE_CLOSE_OPEN_WOUNDS}}
| Yes
| Closes any wounds on the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_CURE_INFECTION}}
| Yes?
| Probably decreases the severity of the infection from infected wounds over time.
|-
| {{text anchor|CE_HEAL_TISSUES}}
| Yes
| Heals the tissues of the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_HEAL_NERVES}}
| Yes
| Heals the nerves of the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_REGROW_PARTS}}
| Yes
| Causes missing body parts to regrow. SEV controls how quickly body parts are regrown. In adventure, parts may be lost again once you travel or wait/sleep {{bug|0011396}}.
|}

===Special Effects===
Several special syndrome effects take different arguments than the above. These are used for generated interactions in unmodded games, but may be used as well for any custom substance or interaction. CE_FEEL_EMOTION is the only one of these that takes SEV.

{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Arguments
! Description
|-
| {{text anchor|CE_ADD_TAG}}
| No
| <tag 1>:<tag 2>:etc
| Adds the specified tag(s) to the affected creature. Multiple tags can be specified sequentially within a single effect token. Valid tags:

'''Special tags:'''

*NO_AGING
Halts the creature's aging process and prevents [[Creature token#MAXAGE|death by old age]].

*STERILE
Makes the creature unable to produce [[children|offspring]].

*HAS_BLOOD
*MORTAL
*FIT_FOR_ANIMATION
*FIT_FOR_RESURRECTION
Adding these tags to a creature doesn't appear to do anything.

'''Creature tokens:'''

*[[Creature_token#BLOODSUCKER|BLOODSUCKER]]
*[[Creature_token#CAN_LEARN|CAN_LEARN]]
*[[Creature_token#CAN_SPEAK|CAN_SPEAK]]
*[[Creature_token#CRAZED|CRAZED]]
*[[Creature_token#EXTRAVISION|EXTRAVISION]]
*[[Creature_token#MISCHIEVOUS|MISCHIEVOUS]] (or [[Creature_token#MISCHIEVIOUS|MISCHIEVIOUS]])
*[[Creature_token#NO_CONNECTIONS_FOR_MOVEMENT|NO_CONNECTIONS_FOR_MOVEMENT]]
*[[Creature_token#NO_DIZZINESS|NO_DIZZINESS]]
*[[Creature_token#NO_DRINK|NO_DRINK]]
*[[Creature_token#NO_EAT|NO_EAT]]
*[[Creature_token#NO_FEVERS|NO_FEVERS]]
*[[Creature_token#NO_PHYS_ATT_GAIN|NO_PHYS_ATT_GAIN]]
*[[Creature_token#NO_PHYS_ATT_RUST|NO_PHYS_ATT_RUST]]
*[[Creature_token#NO_SLEEP|NO_SLEEP]]
*[[Creature_token#NO_THOUGHT_CENTER_FOR_MOVEMENT|NO_THOUGHT_CENTER_FOR_MOVEMENT]]
*[[Creature_token#NOBREATHE|NOBREATHE]]
*[[Creature_token#NOEMOTION|NOEMOTION]]
*[[Creature_token#NOEXERT|NOEXERT]]
*[[Creature_token#NOFEAR|NOFEAR]]
*[[Creature_token#NONAUSEA|NONAUSEA]]
*[[Creature_token#NOPAIN|NOPAIN]]
*[[Creature_token#NOSTUN|NOSTUN]]
*[[Creature_token#NOT_LIVING|NOT_LIVING]]
*[[Creature_token#NOTHOUGHT|NOTHOUGHT]]
*[[Creature_token#OPPOSED_TO_LIFE|OPPOSED_TO_LIFE]]
*[[Creature_token#PARALYZEIMMUNE|PARALYZEIMMUNE]]
*[[Creature_token#SUPERNATURAL|SUPERNATURAL]]
*[[Creature_token#TRANCES|TRANCES]]
*[[Creature_token#UTTERANCES|UTTERANCES]]
*[[Creature_token#NIGHT_CREATURE_EXPERIMENTER|NIGHT_CREATURE_EXPERIMENTER]]

Adding tags will cause the creature to pass/fail any relevant <code>[[Interaction token#IT_REQUIRES|IT_REQUIRES]]</code>/<code>[[Interaction_token#IT_FORBIDDEN|IT_FORBIDDEN]]</code> checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION). Note that [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG]] overrides this effect.

|-
| {{text anchor|CE_REMOVE_TAG}}
| No
| <tag 1>:<tag 2>:etc
| Removes the specified tag(s) from the affected creature. Multiple tags can be specified sequentially within a single effect token. The tags listed [[Syndrome#CE_ADD_TAG|above]] can all be removed via this effect.

If a particular tag is targeted by both CE_REMOVE_TAG and [[Syndrome#CE_ADD_TAG|CE_ADD_TAG]], and both effects are active simultaneously, CE_REMOVE_TAG takes precedence (i.e. the overall effect is that of tag removal for as long as CE_REMOVE_TAG remains active). The order in which the effects activate doesn't affect this, not even if CE_ADD_TAG is added later/earlier via a different syndrome.

Removing tags will cause the creature to fail/pass any relevant <code>[[Interaction token#IT_REQUIRES|IT_REQUIRES]]</code>/<code>[[Interaction_token#IT_FORBIDDEN|IT_FORBIDDEN]]</code> checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION).

'''Special tags:'''

* HAS_BLOOD
If this tag is removed, the creature behaves as though it has no [[Creature token#BLOOD|blood]]; it doesn't bleed when [[Tissue definition token#VASCULAR|VASCULAR]] tissues are damaged (and thus cannot die of blood loss), and substances cannot be [[Syndrome#SYN_INJECTED|injected]] into it.

* NO_AGING
* STERILE
Removing these tags doesn't appear to do anything unless they've been added to a creature via [[Syndrome#CE_ADD_TAG|CE_ADD_TAG]], in which case their effects will be negated as described above.

* MORTAL
* FIT_FOR_ANIMATION
* FIT_FOR_RESURRECTION
Removing these tags doesn't appear to do anything.

|- a
| {{text anchor|CE_DISPLAY_NAME}}
| No
| NAME:singular:plural:adjective
| Attaches the specified name to the creature's normal name.

|-
| {{text anchor|CE_DISPLAY_TILE}}
| No
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Causes the creature to display the specified tile instead of its normal one.

|-
| {{text anchor|CE_FLASH_TILE}}
| No
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]:FREQUENCY:<frames default tile>:<frames syndrome tile>
| Causes the creature to flash between its normal tile and the one specified here.

|-
| {{text anchor|CE_PHYS_ATT_CHANGE}}
| No
| [[Attribute]]:percentage:fixed boost(?)
| Alters the creature's specified [[Attribute#Body_attributes|physical attribute]].

|-
| {{text anchor|CE_MENT_ATT_CHANGE}}
| No
| [[Attribute]]:percentage:fixed boost(?)
| Alters the creature's specified [[Attribute#Soul_attributes|mental attribute]].

|-
| {{text anchor|CE_SPEED_CHANGE}}
| No
| speed modifier:number
| Changes the creature's speed.
Speed modifier contains one or both of:
* SPEED_PERC:percentage (this modifies a creature's in-game speed, so higher numbers are faster)
* SPEED_ADD:number (this modifies a creature's [SPEED:XX] token, so higher numbers are slower. Negative numbers are accepted though will only reduce a creature's speed to zero)
The minimum and maximum speeds able to be created by CE_SPEED_CHANGE are 99 and 10,000 respectively.

|-
| {{text anchor|CE_SKILL_ROLL_ADJUST}}
| No
| PERC:percentage:PERC_ON:percentage
| Alters the creature's specified{{verify}} skill level. The argument PERC specifies a percentage of the creature's current skill, and PERC_ON the probability of the effect being applied on a particular roll.
e.g. This causes a 20% chance of any skill roll being 0 (multiplies the current skill level by 0/100) instead of the normal result
[CE_SKILL_ROLL_ADJUST:PROB:100:PERC:0:PERC_ON:20:START:0]

|-
| {{text anchor|CE_BODY_APPEARANCE_MODIFIER}}
| No
| APPEARANCE_MODIFIER:HEIGHT/LENGTH/BROADNESS:percentage(?)
| Alters the size of the creature.

|-
| {{text anchor|CE_BP_APPEARANCE_MODIFIER}}
| Yes
| body part:APPEARANCE_MODIFIER:attribute:number
| Alters the characteristics (height, width etc.) of a body part. "body part" here can either be BP, followed by the usual BY_CATEGORY etc., or TL, followed by the usual selection for SELECT_TISSUE_LAYER.

|-
| {{text anchor|CE_BODY_TRANSFORMATION}}
| No
|
| Makes the affected unit transform into a different creature. The target creature may either be specified directly by following this with a CE:CREATURE token, or else set to be randomly selected as indicated by the additional tokens listed below (of which multiple may be specified).

Note that transformation into or out of the target form causes the creature to drop all items in its inventory and instantly heals all of its wounds. If an [[undead]] limb happens to be transformed, its entire body will regenerate upon transforming back.

Transformation will also re-roll a creature's age to somewhere within the new form's adult age range. This prevents a 70 year old dwarf from dying the moment it turns into a bat ([[Creature token#MAXAGE|max age]] of 3). If it remains stuck as a bat for (at most) three consecutive years it will die of old age as a bat before the syndrome is able to wear off.

A transformed creature generally retains its previous group and civilization membership (unless it becomes [[Creature token#OPPOSED_TO_LIFE|OPPOSED_TO_LIFE]] for example). A transformed dwarf will remain a member of your fortress (and may still hold or gain [[Noble|positions]]), a transformed trader will hang out at the trade depot and eventually leave along with its fellow traders, and a transformed goblin will continue sieging your fortress with its fellow siege members.

A transformed diplomat (like a trade liaison or expedition leader) will still be able to conduct diplomatic meetings even if they no longer [[Creature token#CAN_SPEAK|CAN_SPEAK]].

Transformed creatures can be trained and adopted following the usual rules. However note that if a transformed creature is a member of your fortress then [[Animal Training|animal trainers]] will not attempt to train it.

A transformed creature can produce offspring with creatures of the species it has transformed into and will follow that creature's normal rules for reproduction.

[[Butcher#Butchering|Butchering]] a transformed creature may produce an odd mix of products. For example, if Urist the dwarf is transformed into a [[Cow|bull]] and then is led to the butcher's block for slaughter the resulting products will contain some bull creature parts like "Urist's horn", "Urist's hoof", and "Urist's skin" (which becomes "cow leather" when [[Tanner|tanned]]) but will also contain some dwarf creature parts like "dwarf meat", "dwarf eye", and "dwarf brain".

'''Specific transformation:'''

* '''CE:CREATURE:'''<creature>:<caste> 
This can be used to specify a target creature to transform into ([CE:CREATURE:DWARF:FEMALE], for example). '''ALL''' or '''ANY''' can be used in place of a specific caste to randomise this for every transformation.
Do note that using '''ALL''' or '''ANY''' for transformation castes will make the creature transform over and over again with the interval depending on the '''START''' token. This can lead to an unending transformation loop. [[Syndrome#looping_problem|However, there is a way to get around this.]]

'''Random transformation:'''

* '''CE:CREATURE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|creature flag]]> 
Narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]]. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.

* '''CE:FORBIDDEN_CREATURE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|creature flag]]> 
Excludes creatures with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.

* '''CE:CREATURE_CASTE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|caste flag]]> 
Narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.

* '''CE:FORBIDDEN_CREATURE_CASTE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|caste flag]]> 
Excludes any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]] from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.

*'''CE:HAVE_FAST_EFFORTLESS_GAIT_SPEED:'''<minimum [[Gait#Speed|gait speed]]> 
Narrows down the selection to creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] less than or equal to the specified <minimum gait speed> ("less than" because lower is faster in the scale used for [[Gait#Speed|gait speed]]). This is used in generated [[Die#Adventurer_Mode|divination curses]] to prevent the player from being transformed into a creature that is frustratingly slow to play as. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

*'''CE:ALL_SLOW_EFFORTLESS_GAIT_SPEED:'''<maximum [[Gait#Speed|gait speed]]> 
Excludes any creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] value less than or equal to the specified <maximum gait speed> (note that larger values are slower in the scale used for [[Gait#Speed|gait speed]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

|-
| {{text anchor|CE_MATERIAL_FORCE_MULTIPLIER}}
| No
| MAT_MULT:[[material token|<material token>]]:<value A>:<value B>
| When the affected creature is 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. '''NONE:NONE''' can be used in place of a specific material token so as to make the effect applicable to all materials. Note that this syndrome effect is equivalent to the [[Creature_token#MATERIAL_FORCE_MULTIPLIER|MATERIAL_FORCE_MULTIPLIER]] creature token.

|-
| {{text anchor|CE_CAN_DO_INTERACTION}}
| No
|
| Makes the creature able to perform an [[Interaction_token|interaction]]. Follow this effect token with [[Interaction_token#INTERACTION|[CDI:INTERACTION:<interaction name>]]] to specify the desired interaction, and add other [[Interaction_token#Usage|CDI tokens]] as required.
|-
| {{text anchor|CE_SPECIAL_ATTACK_INTERACTION}}
| Yes
| INTERACTION:<interaction name>:BP:<selection criteria>:<name of category,type, or token of designated part/parts>
| Makes the creature able to perform an interaction when using an attack with a designated body part/parts. See [[#In 0.47.01|below]] for an example

|-
| {{text anchor|CE_BODY_MAT_INTERACTION}}
| No
| MAT_TOKEN:<body material token>
| This is used to tie an [[Interaction_token|interaction]] to one of the creature’s body materials. Generated [[vampire]] syndromes use this effect to make vampire blood pass on the vampirism curse when consumed.

The target body material is specified by inserting its ID as defined in the creature raws. For example, when a syndrome with “CE_BODY_MAT_INTERACTION:MAT_TOKEN:SWEAT” is gained by a unit, the effect will apply to any material defined as “SWEAT” in the creature raws of that unit, if such a material is present.
'''RESERVED_BLOOD''' is a special body material token which can be used to specify the [[Creature_token#BLOOD|[BLOOD]]] material of any creature, regardless of the material's actual ID.

The following tokens should be placed after this effect:
* '''CE:SYNDROME_TAG:'''<transmission method> is used to specify what must be done with the body material to trigger the interaction. Replace "<transmission method>" with any of '''[[Syndrome#SYN_INGESTED|SYN_INGESTED]], [[Syndrome#SYN_INJECTED|SYN_INJECTED]], [[Syndrome#SYN_CONTACT|SYN_CONTACT]], [[Syndrome#SYN_INHALED|SYN_INHALED]]'''. Multiple instances of this tag may be used to specify different valid transmission routes. ''However, SYN_INGESTED appears to be the only one that works at present.''
* '''CE:INTERACTION:'''<[[Interaction_token#INTERACTION|interaction ID]]> is used to specify which interaction is to be run (replace "<interaction ID>" with the name of the desired interaction). Appropriate interaction effects with a creature target (such as [[Interaction_token#I_EFFECT|ADD_SYNDROME]]) will be inflicted upon the unit who interacts with the body material as specified above. Note that the linked interaction must have an [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]] token for this to work.

This currently only works on materials obtained from historical figures. That is to say, the material must bear the source unit's name, such as "Urist McVampire's dwarf blood" as opposed to mere "dwarf blood".

|-
| {{text anchor|CE_SENSE_CREATURE_CLASS}}
| No
| CLASS:<[[Creature_token#CREATURE_CLASS|creature class]]>:
[[Tilesets|<tile value or character>]]:
[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Provides the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when such creatures 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|CE_FEEL_EMOTION}}
| No
| EMOTION:<[[emotion]]>
| Makes the creature feel a specific [[emotion]]. The effect's SEV value determines how intense the emotion is. The creature also receives a [[thought]] in the following format: "[creature] feels [emotion] due to [[Syndrome#SYN_NAME|[syndrome name]]]". See [[Emotion]] for the list of valid emotions.

|-
| {{text anchor|CE_CHANGE_PERSONALITY}}
| No
| FACET:<[[DF2014:Personality_trait#Facets|personality trait]]>:<amount>
| Changes a [[personality trait]] by the given amount. Multiple FACET:<trait>:<amount> sets may be used, and <amount> can be negative. For example, generated [[necromancer]] syndromes come with the following effect: 
<code>[CE_CHANGE_PERSONALITY:FACET:ANXIETY_PROPENSITY:50:FACET:TRUST:-50:START:0:ABRUPT]</code>

According to Toady, CE_CHANGE_PERSONALITY effects can cause creatures to re-evaluate their [[Personality_trait#Goals|goals]] in worldgen; the boost to anxiety and distrust given to necromancers makes it more likely for them to develop the goal of [[Personality_trait#RULE_THE_WORLD|ruling the world]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8275328#msg8275328]

|-
| {{text anchor|CE_ERRATIC_BEHAVIOR}}
| No
|
| Causes erratic behavior, meaning "People that [[Personality_trait#VIOLENT|like to brawl]] have a chance of starting a brawl-level fight with any nearby adult." [http://www.bay12forums.com/smf//index.php?topic=159164.msg7632503#msg7632503 -Toady]
|}

'''All''' creature effect tokens take START, END and PROB numbers, and can be followed by [CE:PERIODIC] and/or [CE:COUNTER_TRIGGER] to restrict when they actually take effect.

===Periodic Triggers===

'''[CE:{{text anchor|PERIODIC}}:<period_type>:<min_value>:<max_value>]'''

When this token is placed after a syndrome effect, it will prevent that effect from working unless within the specified period range.

For example, generated [[werebeast]] syndromes have a [[Syndrome#CE_BODY_TRANSFORMATION|body transformation effect]] with <code>[CE:PERIODIC:[[Syndrome#MOON_PHASE|MOON_PHASE]]:27:0]</code>, which makes the transformation active only throughout moon phases 27 to 0 (the full moon period). Once the moon phase changes from 0 to 1, the transformation will end and remain inactive until phase 27 is reached again (unless of course the effect has an END time which is reached before this happens. On that note, keep in mind that the START time of the effect needs to have been reached for activation to have become possible).

Only one periodic trigger may currently be specified per effect. [[Syndrome#Counter_Triggers|Counter triggers]] can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have its conditions met for the effect to be allowed to work.

MOON_PHASE is currently the only valid period type:

{| {{prettytable}}
|- bgcolor="Bisque"
! Period
! Description
|-
| {{text anchor|MOON_PHASE}}
| The lunar cycle in ''Dwarf Fortress'' is composed of 28 segments (each slightly shorter than a [[time|day]] in duration), with each segment represented by a value ranging from 0 to 27. These correspond to moon phases as follows:
* '''0''' = full moon
* '''1-4''' = waning gibbous
* '''5-8''' = waning half
* '''9-12''' = waning crescent
* '''13-14''' = new moon
* '''15-18''' = waxing crescent
* '''19-22''' = waxing half
* '''23-26''' = waxing gibbous
* '''27''' = full moon
|}

===Counter Triggers===

'''[CE:{{text anchor|COUNTER_TRIGGER}}:<counter_name>:<min_value>:<max_value>:REQUIRED]'''

Creatures in ''Dwarf Fortress'' possess internal counters which keep track of their various activities and statuses. When this token is placed after a syndrome effect, it will prevent the effect from working unless the affected creature has the indicated counter, and its value lies within the specified range.

For example, generated [[vampire]] syndromes use <code>[CE:COUNTER_TRIGGER:[[Syndrome#DRINKING_BLOOD|DRINKING_BLOOD]]:1:NONE:REQUIRED]</code> with an [[Syndrome#CE_BP_APPEARANCE_MODIFIER|appearance modifier]] to make the vampire's teeth temporarily lengthen whilst leeching blood.

Note that <code>NONE</code> can be used in place of <max_value> to indicate that any value above <min_value> is valid. <code>NONE</code> can also be used in place of <min_value>, which is equivalent to the lowest value attainable by a counter.

<code>REQUIRED</code> implies that the effect won't proceed if the counter exists but doesn't lie within the range provided. However, it's actually redunant as COUNTER_TRIGGER always checks for both of these conditions [http://www.bay12forums.com/smf/index.php?topic=169696.msg8173424#msg8173424]; replacing it with <code>NONE</code> doesn't alter the way the trigger functions, though it ''will'' fail to work if this slot is left empty instead.

As detailed below, most counters only exist temporarily, so their use as triggers is somewhat more restricted than intuition suggests. For example, specifying <code>0</code> or <code>NONE</code> as the <min_value> for a [[Syndrome#CAVE_ADAPT|CAVE_ADAPT]] trigger wouldn't permit the effect to work when the affected creature is outside, since this counter is removed from the unit as soon as its value decreases past 1. Similarly, [[Syndrome#MILK_COUNTER|MILK_COUNTER]] is only present for some time ''after'' a creature is milked.

Multiple counter triggers can be specified per effect, in which case the effect will be permitted to work if at least one of the trigger conditions is met. A [[Syndrome#Periodic_Triggers|periodic trigger]] can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have their conditions met for the effect to work.

The following is a list of valid counter types including a couple of notable values:

{| {{prettytable}}
|- bgcolor="Bisque"
! Counter
! Description

|-
| {{text anchor|ALCOHOLIC}}
| For {{token|ALCOHOL_DEPENDENT|c}} creatures, this counter increases by 1 each [[time|tick]], and is reset to 0 when the creature drinks [[alcohol]]. The following messages are added after "needs alcohol to get through the working day" in the creature's description when the counter reaches the specified values:
* 100800 (3 months) = and is starting to work slowly due to its scarcity
* 201600 (6 months) = and really wants a drink
* 302400 (9 months) = and has gone without a drink for far, far too long
* 403200 (1 year) = and can't even remember the last time (s)he had some

|-
| {{text anchor|CAVE_ADAPT}}
| For creatures with the {{token|CAVE_ADAPT|c}} token, this counter is created and increases by 1 each [[time|tick]] when the creature is in the {{DFtext|Dark|0:1}}, and decreases by 10 each tick when {{DFtext|Outside|3:1}}. The counter is removed if it decreases to 0. See [[cave adaptation]] for more information.
* 403200 (1 year) = going outside causes irritation
* 604800 (1.5 years) = going outside causes nausea

|-
| {{text anchor|MILK_COUNTER}}
| When a creature is milked, this counter is created and set to the frequency value specified in the creature's {{token|MILKABLE|c}} token, and subsequently decreases by 1 each [[time|tick]] until it reaches 0, at which point it is immediately removed, making the creature available for milking again.

|-
| {{text anchor|EGG_SPENT}}
| This counter is created and set to 100800 (3 months' worth of [[time|tick]]s in fortress mode) when a creature [[Creature_token#LAYS_EGGS|lays eggs]], and thereafter decreases by 1 each tick until it reaches 0, at which point it is removed and the creature regains the ability to lay eggs.

|-
| {{text anchor|GROUNDED_ANIMAL_ANGER}}
| How angry (and likely to attack) an animal is from being in an overcrowded location. The counter is created and set to 200 when the animal is forced to lie on the ground whilst sharing a tile with another creature. It subsequently decreases by 1 each [[time|tick]], but this is overcome by the addition of 200 every so often (with a variable delay between each spike) if the creature remains grounded. The counter is removed if it decreases to 0.

|-
| {{text anchor|TIME_SINCE_SUCKED_BLOOD}}
| This counter rises by 1 every [[time|tick]] for creatures with the {{token|BLOODSUCKER|c}} token. When it rises high enough (generally around 100800; 3 months in fortress mode time), the creature will seek an [[sleep|unconscious]] victim to leech off of. Blood-sucking causes the counter to decrease, and will continue until either the victim is dead or the counter reaches 0. Note that this counter isn't removed when 0 is reached.

When playing as a bloodsucker in [[adventure mode]], the following bloodthirst indicators are displayed when this counter reaches the specified values:
* 172800 (1 day in adventure mode time) = {{DFtext|Thirsty|4:0}}
* 1209600 (1 week) = {{DFtext|Thirsty!|4:1}}
* 2419200 (2 weeks) = {{DFtext|Thirsty!|5:1}}
Various penalties are applied as bloodthirst increases; see the [[vampire]] article for more information.

|-
| {{text anchor|DRINKING_BLOOD}}
| This appears to be created and set to a fixed value of 20 whilst the creature is sucking blood, and begins to decrease by 1 each [[time|tick]] once blood-sucking ceases (as described [[Syndrome#TIME_SINCE_SUCKED_BLOOD|above]]) until it reaches 0, at which point the counter is removed.

|}

{{mod}}

==Inorganic syndromes and you!==
It's perfectly possible - and quite simple - to add a nasty syndrome to a type of rock or metal - you simply add the syndrome tokens to the material definition in the same manner that you would add them to a creature material definition. The only catch is that since your hapless dwarves will only normally encounter the material in metal, gem or boulder form, a bit of creativity must be used to actually get them inside your citizens - that is, you need to make them 'explosively boil' as soon as they're mined or produced. This has the sad side effect of destroying the actual item - sorry, no highly radioactive uranium this release.

The easiest way to accomplish this is to assign the material a low boiling point, usually just under room temperature, and make sure its temperature is fixed to a point above it.
[MELTING_POINT:NONE]
[BOILING_POINT:10000]
[MAT_FIXED_TEMP:10001]
[SPEC_HEAT:1]
Now, as soon as this substance hits the open air - by being mined, smelted or reaction-produced at a custom workshop - it will EXPLOSIVELY BOIL, flooding a small area with delicious syndrome-rich gas. Creatures who inhale the gas will be immediately hit with the [[Syndrome#SYN_INHALED|SYN_INHALED]] syndrome you thoughtfully attached to the material definition earlier! Note that creatures do not need to inhale every tick, so there is a chance that the gas will dissipate before it can infect any particular creature.

There are a number of other tokens you can use to control the colour and naming conventions of your syndrome material, referred to as [[material definition token]]s.

==Spreading diseases==
It's fully possible to make a nasty disease capable of spreading itself from an infected dwarf to others, though it requires some skill in modding [[interaction token|interactions]] as well. Here is an example of a plague-inflicting interaction:

[INTERACTION:PLAGUE]
[I_TARGET:A:CREATURE]
[IT_LOCATION:CONTEXT_CREATURE]
[IT_FORBIDDEN:NOT_LIVING]
[IT_AFFECTED_CLASS:GENERAL_POISON]
[IT_MANUAL_INPUT:creatures]
[I_EFFECT:ADD_SYNDROME]
[IE_TARGET:A]
[IE_IMMEDIATE]
[SYNDROME]
[SYN_NAME:the plague]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[CE_FEVER:SEV:250:PROB:100:START:250:PEAK:1500:END:25000]
[CE_BLISTERS:SEV:325:PROB:100:BP:BY_CATEGORY:ALL:SKIN:START:250:PEAK:1500:END:25000]
[CE_NECROSIS:SEV:300:PROB:100:BP:BY_CATEGORY:ALL:ALL:VASCULAR_ONLY:START:22500:PEAK:23750:END:25000]
[CE_CAN_DO_INTERACTION:START:1500:END:25000]
[CDI:ADV_NAME:Spread the plague]
[CDI:INTERACTION:PLAGUE]
[CDI:TARGET:A:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:A:10]
[CDI:WAIT_PERIOD:30]

As you can see, the syndrome here inflicts blisters, fever and, after roughly a month, necrosis of the whole body - that's when the infected creatures will start dying out. But before that happens, CE_CAN_DO_INTERACTION makes them capable of spreading the plague further.

You also need a disease vector that will bring the plague straight to your fort. (hint: use [[large rat|various]] [[rat man|species]] [[giant rat|of rats]] - they're perfect for that). The following code, added to a creature's raws, ensures the creature will infect anybody it encounters:

[CAN_DO_INTERACTION:PLAGUE]
[CDI:ADV_NAME:Spread the plague]
[CDI:TARGET:A:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:A:10]
[CDI:WAIT_PERIOD:30]

As soon as the said creature is startled by your dwarves, the [[fun]] will begin.

===In 0.47.01===
As of version 0.47.01, it may be possible to use a creature's established methods of attack for use in disease-spreading.

Let's use the borrowed example of the plague above. This time, the plague will spread through biting, using the following syndrome code:

[INTERACTION:PLAGUE]
[I_TARGET:A:CREATURE]
[IT_LOCATION:CONTEXT_CREATURE]
[IT_FORBIDDEN:NOT_LIVING]
[IT_AFFECTED_CLASS:GENERAL_POISON]
[IT_MANUAL_INPUT:creatures]
[I_EFFECT:ADD_SYNDROME]
[IE_TARGET:A]
[IE_IMMEDIATE]
[SYNDROME]
[SYN_NAME:the plague]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[CE_FEVER:SEV:250:PROB:100:START:250:PEAK:1500:END:25000]
[CE_BLISTERS:SEV:325:PROB:100:BP:BY_CATEGORY:ALL:SKIN:START:250:PEAK:1500:END:25000]
[CE_NECROSIS:SEV:300:PROB:100:BP:BY_CATEGORY:ALL:ALL:VASCULAR_ONLY:START:22500:PEAK:23750:END:25000]
[CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:PLAGUE:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT]

The line [CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:BITE_PLAGUE:BP:BY_CATEGORY:MOUTH:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT] allows any infected creature with an attack using mouth or tooth category body parts to immediately spread the disease using said attack. The victim of the attack may then spread the disease if they are able to attack with the needed body part/parts.

==Multi-caste/multi-creature body transformations==
This is a way to get around the {{text anchor|looping problem}} when using ANY or ALL castes for [[Syndrome#CE_BODY_TRANSFORMATION|CE_BODY_TRANSFORMATION]] and not being limited to a single creature for transformations. It's an incredibly simple solution as you can see in this example code:
{{code|code=
[SYNDROME]
[SYN_NAME:draconic curse]
[SYN_CLASS:DRACONIC_CURSE]
[CE_BODY_TRANSFORMATION:PROB:25:START:0]
[CE:CREATURE:HYDRA:MALE]
[CE_BODY_TRANSFORMATION:PROB:25:START:0]
[CE:CREATURE:DRAGON:MALE]
[CE_BODY_TRANSFORMATION:PROB:25:START:0]
[CE:CREATURE:HYDRA:FEMALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:0]
[CE:CREATURE:DRAGON:FEMALE]
}}
This code will transform a creature into either a female/male [[hydra]] or a female/male [[dragon]].

For every caste/creature you want a ''victim'' to transform into, you add a [CE_BODY_TRANSFORMATION] token with a [PROB] token attached to it. For most of the transformations the PROB is set to ``1/number_of_transformations * 100`` (or a different number if you want uneven odds), but the final transformation needs a PROB of 100 to ensure there is always at least one transformation chosen. A creature can only have one active transformation at a time. If any of the lower PROB transformations occurs then the PROB 100 transformation can not happen.

If you instead want a ''sequence'' of transformations to take place then you need make sure that one transformation ends on the same tick that the next one begins:
{{code|code=
[SYNDROME]
[SYN_NAME:draconic sequence curse]
[SYN_CLASS:DRACONIC_SEQUENCE_CURSE]
[CE_BODY_TRANSFORMATION:PROB:100:START:0:END:10]
[CE:CREATURE:HYDRA:MALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:10:END:20]
[CE:CREATURE:DRAGON:MALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:20:END:30]
[CE:CREATURE:HYDRA:FEMALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:30:END:40]
[CE:CREATURE:DRAGON:FEMALE]
}}

==See also==

* [[Syndrome examples]]
* [[Interaction token]]
* [[Modding]]

{{Category|Modding}}
{{Category|Creature attributes}}
{{Category|Tokens}}
[[ru:DF2012:Syndrome]]

Wood cutter

2024-04-20T07:07:22Z

Putnam3145:

{{migrated article}}
{{Quality|Unrated}}
{{v50_skill
| color = 6:1
| graphic = [[File:woodcutter_sprite_preview.png]]
| skill = Wood Cutter
| specialty = Woodcutter
| profession = [[Woodworker]]
| job name = Wood Cutting
| tasks =
* Chop down trees
| workshop =
* None, but needs [[axe]]
| attributes =
* Strength
* Agility
* Endurance
* Willpower
* Spatial Sense
* Kinesthetic Sense
}}
{{av}}

'''Wood Cutter''' is a [[skill]] that allows a dwarf to chop down [[tree]]s with an [[axe]], turning them into [[wood]] logs. As wood is an essential resource, this is an important skill. As with other skills, it's developed with practice. Higher levels of the skill make felling trees quicker.

A dwarf must be selected in the '''Woodcutters''' [[work detail]] in order to chop down trees. It's a subset of "woodworking", together with [[carpentry]] and [[crossbow-making]]. This labor is also mutually exclusive with [[mining]], because, like mining it requires a tool to be equipped, and thus has a uniform attached to it.

If you [[embark]] using the "Play Now!" option, one of the seven settlers will be a Novice Wood Cutter in the appropriate work detail. Graphically, any individual assigned as a woodcutter will be wearing a yellow tunic.

== Cutting down trees ==

Trees need to be designated to be cut down. Specifically, designating any of the trunk tiles of a tree will do.

# Select "Set tree chopping orders" (in the bottom bar, or press {{Menu icon|l}}).
# Click on the starting point (one corner of the desired triangle).
# Click (again) on the opposite corner of the desired rectangle to be cut. The trunk tiles of the trees that were in the rectangle should be highlighted, indicating that they will be chopped down.
#* Tiles can also be designated by using keyboard cursor if enabled.

After the trees are designated, any idle dwarf with the Wood Cutting work detail enabled and an axe equipped will start chopping them down. As with other tasks, the most recently designated target is processed first.

[[Image:tree-kills-woodcutter.png|400px|thumb|And you thought that your job was bad.]]

Trees can be cut from any point, not only from ground level, but in all cases, after the dwarf is done cutting, the tree transforms into a pile of logs that fall to the ground in a direction opposite from where the cutter was standing. The logs are not treated as falling objects--they cannot hurt any creatures they land on--but any objects previously sitting upon the tree (e.g. logs from previously felled trees, bolts, corpses, etc.) will fall with standard ''Dwarf Fortress'' lethality.

== Axes ==
A dwarf needs to have an equipped edged [[axe]] to chop down trees. If a dwarf has the Wood Cutting work detail enabled but doesn't have an axe, they will pick up any available one from a stockpile. Thankfully, any immigrant that arrives with the wood cutting labor enabled will be carrying an axe {{Verify|how does this apply for the new work detail system?}}.

There are no special axes for woodcutting; dwarves use standard [[battle axe]]s. Creatures large enough to wield [[great axe]]s and [[halberd]]s can use them for woodcutting as well; however, due to {{bugl|5812}}, no dwarf can equip either weapon. Unlike [[weapon|axes in combat]] though, the quality or material of an axe appears to have no effect on any aspect of wood cutting - a [[quality|no-quality]] [[copper]] axe is the same as a masterwork [[steel]] or [[adamantine]] axe. However, wood cutters will no longer use axes without edges, such as wooden [[training weapon|training axe]]s.

Unfortunately, it is not currently possible to assign woodcutters the same axe to use in the [[military]] as to use in civilian labor{{bug|1451}}.

== Tips ==
* Any part of the tree's "trunk" can be cut to bring the entire tree down. There is no "pruning" of tree limbs in ''Dwarf Fortress''.
** If you are unable to designate a tree to be cut down, check the higher levels. If an upper level of the tree is already designated for cutting, the "ground-level" trunk will not also be designated, and the tree will not be cut down unless that higher-level branch can be accessed.
* Felled trees fall safely, but any objects that were previously supported by the tree will fall downward, with standard ''Dwarf Fortress'' lethality. Care must be taken to ensure that the woodcutters do not kill other friendly creatures.
** Sometimes dwarves or livestock can get stuck in trees. Cutting down the tree in this case is generally a bad idea, since the creature will take a lot of damage on impact with the ground. Build a staircase up to the branches and try to coax the creature out first.
* If the tile in the z-level under the tree's trunk is mined out first, cutting the tree down will remove the ground (floor) tile, creating a hole.
* A single fully-grown tree can provide well over ten logs, making a wood-powered metal industry possible in a well-forested [[biome]], if not always infinitely sustainable.
* Many products can be made with materials other than wood. Wood cutting is a skill you could probably turn off and on as necessary, unless you need a continuous supply of wood for beds, charcoal, ash, or siege weapon parts and ammo.
* As felling trees is usually done away from your fortress, it is an inherently dangerous activity in hostile areas, and care must be taken to ensure that the woodcutters are not killed by hostile [[creature]]s or [[ambush]]ed. It may be helpful to assign woodcutters a [[war animal]] or other work animal.
* [[Herbalist]]s can gather fruit and nuts from a lot of trees. [[Stepladder]]s aid this process. However, clear-cutting a large area will lower your food production if you rely a lot on herbalists. Underground "trees" (being the current in-game model for fungi) do not produce fruit.
* Wood production can be sped up if the woodcutters are excluded from a [[haul|wood hauling]] work detail, so they can focus on cutting more trees instead of hauling the logs from the last one to the nearest wood [[stockpile]].

==== Woodcutting and the military: ====
There are several quirks, tricks and outright bugs found in the area overlapping woodcutters and axedwarves...

* Due to a bug, the wood cutting labor conflicts with military uniforms. A military dwarf with wood cutting enabled will drop his uniform when transitioning to civilian duty. To avoid problems it is recommended you keep your military and wood cutters separate.
* If you remove the woodcutting labour of your only woodcutter, his axe may be taken by the military, as well as all axes made subsequently. If you then assign the woodcutting labour to other dwarves, they will do nothing, as they cannot equip axes. To solve this, disband your military temporarily; the woodcutters will pick up axes, and you can then re-make your military squads.
* There is bug where, if you had an axedwarf in the military, and then remove them from their squad, no other dwarf will pick up that axe for woodcutting. Go to your s{{k|q}}uads menu and disband that squad - that will free up the axe(s) for woodcutting duty.
* Again - it's best if you can keep your woodcutters/woodcutting axes separate from your axedwarves/military axes.

== Trivia ==
{{D for Dwarf}}
In order to relieve the brainless monotony (aka: dwarven bliss) experienced by wood cutters, the diminutive log choppers often engage in competitive singing whilst whacking away at their arboreal nemeses, such that raucous renditions of the perpetually popular tune "I am a lumberjack and I'm OK" can be heard echoing throughout the timbered valleys found near their fortresses at ever increasing levels of volume. The overall loudness of the rendition is apparently the most critical value used to determine the winner. Unfortunately, this singing is fairly detrimental to overall harvesting productivity, as by the time most singers lay in to the third verse of the song, they have either convulsed into blithering (and debilitating) laughter, or they have run off to taunt the elves with their massive tooth picks whilst wearing their best cross dressing outfits (see further).

Sadly, wood cutters often fall victim to raiding goblins, as their cacophonous singing leads the goblins straight to them just as they are in a state of vocal euphoria, and are thus easy prey for the grimy gobbos. That said, there have been instances when their singing has soothed the savagery of nearby beasts, but reports of this are scarce as most dwarves are unwilling to admit their feat, for fear that it might be seen as undwarflike (aka cowardly).

Some dwarves have been known to carry on their person very large toothpicks, with which they clean their rather massive molars. These toothpicks are crafted by the woodcutters (in their off hours), sometimes using an entire tree to manufacture a single pick. Wood cutters take significant pride in the size of their toothpicks, which, in a pinch, can often double for poles used in pole vaulting contests (another popular dwarven pastime, an event usually called the 'Pole-Toss'). Thus the origin of the phrases "Go toss your pole" and "Is that a lumberjack's toothpick in your pocket or are you just happy to see me?" are explained.

Despite rumors, no [[giant]] has become a lumberjack. Much less one named Paul.

{{skills}}
[[ru:Wood cutter]]

Attribute

2024-04-15T06:40:44Z

Putnam3145: /* Toughness */

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

[[File:attributes_v50_preview.png|thumb|262px|right|Attributes of a stoneworker.]]A creature has numerous '''attributes''' which affect its performance at various tasks, split into physical factors associated with the body, and mental factors associated with the [[soul]].

Body Attributes can be viewed in the creature's Health -> Description screen. Soul Attributes can be viewed in the creature's Personality -> Traits screen. Positive attributes are shown in green, negative attributes are shown in red, and average attributes are omitted. Said attributes may be listed as follows (may have to be highlighted to be seen): 
{{DFtext|He is slow to tire and agile, |2:0}}{{DFtext|but he is quite susceptible to disease.|4:0}}

Attributes are associated with skills, so that shield use will raise endurance as an attribute, but not attributes like memory. Different attributes raised by one skill may not be raised by the same amount. Attribute and skill gain and rust rates are moddable in the raws as a [[creature token]].

Attributes can be viewed for individual dwarves by selecting ({{k|v}}iew dwarves, {{k|z}}, {{k|enter}}), or by going to the ({{k|u}}nits menu, {{k|v}}iew, then {{k|enter}}).

== Descriptions ==
In-game attribute descriptions are calculated based on the difference from the [[creature|species]] average. [[Human]]s' median attribute values are always 1000. Thus, if the median [[dwarf]] has higher than 1000 for an attribute, that means the median dwarf is better than the median human for that attribute (however, individual humans may be better than individual dwarves due to intraspecies variation). Likewise, if the median dwarf has below 1000 for an attribute, then the median human bests the median dwarf in that contest.

The tiers at which descriptions change are 250, 500, 750, and 1000 above or below the species median. Interestingly, if a species has an attribute with a median below 1000, such as dwarves' agility, the lowest tier will never be displayed.

These descriptions are not used in [[adventurer mode]].

== Body attributes ==
The attribute values given in the tables correspond to default racial averages for dwarves only. Modded dwarves or any other creature will report the same phrases, but the underlying numbers may be very different, as they are calculated based on the species average. In almost every case, a higher attribute value is better, as opposed to [[personality trait]]s where one may prefer higher or lower depending on the situation.

=== Strength ===
Alters the damage done in melee (increases velocity of weapon swings), increases muscle mass (a thicker muscle layer also resists damage more), and increases how much a creature can carry. Higher strength also increases the speed of fast [[gait]]s in most creatures, including running, soaring, galloping, and fast swimming, however, proportionate gains in muscle mass can eventually reduce speed enough to overtake the gains (more so with larger creatures than dwarves). The dwarven median of 1250 is higher than average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || unbelievably strong
|-
| 2000–2249 || mighty
|-
| 1750–1999 || very strong
|-
| 1500–1749 || strong
|-
| 1001–1499 || (no description)
|-
| 751–1000 || weak
|-
| 501–750 || very weak
|-
| 251–500 || unquestionably weak
|-
| 0–250 || unfathomably weak
|}

===Agility===
This attribute affects the speed of a creature's fast-moving [[gait]]s in the same way as strength — a creature with maximum agility and strength can run faster than a creature with minimum agility and strength. The median dwarf agility of 900 is slightly below average.

Because dwarves in general have below-average agility, and because the descriptions are based on the difference from the racial average, no dwarves will ever display as "abysmally clumsy".

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 1900–5000 || amazingly agile
|-
| 1650–1899 || extremely agile
|-
| 1400–1649 || very agile
|-
| 1150–1399 || agile
|-
| 651–1149 || (no description)
|-
| 401–650 || clumsy
|-
| 151–400 || quite clumsy
|-
| 0–150 || totally clumsy
|-
| (never displayed) || abysmally clumsy
|}

===Toughness===
Increases the amount of time required to suffocate.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || basically unbreakable
|-
| 2000–2249 || incredibly tough
|-
| 1750–1999 || quite durable
|-
| 1500–1749 || tough
|-
| 1001–1499 || (no description)
|-
| 751–1000 || flimsy
|-
| 501–750 || very flimsy
|-
| 251–500 || remarkably flimsy
|-
| 0–250 || shockingly fragile
|}

===Endurance===
Reduces the rate at which dwarves become exhausted, as well as increasing pain tolerance. The dwarven median endurance of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || absolutely inexhaustible
|-
| 1750–1999 || indefatigable
|-
| 1500–1749 || very slow to tire
|-
| 1250–1499 || slow to tire
|-
| 751–1249 || (no description)
|-
| 501–750 || quick to tire
|-
| 251–500 || very quick to tire
|-
| 1–250 || extremely quick to tire
|-
| 0 || truly quick to tire
|}

===Recuperation===
Increases the rate of wound healing and reduces fat. The dwarven median recuperation of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || possessed of amazing recuperative powers
|-
| 1750–1999 || incredibly quick to heal
|-
| 1500–1749 || quite quick to heal
|-
| 1250–1499 || quick to heal
|-
| 751–1249 || (no description)
|-
| 501–750 || slow to heal
|-
| 251–500 || very slow to heal
|-
| 1–250 || really slow to heal
|-
| 0 || shockingly slow to heal
|}

===Disease resistance===
Reduces the risk of contracting [[syndrome]]s, and their negative effects when active, including the [[alcohol]]-induced ones. The dwarven median disease resistance of 1000 is exactly the human average. Having a disease resistance of 5000 does not grant immunities.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || virtually never sick
|-
| 1750–1999 || almost never sick
|-
| 1500–1749 || very rarely sick
|-
| 1250–1499 || rarely sick
|-
| 751–1249 || (no description)
|-
| 501–750 || susceptible to disease
|-
| 251–500 || quite susceptible to disease
|-
| 1–250 || really susceptible to disease
|-
| 0 || stunningly susceptible to disease
|}

== Skills by body attribute ==
{{SkillsByBodyAttribute}}

==Soul attributes==
The attribute values given in the tables correspond to default racial averages for dwarves only. Modded dwarves or any other creature will report the same phrases, but the underlying numbers may be very different. In almost every case, a higher attribute value is better, as opposed to [[personality trait]]s where one may prefer higher or lower depending on the situation.

From [http://www.bay12forums.com/smf/index.php?topic=60554.msg1413312#msg1413312 this post by Toady One]:
<blockquote>
With respect to skills: most of these attributes only affect duration, when that is the only available skill effect to begin with, but they are factored into outcomes when it applies.
</blockquote>

At the [[#Skills By Soul Attribute|bottom]] is a list of which attributes affect which skills. [[:Image:DFmental.PNG|This]] pair of charts provides an easier to read summary of the soul attributes that are useful for doctors and soldiers.

===Analytical ability===
The dwarven median analytical ability of 1250 is slightly above average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || awesome intellectual powers
|-
| 2000–2249 || great analytical abilities
|-
| 1750–1999 || a sharp intellect
|-
| 1500–1749 || a good intellect
|-
| 1001–1499 || (no description)
|-
| 751–1000 || poor analytical abilities
|-
| 501–750 || very bad analytical abilities
|-
| 251–500 || a lousy intellect
|-
| 0–250 || a stunning lack of analytical ability
|}

===Focus===
The dwarven median focus of 1500 is above average.

{| class=wikitable style="width:400px;"
! Value{{verify}}
! Description

|-
| 2542–5000 || unbreakable focus
|-
| 2292–2541 || a great ability to focus
|-
| 2042–2291 || very good focus
|-
| 1792–2041 || the ability to focus
|-
| 1293–1791 || (no description)
|-
| 1043–1292 || poor focus
|-
| 793–1042 || quite poor focus
|-
| 543–792 || really poor focus
|-
| 0–542 || the absolute inability to focus
|}

===Willpower===
Willpower directly reduces exertion and pain effects, and also affects the threshold before creatures flee in battle and the effects of stress. The dwarven median willpower of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an unbreakable will
|-
| 1750–1999 || an iron will
|-
| 1500–1749 || a lot of willpower
|-
| 1250–1499 || willpower
|-
| 751–1249 || (no description)
|-
| 501–750 || little willpower
|-
| 251–500 || a large deficit of willpower
|-
| 1–250 || next to no willpower
|-
| 0 || absolutely no willpower
|}

===Creativity===
The dwarven median creativity of 1250 is slightly above the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || a boundless creative imagination
|-
| 2000–2249 || great creativity
|-
| 1751–1999 || very good creativity
|-
| 1500–1750 || good creativity
|-
| 1001–1499 || (no description)
|-
| 751–1000 || meager creativity
|-
| 501–750 || poor creativity
|-
| 251–500 || lousy creativity
|-
| 0–250 || next to no creative talent
|}

===Intuition===
The dwarven median intuition of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || uncanny intuition
|-
| 1750–1999 || great intuition
|-
| 1500–1749 || very good intuition
|-
| 1250–1499 || good intuition
|-
| 751–1249 || (no description)
|-
| 501–750 || bad intuition
|-
| 251–500 || very bad intuition
|-
| 1–250 || lousy intuition
|-
| 0 || horrible intuition
|}

===Patience===
Some non-skill tasks are affected by Patience. The dwarven median patience of 1250 is slightly above the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || absolutely boundless patience
|-
| 2000–2249 || a deep well of patience
|-
| 1750–1999 || a great deal of patience
|-
| 1500–1749 || a sum of patience
|-
| 1001–1499 || (no description)
|-
| 751–1000 || a shortage of patience
|-
| 501–750 || little patience
|-
| 251–500 || very little patience
|-
| 0–250 || no patience at all
|}

===Memory===
The dwarven median memory of 1250 is slightly above the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2250–5000 || an astonishing memory
|-
| 2000–2249 || an amazing memory
|-
| 1750–1999 || a great memory
|-
| 1500–1749 || a good memory
|-
| 1001–1499 || (no description)
|-
| 751–1000 || an iffy memory
|-
| 501–750 || a poor memory
|-
| 251–500 || a really bad memory
|-
| 0–250 || little memory to speak of
|}

===Linguistic ability===
The dwarven median linguistic ability of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an astonishing ability with languages and words
|-
| 1750–1999 || a great affinity for language
|-
| 1500–1749 || a natural inclination toward language
|-
| 1250–1499 || a way with words
|-
| 751–1249 || (no description)
|-
| 501–750 || a little difficulty with words
|-
| 251–500 || little linguistic ability
|-
| 1–250 || very little linguistic ability
|-
| 0 || difficulty with words and language
|}

===Spatial sense===
The dwarven median spatial sense of 1500 is above the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2542–5000 || a stunning feel for spatial relationships
|-
| 2292–2541 || an amazing spatial sense
|-
| 2042–2291 || a great feel for the surrounding space
|-
| 1792–2041 || a good spatial sense
|-
| 1293–1791 || (no description)
|-
| 1043–1292 || a questionable spatial sense
|-
| 793–1042 || poor spatial senses
|-
| 543–792 || an atrocious spatial sense
|-
| 0–542 || no sense for spatial relationships
|}

===Musicality===
Musicality affects performances, such as playing music with instruments and singing. The dwarven median musicality of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an astonishing knack for music
|-
| 1750–1999 || a great musical sense
|-
| 1500–1749 || a natural ability with music
|-
| 1250–1499 || a feel for music
|-
| 751–1249 || (no description)
|-
| 501–750 || an iffy sense for music
|-
| 251–500 || little natural inclination toward music
|-
| 1–250 || next to no natural musical ability
|-
| 0 || absolutely no feel for music at all
|}

===Kinesthetic sense===
Most skills involving any movement at all (lots of them), and many non-skilled tasks as well, are affected by Kinesthetic Sense. The dwarven median kinesthetic sense of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an astounding feel for the position of [his/her] own body
|-
| 1750–1999 || a great kinesthetic sense
|-
| 1500–1749 || a very good sense of the position of [his/her] own body
|-
| 1250–1499 || a good kinesthetic sense
|-
| 751–1249 || (no description)
|-
| 501–750 || a meager kinesthetic sense
|-
| 251–500 || a poor kinesthetic sense
|-
| 1–250 || a very clumsy kinesthetic sense
|-
| 0 || an unbelievably atrocious sense of the position of [his/her] own body
|}

===Empathy===
The dwarven median empathy of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || an absolutely remarkable sense of others' emotions
|-
| 1750–1999 || a great sense of empathy
|-
| 1500–1749 || a very good sense of empathy
|-
| 1250–1499 || an ability to read emotions fairly well
|-
| 751–1249 || (no description)
|-
| 501–750 || poor empathy
|-
| 251–500 || a very bad sense of empathy
|-
| 1–250 || next to no empathy
|-
| 0 || the utter inability to judge others' emotions
|}

===Social awareness===
The dwarven median social awareness of 1000 is exactly the human average.

{| class=wikitable style="width:400px;"
! Value
! Description
|-
| 2000–5000 || a shockingly profound feel for social relationships
|-
| 1750–1999 || a great feel for social relationships
|-
| 1500–1749 || a very good feel for social relationships
|-
| 1250–1499 || a good feel for social relationships
|-
| 751–1249 || (no description)
|-
| 501–750 || a meager ability with social relationships
|-
| 251–500 || a poor ability to manage or understand social relationships
|-
| 1–250 || a lack of understanding of social relationships
|-
| 0 || an absolute inability to understand social relationships
|}

== Skills by soul attribute ==
{{SkillsBySoulAttribute}}

== Skills by associated attributes ==

{| border="1" cellpadding="2" style="border-spacing: 0; border-width: 1px; border-style: solid; text-align:center;"
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
!rowspan="144"|
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Miner]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Wood cutter]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Carpenter]] || {{X|A}} || {{X|B}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Engraver]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Mason]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Animal trainer]] || || {{X|A}} || {{X|B}} || {{X|C}} || || || || || {{X|C}} || {{X|B}} || || || || || || {{X|A}} ||
|-style="background:#f5f5f5;"
| [[Animal caretaker]] || || {{X|A}} || || || {{X|A}} || || || || || || {{X|B}} || || || || || {{X|C}} ||
|-
| [[Fish dissector]] || || {{X|A}} || || || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Animal dissector]] || || {{X|A}} || || || || || || || || || || || || || {{X|A}} || ||
|-
| [[Fish cleaner]] || || {{X|A}} || || {{X|B}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Butcher]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Trapper]] || || {{X|A}} || || || {{X|A}} || || || {{X|B}} || || || || || {{X|C}} || || || ||
|-style="background:#f5f5f5;"
| [[Tanner]] || || {{X|A}} || || || || || || || || || || || || || {{X|A}} || ||
|-
| [[Weaver]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Brewer]] || {{X|A}} || {{X|B}} || || || || || || || || || || || || || {{X|A}} || ||
|-
| [[Clothier]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Miller]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Thresher]] || {{X|B}} || {{X|A}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Cheese maker]] || {{X|B}} || {{X|A}} || || {{X|C}} || {{X|B}} || || || {{X|C}} || || || || || || || {{X|A}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Milker]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Cook]] || || {{X|A}} || || || {{X|B}} || || || {{X|C}} || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Planter]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Herbalist]] || || {{X|A}} || || || || || || || || || {{X|B}} || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Fisherdwarf]] || {{X|B}} || {{X|A}} || || || || {{X|A}} || || || || {{X|B}} || || || || || {{X|C}} || ||
|-
| [[Furnace operator]] || {{X|A}} || || {{X|B}} || {{X|C}} || {{X|B}} || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Strand extractor]] || {{X|B}} || {{X|A}} || || {{X|C}} || {{X|B}} || || || || || || || || || || {{X|A}} || ||
|-
| [[Weaponsmith]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Armorsmith]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Metalsmith]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Gem cutter]] || || {{X|A}} || || || {{X|C}} || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Gem setter]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Wood crafter]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Stone crafter]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Metal crafter]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Glassmaker]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Leatherworker]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Bone carver]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Axeman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Swordsman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Knife user]] || {{X|B}} || {{X|A}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Maceman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Hammerman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Spearman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Crossbowman]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Shield user]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Armor user]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || {{X|B}} || || || || || || || || {{X|A}} || ||
|-
| [[Siege engineer]] || {{X|A}} || {{X|B}} || || {{X|C}} || {{X|A}} || || || {{X|B}} || || || || || {{X|C}} || || || ||
|-style="background:#f5f5f5;"
| [[Siege operator]] || {{X|A}} || || {{X|B}} || {{X|C}} || {{X|B}} || {{X|C}} || || || || || || || {{X|A}} || || || ||
|-
| [[Bowyer]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Pikeman]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-
| [[Lasher]] || {{X|B}} || {{X|A}} || {{X|C}} || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Bowman]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Blowgunner]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-style="background:#f5f5f5;"
| [[Thrower]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Mechanic]] || {{X|B}} || {{X|A}} || || {{X|C}} || {{X|A}} || || || {{X|B}} || || || || || {{X|C}} || || || ||
|-style="background:#f5f5f5;"
| [[Druid]] || || {{X|B}} || {{X|C}} || {{X|A}} || || {{X|C}} || {{X|B}} || || || || || || || || || {{X|A}} ||
|-
| [[Ambusher]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Wound dresser]] || || {{X|A}} || || || || || || || || || || || {{X|B}} || || {{X|A}} || {{X|C}} ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Diagnostician]] || || || || || {{X|A}} || || || || {{X|C}} || || {{X|B}} || || || || || ||
|-
| [[Surgeon]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Bone doctor]] || {{X|B}} || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Suturer]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Crutch-walker]] || || {{X|A}} || || {{X|B}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Wood burner]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Lye maker]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Soaper]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Potash maker]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-
| [[Dyer]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Pump operator]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || {{X|B}} || || || || || || || || {{X|A}} || ||
|-
| [[Swimmer]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Persuader]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Negotiator]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-style="background:#f5f5f5;"
| [[Judge of intent]] || || || || || || || || || {{X|C}} || || || || || || || {{X|A}} || {{X|B}}
|-
| [[Appraiser]] || || || || || {{X|A}} || || || || {{X|C}} || || {{X|B}} || || || || || ||
|-style="background:#f5f5f5;"
| [[Organizer]] || || || || || {{X|A}} || || || {{X|C}} || || || || || || || || || {{X|B}}
|-
| [[Record keeper]] || || || || || {{X|A}} || {{X|C}} || || || || || {{X|B}} || || || || || ||
|-style="background:#f5f5f5;"
| [[Liar]] || || || || || || || || {{X|C}} || || || || {{X|A}} || || || || || {{X|B}}
|-
| [[Intimidator]] || {{X|A}} || {{X|B}} || || || || || || || || || || {{X|A}} || || || {{X|B}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Conversationalist]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Comedian]] || || {{X|A}} || || || || || || {{X|B}} || || || || {{X|A}} || || || {{X|C}} || ||
|-style="background:#f5f5f5;"
| [[Flatterer]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Consoler]] || || || || || || || || || || || || {{X|B}} || || || || {{X|A}} || {{X|C}}
|-style="background:#f5f5f5;"
| [[Pacifier]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Tracker]] || || || || || {{X|A}} || || || || {{X|B}} || || || || {{X|C}} || || || ||
|-style="background:#f5f5f5;"
| [[Student]] || || || || || {{X|B}} || {{X|C}} || || || || || {{X|A}} || || || || || ||
|-
| [[Concentration]] || || || || || || {{X|A}} || {{X|C}} || || || {{X|B}} || || || || || || ||
|-style="background:#f5f5f5;"
| [[Discipline]] || || || || || || {{X|B}} || {{X|A}} || || || || || || || || || ||
|-
| [[Observer]] || || || || || || {{X|B}} || || || {{X|C}} || || || || {{X|A}} || || || ||
|-style="background:#f5f5f5;"
| [[Wordsmith]] || || || || || || || || {{X|B}} || {{X|C}} || || || {{X|A}} || || || || ||
|-
| [[Writer]] || || || || || || || || {{X|B}} || {{X|C}} || || || {{X|A}} || || || || ||
|-style="background:#f5f5f5;"
| [[Poet]] || || || || || || || || {{X|B}} || {{X|C}} || || || {{X|A}} || || || || ||
|-
| [[Reader]] || || || || || || {{X|B}} || || || || || {{X|C}} || {{X|A}} || || || || ||
|-style="background:#f5f5f5;"
| [[Speaker]] || || || || || || || || || || || || {{X|A}} || || || || {{X|C}} || {{X|B}}
|-
| [[Coordination]] || || {{X|A}} || || || || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Balance]] || {{X|B}} || {{X|A}} || || || || || || || || || || || || || {{X|A}} || ||
|-
| [[Leader]] || || || || || || || || || || || || {{X|C}} || || || || {{X|A}} || {{X|B}}
|-style="background:#f5f5f5;"
| [[Teacher]] || || || || || || || || || || || || {{X|C}} || || || || {{X|A}} || {{X|B}}
|-
| [[Fighter]] || {{X|B}} || {{X|A}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Archer]] || || {{X|A}} || || || || {{X|C}} || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Wrestler]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Biter]] || {{X|A}} || || {{X|B}} || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Striker]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Kicker]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Dodger]] || || {{X|A}} || {{X|B}} || {{X|C}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Misc. object user]] || {{X|A}} || {{X|B}} || {{X|C}} || || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Knapper]] || {{X|B}} || {{X|A}} || || || {{X|B}} || || || || || || || || {{X|A}} || || {{X|C}} || ||
|-style="background:#f5f5f5;"
| [[Tactician]] || || || || || {{X|A}} || || || {{X|B}} || {{X|C}} || || || || || || || ||
|-
| [[Shearer]] || {{X|B}} || {{X|A}} || || {{X|C}} || || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Spinner]] || {{X|B}} || {{X|A}} || || {{X|C}} || || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Potter]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Glazer]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Presser]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Beekeeper]] || {{X|B}} || {{X|A}} || || {{X|C}} || {{X|A}} || || || || || || || || {{X|B}} || || {{X|C}} || ||
|-
| [[Wax worker]] || || {{X|A}} || || || || || || {{X|C}} || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Climber]] || {{X|B}} || {{X|C}} || || {{X|A}} || || || {{X|C}} || || || || || || {{X|B}} || || {{X|A}} || ||
|-
| [[Gelder]] || {{X|A}} || {{X|B}} || || {{X|C}} || || || || || || || || || || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Dancer]] || {{X|C}} || {{X|A}} || || {{X|B}} || || || || || || || || || {{X|B}} || {{X|C}} || {{X|A}} || ||
|-
| [[Musician]] || || || || || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|- style="background:#e5e5e5;text-align:left;vertical-align:bottom;"
! style="text-align:center;" | Skill
{{Rotated-heading|[[#Strength|Strength]]}}
{{Rotated-heading|[[#Agility|Agility]]}}
{{Rotated-heading|[[#Toughness|Toughness]]}}
{{Rotated-heading|[[#Endurance|Endurance]]}}
{{Rotated-heading|[[#Analytical_Ability|Analytical Ability]]}}
{{Rotated-heading|[[#Focus|Focus]]}}
{{Rotated-heading|[[#Willpower|Willpower]]}}
{{Rotated-heading|[[#Creativity|Creativity]]}}
{{Rotated-heading|[[#Intuition|Intuition]]}}
{{Rotated-heading|[[#Patience|Patience]]}}
{{Rotated-heading|[[#Memory|Memory]]}}
{{Rotated-heading|[[#Linguistic_Ability|Linguistic Ability]]}}
{{Rotated-heading|[[#Spatial_Sense|Spatial Sense]]}}
{{Rotated-heading|[[#Musicality|Musicality]]}}
{{Rotated-heading|[[#Kinesthetic_Sense|Kinesthetic Sense]]}}
{{Rotated-heading|[[#Empathy|Empathy]]}}
{{Rotated-heading|[[#Social_Awareness|Social Awareness]]}}
|-style="background:#f5f5f5;"
| [[Singer]] || || || || || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-
| [[Keyboardist]] || || {{X|A}} || || || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-style="background:#f5f5f5;"
| [[Stringed instrumentalist]] || || {{X|A}} || || || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-
| [[Wind instrumentalist]] || || {{X|A}} || || {{X|B}} || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-style="background:#f5f5f5;"
| [[Percussionist]] || {{X|C}} || {{X|A}} || || {{X|B}} || || {{X|C}} || || {{X|B}} || || || || || || {{X|A}} || || ||
|-
| [[Critical thinker]] || || || || || {{X|A}} || || || || || || || || || || || ||
|-style="background:#f5f5f5;"
| [[Logician]] || || || || || {{X|A}} || || || || || || || || || || || ||
|-
| [[Mathematician]] || || || || || {{X|A}} || || || || || || {{X|C}} || || {{X|B}} || || || ||
|-style="background:#f5f5f5;"
| [[Astronomer]] || || || || || {{X|A}} || || || || || || {{X|C}} || || {{X|B}} || || || ||
|-
| [[Chemist]] || || || || || {{X|A}} || {{X|B}} || || || || || {{X|C}} || || || || || ||
|-style="background:#f5f5f5;"
| [[Geographer]] || || || || || {{X|B}} || || || || || || {{X|C}} || || {{X|A}} || || || ||
|-
| [[Optics engineer]] || || || || || {{X|B}} || {{X|C}} || || || || || || || {{X|A}} || || || ||
|-style="background:#f5f5f5;"
| [[Fluid engineer]] || || || || || {{X|B}} || {{X|C}} || || || || || || || {{X|A}} || || || ||
|-
| [[Papermaker]] || {{X|A}} || {{X|B}} || || || || || || || || || || || {{X|B}} || || {{X|A}} || ||
|-style="background:#f5f5f5;"
| [[Bookbinder]] || || {{X|A}} || || || || || || || || || || || {{X|A}} || || {{X|B}} || ||
|-
| [[Schemer]] || || || || || || || || {{X|C}} || {{X|B}} || || || || || || || || {{X|A}}
|-style="background:#f5f5f5;"
| [[Rider]] || || {{X|A}} || || || || || {{X|C}} || || || || || || || || {{X|A}} || {{X|B}} ||
|}

Notes:
*Skills have both Primary attributes (labeled "A") and Secondary attributes (labeled "B" and "C"). Primary attributes give a bonus for every 100 points, while secondary attributes give a bonus for every 250 points.
*Spatial Sense and Kinesthetic Sense are almost everywhere
*Nothing trains Disease Resistance or Recuperation
*Intimidator and Comedian, both social skills, raise Agility. Dwarven comedy is slapstick/clowning, not stand-up.
*Student skill doesn't boost skill gain except for teacher-student relations in a barracks
*Choose high-volume labors that train useful attributes for militia day-jobs/bootcamp
*Fishing, Siege Operating, and Record Keeping are useful for marksdwarves as they train the Focus attribute
*Hunting (ambusher/sneak) has identical attribute gain to Crossbow and Archer skills

===Attributes trained by skills===
'''''Strength''''':
:'''Primary''': Miner, Wood cutter, Carpenter, Mason, Butcher, Brewer, Miller, Milker, Planter, Furnace operator, Weaponsmith, Armorsmith, Metalsmith, Metal crafter, Glassmaker, Leatherworker, Axeman, Swordsman, Maceman, Hammerman, Spearman, Shield user, Armor user, Siege engineer, Siege operator, Pikeman, Thrower, Wood burner, Lye maker, Soaper, Potash maker, Dyer, Pump operator, Swimmer, Intimidator, Wrestler, Biter, Striker, Kicker, Misc. object user, Presser, Gelder, Papermaker
:'''Secondary''': Thresher, Cheese maker, Fisherdwarf, Strand extractor, Knife user, Lasher, Mechanic, Bone doctor, Balance, Fighter, Knapper, Shearer, Spinner, Beekeeper, Climber, Dancer, Percussionist

'''''Agility''''':
:'''Primary''': Engraver, Animal trainer, Animal caretaker, Fish dissector, Animal dissector, Fish cleaner, Trapper, Tanner, Weaver, Alchemist, Clothier, Thresher, Cheese maker, Cook, Herbalist, Fisherdwarf, Strand extractor, Gem cutter, Gem setter, Wood crafter, Stone crafter, Bone carver, Knife user, Crossbowman, Bowyer, Lasher, Bowman, Blowgunner, Mechanic, Ambusher, Wound dresser, Surgeon, Bone doctor, Suturer, Crutch-walker, Comedian, Coordination, Balance, Fighter, Archer, Dodger, Knapper, Shearer, Spinner, Potter, Glazer, Beekeeper, Wax worker, Dancer, Keyboardist, Stringed instrumentalist, Wind instrumentalist, Percussionist, Bookbinder, Rider
:'''Secondary''': Wood cutter, Carpenter, Mason, Butcher, Brewer, Miller, Milker, Planter, Weaponsmith, Armorsmith, Metalsmith, Metal crafter, Axeman, Swordsman, Maceman, Hammerman, Spearman, Shield user, Siege engineer, Pikeman, Thrower, Druid, Dyer, Swimmer, Intimidator, Wrestler, Striker, Kicker, Misc. object user, Presser, Climber, Gelder, Papermaker

'''''Toughness''''':
:'''Primary''': ''none''
:'''Secondary''': Miner, Animal trainer, Furnace operator, Axeman, Swordsman, Knife user, Maceman, Hammerman, Spearman, Shield user, Armor user, Siege operator, Pikeman, Lasher, Thrower, Druid, Wood burner, Lye maker, Soaper, Potash maker, Pump operator, Fighter, Biter, Striker, Kicker, Dodger, Misc. object user

'''''Endurance''''':
:'''Primary''': Druid, Climber
:'''Secondary''': Miner, Wood cutter, Mason, Animal trainer, Fish cleaner, Butcher, Miller, Thresher, Cheese maker, Milker, Planter, Furnace operator, Strand extractor, Weaponsmith, Armorsmith, Metalsmith, Metal crafter, Glassmaker, Leatherworker, Armor user, Siege engineer, Siege operator, Mechanic, Crutch-walker, Wood burner, Lye maker, Soaper, Potash maker, Dyer, Pump operator, Swimmer, Wrestler, Biter, Dodger, Shearer, Spinner, Presser, Beekeeper, Gelder, Dancer, Wind instrumentalist, Percussionist

'''''Disease Resistance''''':
:Nothing!

'''''Recuperation''''':
:Nothing!

'''''Analytical Ability''''':
:'''Primary''': Animal caretaker, Trapper, Alchemist, Siege engineer, Mechanic, Diagnostician, Appraiser, Organizer, Record keeper, Tracker, Tactician, Beekeeper, Critical thinker, Logician, Mathematician, Astronomer, Chemist
:'''Secondary''': Cheese maker, Cook, Furnace operator, Strand extractor, Gem cutter, Siege operator, Student, Knapper, Geographer, Optics engineer, Fluid engineer

'''''Focus''''':
:'''Primary''': Fisherdwarf, Concentration
:'''Secondary''': Crossbowman, Siege operator, Bowman, Blowgunner, Druid, Ambusher, Surgeon, Bone doctor, Suturer, Record keeper, Student, Discipline, Observer, Reader, Archer, Musician, Singer, Keyboardist, Stringed instrumentalist, Wind instrumentalist, Percussionist, Schemer

'''''Willpower''''':
:'''Primary''': Discipline
:'''Secondary''': Miner, Wood cutter, Axeman, Swordsman, Knife user, Maceman, Hammerman, Spearman, Shield user, Armor user, Pikeman, Lasher, Thrower, Druid, Crutch-walker, Pump operator, Swimmer, Concentration, Fighter, Wrestler, Biter, Striker, Kicker, Dodger, Misc. object user, Climber, Rider

'''''Creativity''''':
:'''Primary''': ''none''
:'''Secondary''': Carpenter, Engraver, Mason, Trapper, Weaver, Alchemist, Clothier, Cheese maker, Cook, Weaponsmith, Armorsmith, Metalsmith, Gem setter, Wood crafter, Stone crafter, Metal crafter, Glassmaker, Leatherworker, Bone carver, Siege engineer, Bowyer, Mechanic, Organizer, Liar, Comedian, Wordsmith, Writer, Poet, Tactician, Potter, Glazer, Wax worker, Musician, Singer, Keyboardist, Stringed instrumentalist, Wind instrumentalist, Percussionist, Schemer

'''''Intuition''''':
:'''Primary''': ''none''
:'''Secondary''': Animal trainer, Alchemist, Diagnostician, Judge of Intent, Appraiser, Tracker, Observer, Wordsmith, Writer, Poet, Tactician, Schemer

'''''Patience''''':
:'''Primary''': ''none''
:'''Secondary''': Animal trainer, Fisherdwarf, Concentration

'''''Memory''''':
:'''Primary''': Student
:'''Secondary''': Animal caretaker, Herbalist, Diagnostician, Appraiser, Record keeper, Reader, Mathematician, Astronomer, Chemist, Geographer

'''''Linguistic Ability''''':
:'''Primary''': Persuader, Negotiator, Liar, Intimidator, Conversationalist, Comedian, Flatterer, Pacifier, Wordsmith, Writer, Poet, Reader, Speaker
:'''Secondary''': Consoler, Leader, Teacher

'''''Spatial Sense''''':
:'''Primary''': Crossbowman, Siege operator, Bowman, Blowgunner, Ambusher, Observer, Archer, Knapper, Geographer, Optics engineer, Fluid engineer, Bookbinder
:'''Secondary''': Miner, Wood cutter, Carpenter, Engraver, Mason, Trapper, Weaver, Clothier, Weaponsmith, Armorsmith, Metalsmith, Gem cutter, Gem setter, Wood crafter, Stone crafter, Metal crafter, Glassmaker, Leatherworker, Bone carver, Axeman, Swordsman, Knife user, Maceman, Hammerman, Spearman, Shield user, Siege engineer, Bowyer, Pikeman, Lasher, Mechanic, Wound dresser, Surgeon, Bone doctor, Suturer, Crutch-walker, Swimmer, Tracker, Coordination, Fighter, Wrestler, Biter, Striker, Kicker, Dodger, Misc. object user, Shearer, Spinner, Potter, Glazer, Beekeeper, Wax worker, Climber, Dancer, Mathematician, Astronomer, Papermaker

'''''Musicality''''':
:'''Primary''': Musician, Singer, Keyboardist, Stringed instrumentalist, Wind instrumentalist, Percussionist
:'''Secondary''': Dancer

'''''Kinesthetic Sense''''':
:'''Primary''': Miner, Wood cutter, Carpenter, Engraver, Mason, Fish dissector, Animal dissector, Fish cleaner, Butcher, Tanner, Weaver, Brewer, Clothier, Miller, Thresher, Cheese maker, Milker, Cook, Planter, Herbalist, Furnace operator, Strand extractor, Weaponsmith, Armorsmith, Metalsmith, Gem cutter, Gem setter, Wood crafter, Stone crafter, Metal crafter, Glassmaker, Leatherworker, Bone carver, Axeman, Swordsman, Knife user, Maceman, Hammerman, Spearman, Shield user, Armor user, Bowyer, Pikeman, Lasher, Wound dresser, Surgeon, Bone doctor, Suturer, Crutch-walker, Wood burner, Lye maker, Soaper, Potash maker, Dyer, Pump operator, Swimmer, Coordination, Balance, Fighter, Wrestler, Biter, Striker, Kicker, Dodger, Misc. object user, Shearer, Spinner, Potter, Glazer, Presser, Wax worker, Climber, Gelder, Dancer, Papermaker, Rider
:'''Secondary''': Fisherdwarf, Crossbowman, Bowman, Blowgunner, Thrower, Ambusher, Intimidator, Comedian, Archer, Knapper, Beekeeper, Bookbinder

'''''Empathy''''':
:'''Primary''': Animal trainer, Druid, Judge of intent, Consoler, Leader, Teacher
:'''Secondary''': Animal caretaker, Wound dresser, Persuader, Negotiator, Conversationalist, Flatterer, Pacifier, Speaker, Rider

'''''Social Awareness''''':
:'''Primary''': Schemer
:'''Secondary''': Persuader, Negotiator, Judge of intent, Organizer, Liar, Conversationalist, Flatterer, Consoler, Pacifier, Speaker, Leader, Teacher

== Dwarf attributes ==

Each attribute is a number between 0 and 5000, but in dwarven terms anything below 200 is rare [http://dffd.bay12games.com/file.php?id=5882] and anything above 2500 is extraordinary. In the default raws (/raw/objects/creature_standard.txt), dwarven attributes come in four levels.

Focus and Spatial Sense are referred to as "++", or two steps above default. Their range is defined as [700:1200:1400:1500:1600:1800:2500], which sets out six ranges: 700-1200, 1200-1400, etc. Dwarves have an equal chance of dropping into any of these ranges, and an equal probability again of getting any number in that range. So the bottom one-sixth of your dwarves will be really low, the top one-sixth really high, and the two-thirds in the middle huddled around average. This also means that the median and the mean are slightly different: the mean for ++ is 1516.66... while median is 1500.

Strength, Toughness, Analytical Ability, Creativity, Patience, and Memory are +, or one step above default. Their ranges are [450:950:1150:1250:1350:1550:2250], and their mean is 1266.66...

Endurance, Disease Resistance, Recuperation, Intuition, Willpower, Kinesthetic Sense, Linguistic Ability, Musicality, Empathy, and Social Awareness are AVG, or the default. Their ranges are not specified in the raws, but they are [200:700:900:1000:1100:1300:2000] for Physical and [200:800:900:1000:1100:1300:2000] for Mental.

Agility is "-", the only attribute to be below default. Its ranges are [150:600:800:900:1000:1100:1500], mean 862.5, median 900.

== Training attributes ==

It would seem that various skills train various attributes at different rates. For physical attributes and Willpower, military training works best - it relatively quickly gives a dwarf some extra Agility and Strength, making them walk and work faster in all areas (According to [http://www.bay12forums.com/smf/index.php?topic=121573.msg3944723#msg3944723] speed is a factor in determining how fast a labour is completed).

According to [https://www.reddit.com/r/dwarffortress/comments/zquv8f/psa_you_can_build_a_gym_for_your_military_with/] Reddit post, strength and stamina can be trained via screw pumps reasonably quickly. The pumps don't have to be adjacent to any liquids, and dwarves will still operate them, pumping air.

Plant gathering trains Agility, Kinesthetic Sense, and Memory to a lesser degree. After a couple of years, plant gatherers become the faster dwarves in the fortress and are generally suitable for transfer to any demanding job.

Attributes are capped in Adventure mode and probably also in dwarf mode. Those caps are governed by {{token|MENT_ATT_CAP_PERC}} and {{token|PHYS_ATT_CAP_PERC}}. By default the maximum attribute values (barring increases from vampirism and other interactions) are governed by the starting value as well as the median for that caste (that is the middle value in {{token|PHYS_ATT_RANGE}}, for example 1000 for most attributes for dwarves).
attribute_cap = starting_value + max {starting_value, median}

The speed of learning attributes is governed by "cost to improve" in {{token|PHYS_ATT_RATES}} and {{token|MENT_ATT_RATES}}. By default CTI for attributes is 500, which means the counter for using that attribute has to be incremented 500 times for the dwarf to gain 1 in that attribute. The lower the CTI, the faster an attribute increases. According to [http://www.bay12forums.com/smf/index.php?topic=66525.msg3993120#msg3993120] the counter is incremented every ten ticks a skill using that attribute is in use. This means it takes 5000 TUs or just over 4 in-game days of continuous labour to improve an attribute by 1. The improved attribute gain from military training may stem from the fact that sparring and individual combat drills train multiple skills at the same time.

==Standard ranges==

The game comes pre-stocked with several sets of attribute ranges, some better than others. The signs that come after the numeral ranges indicate what level that range represents, but have no effect in and of themselves.

{|
|[0:0:0:0:0:0:0] || unattainable
|-
|[0:100:200:300:400:450:500] || ---
|-
|[0:400:600:750:800:900:1100] || --
|-
|[150:600:800:900:1000:1100:1500] || -
|-
|[200:700:900:1000:1100:1300:2000] || Default
|-
|[450:950:1150:1250:1350:1550:2250] || +
|-
|[700:1200:1400:1500:1600:1800:2500] || ++
|-
|[1250:1500:1750:2000:2500:3000:5000]|| +++
|-
|[5000:5000:5000:5000:5000:5000:5000]|| max
|}

{{Category|Game mechanics}}
[[ru:Attribute]]

Iron man

2024-03-26T00:14:42Z

Putnam3145:

{{Quality|fine}}
{{Creaturelookup/0
|image=iron_man_sprite.png
|vary=no
|contrib=no
|death=item
|item=☼[[iron]] [[statue]]☼ (worth 3000☼)
}}
{{av}}
{{creaturedesc}}

'''Iron men''' are dangerous and exceptionally rare inorganic [[construct creature]]s made out of [[iron]], who inhabit the third layer of the [[caverns]]. Like other inorganic construct creatures, they are non-sentient, [[No Pain|feel no pain]], fear or [[No Exert|exertion]], [[No Stun|cannot be stunned]] and don't need to breathe. They are as large as [[human]]s and are level 2 [[building destroyer]]s. Iron men are immortal and only die to violence.

Iron men are not as tough as you'd expect, the reason being the fact they are actually hollow: they have an iron exterior layer and an interior gas layer, making them far more fragile than a fully metallic creature such as the [[bronze colossus]], and even [[dwarf]] nails can damage the iron. Iron men are unharmed by [[fire]] and [[magma]], but can be damaged by [[dragonfire]] just like regular iron items. Additionally, iron men will, when damaged, leak a poisonous gas which causes a [[syndrome]] called "iron man cough", consisting of coughing up [[blood]]. Dwarves with standard disease resistance will experience a peak in coughing shortly (100 [[time|time units]]) after infection, and will recover in less than a game day (1000 time units out of a full day's 1200 time units). These periods will vary according to the disease resistance of the infected dwarf, but the disease is not life-threatening. (Unless, of course, [[thought|being sick]] is the straw that breaks the camel's back of your dwarf's [[insanity|sanity]].)

Upon death, iron men become a random masterwork iron [[statue]]. Parts like thumbs and noses removed from the creature during combat may be [[melt item|melted]] at a [[smelter]] in order to produce a small amount of iron.

Some dwarves [[Preferences|like]] iron men for their ''stern appearance''.

[[File:Iron_golem.png|thumb|center|300px|Admired for its ''stern appearance''.]]

===Creature behavior and origin===
{{D for Dwarf}}
Surprisingly, the Iron Man does not deplete your fortress' [[alcohol|booze]] supplies, nor does it woo nearly all of your female dwarves or hold a grudge against your [[Hammerer]]. On rare occasions humans who exhibit strange moods may sometimes turn into one of these. However, dwarves have been unable to duplicate this process, even given the finest workshops and crafting materials, leading most dwarven scholars to declare it impossible for a human to do so in a cave, with a box of scraps. !!EDIT!! The scholars are now running around naked, on account of losing a bet.

It's unknown if the creature's metallic nature is a result of travelling through a magnetic field, or if it is capable of time travel. However, it's certain that it's made completely of iron, with no components of other metals or alloys like lead or steel. It will, however, still seek to fill your dwarves full of dread.

Another amazing capability of the iron man is that just like the [[bronze colossus]], the iron man will nearly always polymorph into the form of another standard, non-randomly generated creature upon death, the post-death statue is almost never a statue of a man. Maybe the energy released upon death somehow shapes the iron into another creature's shape. An alternative theory postulates that upon the metal tissue becoming nonliving, it transforms in such a way that it begins to chemically react with the gas inside the iron man, posthumously mutating the iron cells into a different creature.

{{Translation| dwarven = datan udos | elvish = icori onino | goblin = dusna ngorûg | human = uzin abo}}

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

Manager

2024-03-21T20:26:20Z

Putnam3145: actually i might've just missed something

{{Quality|Unrated}}
{{av}}
{{Noble
|noble=Manager
|office=Meager Office
|function = *Allows large production orders.
|arrival= *Appointed on the [[nobles screen]].
}}

The '''manager''' is a useful [[noble]] that allows players to create multiple [[Work orders]], and also lets them set up profiles for workshops. This means that players can rapidly dispatch any number of jobs from a single screen, without having to add tasks to individual [[workshop]]s.

==Relevant Skills==
A certain set of skills are relevant for any manager. Furthermore, certain [[personality trait]]s influence whether any experience is gained in the skill. There are [[Attribute#Soul_Attributes|soul attributes]] that affect the skills, and other skills that affect the same attributes' cross-training. The ones relevant for a manager are as follows:
{| {{prettytable}}
|- style="background:#ddd"
! rowspan="2" colspan="2" | Skill (relevant for manager)
! rowspan="2" colspan="2" | Personality Trait (needed to gain social skill)
! colspan="2" | Attribute (affected by social skill)
|-
! style="width:1em" | Body
! style="width:1em" | Soul
|-
| rowspan="3" style="width:5em" | Organizer
| rowspan="3" style="width:5em" |
| rowspan="3" colspan="2" |
| rowspan="3" style="width:1em" |
| Analytical ability
|-
| Creativity
|-
| Social awareness
|}
The better match with the skills, traits and attributes in the table above, the better of a manager a dwarf will be. Try to avoid traits that halt experience gain for a relevant skill, otherwise time will be lost training a dwarf who will never get better at that skill.

==Office==
A manager only performs their duties in their office, so it's absolutely necessary to assign them one, though they only require a meager office.

To set up a dwarf to be the manager and give them an office:

#Open the Nobles screen by pressing {{K|n}} or the crown button on the bottom left toolbar.
#Select the {{K|+}} button next to Manager which will bring up a list of valid candidates in your fort; those with applicable skills will be at the top of the list. Click on the candidate of your choosing; if nobody is particularly suited to the job, picking the Expedition Leader is a reasonable choice. You will see that the Study icon (the chair symbol) for the Manager position is red, meaning their requirement for an office is not met. Exit the Nobles screen.
#Use the Zones tool {{K|z}} to paint an Office zone in a location and of a size you desire. Once the zone is placed, and while it is still selected, press the Assign dwarf button and choose the dwarf you've assigned to the Manager position to make this their office.
#Build a [[chair]] inside the Office zone you've placed. Other furniture can also be included if you wish to increase the room value, but it must at least have a chair.
#Once this is done, if you return to the Nobles screen you will see that the Study icon for the Manager position is now green, their need for an office met. You should now be able to queue up work orders.

It is trivially easy for a manager to get experience in the [[organizer]] skill. Just queue a lot of jobs to produce 30 of something, such as [[loom|Collect Webs]], which appears first on the list. The manager will gain experience when validating the order, not when the order is finished. You can cancel the order after it's validated, if you wish.

{{a|The manager screen}}

== Work orders ==
Work orders are an advanced feature of [[Workshop#Management|Workshop Management]] that becomes available with a manager. It allows easier management, automation and/or fine control of the various activities needed to maintain a well-oiled fort. The manager screen lists all work orders in the fortress, shows their status and allows to modify them and place new general orders. It is accessed from the main screen through the {{K|o}}rders menu, or the the clipboard icon in the bottom left of the screen.
For detailed usage, see: [[Work orders]]

Work orders can also be created that apply only to specific workshops. This is done using the clipboard button on the Work orders tab of the individual workshop's interface. See [[Workshop]] for more information.

==Disadvantages==
One disadvantage of the work order system is that once your fortress reaches 20 citizens, work orders will not be performed until they are validated by the manager. Work order validation appears to be fairly high priority, but it's best to ensure your manager has ample free time and isn't typically called far from the office for timely order validation.

A second disadvantage is that if there is more than one workshop which can fulfill a particular job set (such as several ordinary [[glass furnace]]s dedicated to [[sand]] collection, plus several [[magma glass furnace]]s for actual glass production) then the manager will distribute the jobs amongst all those workshops. While this can be an advantage (for example, if you want to speed up the work orders by having multiple workshops), this will make it difficult to dedicate different workshops to different tasks. This can be prevented by entering the interface of specific workshops and moving to the Work orders menu; setting "General work orders allowed" to 0 will prevent the manager from assigning tasks.

==Note==
In older versions of df, options could be set to restrict the allowed tasks at any workshop using Workshop Profiles. This feature needed the manager but has been removed.

==See also==
* [[Work Orders]]
* [[Workshop]]

{{gamedata| [POSITION:MANAGER]
[NAME:manager:managers]
[SITE]
[REQUIRES_MARKET]
[NUMBER:1]
[RESPONSIBILITY:MANAGE_PRODUCTION]
[APPOINTED_BY:EXPEDITION_LEADER]
[APPOINTED_BY:MAYOR]
[PRECEDENCE:160]
[DO_NOT_CULL]
[COLOR:5:0:0]
[DUTY_BOUND]
[REQUIRED_OFFICE:1]}}
{{Nobles}}
{{Category|Appointed Nobles}}
{{Category|Interface}}

Manager

2024-03-21T20:25:53Z

Putnam3145: /* Relevant Skills */ Managers use no social skills in the course of their work.

{{Quality|Unrated}}
{{av}}
{{Noble
|noble=Manager
|office=Meager Office
|function = *Allows large production orders.
|arrival= *Appointed on the [[nobles screen]].
}}

The '''manager''' is a useful [[noble]] that allows players to create multiple [[Work orders]], and also lets them set up profiles for workshops. This means that players can rapidly dispatch any number of jobs from a single screen, without having to add tasks to individual [[workshop]]s.

==Relevant Skills==
A certain set of skills are relevant for any manager. Furthermore, certain [[personality trait]]s influence whether any experience is gained in the skill. There are [[Attribute#Soul_Attributes|soul attributes]] that affect the skills, and other skills that affect the same attributes' cross-training. The ones relevant for a manager are as follows:
{| {{prettytable}}
|- style="background:#ddd"
! rowspan="2" colspan="2" | Skill (relevant for manager)
! rowspan="2" colspan="2" | Personality Trait (needed to gain social skill)
! colspan="2" | Attribute (affected by social skill)
|-
! style="width:1em" | Body
! style="width:1em" | Soul
|-
| rowspan="3" style="width:5em" | Organizer
| rowspan="3" style="width:5em" |
| rowspan="3" colspan="2" |
| rowspan="3" style="width:1em" |
| Analytical ability
|-
| Creativity
|-
| Social awareness
|}
The better match with the skills, traits and attributes in the table above, the better of a manager a dwarf will be. Try to avoid traits that halt experience gain for a relevant skill, otherwise time will be lost training a dwarf who will never get better at that skill. As of right now, organizer skills don't improve management work.

==Office==
A manager only performs their duties in their office, so it's absolutely necessary to assign them one, though they only require a meager office.

To set up a dwarf to be the manager and give them an office:

#Open the Nobles screen by pressing {{K|n}} or the crown button on the bottom left toolbar.
#Select the {{K|+}} button next to Manager which will bring up a list of valid candidates in your fort; those with applicable skills will be at the top of the list. Click on the candidate of your choosing; if nobody is particularly suited to the job, picking the Expedition Leader is a reasonable choice. You will see that the Study icon (the chair symbol) for the Manager position is red, meaning their requirement for an office is not met. Exit the Nobles screen.
#Use the Zones tool {{K|z}} to paint an Office zone in a location and of a size you desire. Once the zone is placed, and while it is still selected, press the Assign dwarf button and choose the dwarf you've assigned to the Manager position to make this their office.
#Build a [[chair]] inside the Office zone you've placed. Other furniture can also be included if you wish to increase the room value, but it must at least have a chair.
#Once this is done, if you return to the Nobles screen you will see that the Study icon for the Manager position is now green, their need for an office met. You should now be able to queue up work orders.

It is trivially easy for a manager to get experience in the [[organizer]] skill. Just queue a lot of jobs to produce 30 of something, such as [[loom|Collect Webs]], which appears first on the list. The manager will gain experience when validating the order, not when the order is finished. You can cancel the order after it's validated, if you wish.

{{a|The manager screen}}

== Work orders ==
Work orders are an advanced feature of [[Workshop#Management|Workshop Management]] that becomes available with a manager. It allows easier management, automation and/or fine control of the various activities needed to maintain a well-oiled fort. The manager screen lists all work orders in the fortress, shows their status and allows to modify them and place new general orders. It is accessed from the main screen through the {{K|o}}rders menu, or the the clipboard icon in the bottom left of the screen.
For detailed usage, see: [[Work orders]]

Work orders can also be created that apply only to specific workshops. This is done using the clipboard button on the Work orders tab of the individual workshop's interface. See [[Workshop]] for more information.

==Disadvantages==
One disadvantage of the work order system is that once your fortress reaches 20 citizens, work orders will not be performed until they are validated by the manager. Work order validation appears to be fairly high priority, but it's best to ensure your manager has ample free time and isn't typically called far from the office for timely order validation.

A second disadvantage is that if there is more than one workshop which can fulfill a particular job set (such as several ordinary [[glass furnace]]s dedicated to [[sand]] collection, plus several [[magma glass furnace]]s for actual glass production) then the manager will distribute the jobs amongst all those workshops. While this can be an advantage (for example, if you want to speed up the work orders by having multiple workshops), this will make it difficult to dedicate different workshops to different tasks. This can be prevented by entering the interface of specific workshops and moving to the Work orders menu; setting "General work orders allowed" to 0 will prevent the manager from assigning tasks.

==Note==
In older versions of df, options could be set to restrict the allowed tasks at any workshop using Workshop Profiles. This feature needed the manager but has been removed.

==See also==
* [[Work Orders]]
* [[Workshop]]

{{gamedata| [POSITION:MANAGER]
[NAME:manager:managers]
[SITE]
[REQUIRES_MARKET]
[NUMBER:1]
[RESPONSIBILITY:MANAGE_PRODUCTION]
[APPOINTED_BY:EXPEDITION_LEADER]
[APPOINTED_BY:MAYOR]
[PRECEDENCE:160]
[DO_NOT_CULL]
[COLOR:5:0:0]
[DUTY_BOUND]
[REQUIRED_OFFICE:1]}}
{{Nobles}}
{{Category|Appointed Nobles}}
{{Category|Interface}}

Template:V50 modding

2024-03-08T23:54:34Z

Putnam3145:

{{Sidebar
| name = Template:v50 modding
| title = [[Modding]]<hr>
| contentstyle = font-size: 12px; padding-left: 5px; text-align: center;

| heading1 = <big>[[Token]]s</big>
| content1 = [[Audio]]{{*}} [[Biome token|Biome]]{{*}} [[Graphics token|Graphics]]{{*}} [[Interaction token|Interaction]]{{*}} [[Mod info token|Mod info]]{{*}} [[Plant token|Plant]]{{*}} [[Speech file|Speech]]{{*}} [[Sphere#Sphere tokens|Sphere]]{{*}} [[Syndrome#The_anatomy_of_a_syndrome|Syndrome]]{{*}} [[World token|World]]

| heading2 = Body tokens
| content2 = [[Body token|Body]]{{*}} [[Body detail plan token|Body detail plan]]{{*}} [[Bodygloss]]{{*}} [[Tissue definition token|Tissue]]

| heading3 = Creature tokens
| content3 = [[Creature token|Creature]]{{*}} [[Creature mannerism token|Creature mannerism]]{{*}} [[Personality trait|Personality]]{{*}} [[Creature variation token|Creature variation]]{{*}} [[Procedural graphics layer]]

| heading4 = Descriptor tokens
| content4 = [[Descriptor color token|Descriptor color]]{{*}} [[Color]]{{*}} [[Descriptor pattern token|Descriptor pattern]]{{*}} [[Descriptor shape token|Descriptor shape]]

| heading5 = Entity tokens
| content5 = [[Entity token|Entity]]{{*}} [[Ethic]]{{*}} [[Language token|Language]]{{*}} [[Position token|Position]]

| heading6 = Job tokens
| content6 = [[Building token|Building]]{{*}} [[Labor token|Labor]]{{*}} [[Reaction]]{{*}} [[Skill token|Skill]]{{*}} [[Unit type token|Unit type]]

| heading7 = Item tokens
| content7 = [[Item token|Item type]]{{*}} [[Item definition token|Item definition]]{{*}} [[Ammo token|Ammo]]{{*}} [[Armor token|Armor]]{{*}} [[Instrument token|Instrument]]{{*}} [[Tool token|Tool]]{{*}} [[Trap component token|Trap component]]{{*}} [[Weapon token|Weapon]]

| heading8 = Material tokens
| content8 = [[Material token|Material type]]{{*}} [[Material definition token|Material definition]]{{*}} [[Inorganic material definition token|Inorganic material definition]]
}}

<includeonly>[[ru:{{PAGENAME}}]]</includeonly><noinclude>[[Category:Sidebars]][[Category:Navigation templates]]</noinclude>

Procedural graphics layer

2024-03-08T23:53:31Z

Putnam3145: Created page with "{{Quality|Unrated}} {{av}} {{Modding}} A list of all '''procedural graphics layer tokens''', used for PCG_LAYERING tokens. {| {{prettytable}}..."

{{Quality|Unrated}}
{{av}}
{{Modding}}

A list of all '''procedural graphics layer tokens''', used for [[Creature token#PCG_LAYERING|PCG_LAYERING]] tokens.

{| {{prettytable}} class="sortable"
|- style='background-color:#ddd'
! Token
|-
| {{text_anchor|BEAST_AMORPHOUS}}
|-
| {{text_anchor|BEAST_AMORPHOUS_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SNAKE}}
|-
| {{text_anchor|BEAST_SNAKE_MANDIBLES}}
|-
| {{text_anchor|BEAST_SNAKE_HORNS}}
|-
| {{text_anchor|BEAST_SNAKE_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SNAKE_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SNAKE_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SNAKE_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SNAKE_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SNAKE_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SNAKE_EYE_ONE}}
|-
| {{text_anchor|BEAST_SNAKE_EYE_TWO}}
|-
| {{text_anchor|BEAST_SNAKE_EYE_THREE}}
|-
| {{text_anchor|BEAST_SNAKE_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SNAKE_TRUNK}}
|-
| {{text_anchor|BEAST_SNAKE_ANTENNAE}}
|-
| {{text_anchor|BEAST_WORM_LONG}}
|-
| {{text_anchor|BEAST_WORM_LONG_MANDIBLES}}
|-
| {{text_anchor|BEAST_WORM_LONG_HORNS}}
|-
| {{text_anchor|BEAST_WORM_LONG_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_WORM_LONG_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_WORM_LONG_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_WORM_LONG_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_WORM_LONG_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_WORM_LONG_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_WORM_LONG_EYE_ONE}}
|-
| {{text_anchor|BEAST_WORM_LONG_EYE_TWO}}
|-
| {{text_anchor|BEAST_WORM_LONG_EYE_THREE}}
|-
| {{text_anchor|BEAST_WORM_LONG_SHELL_BACK}}
|-
| {{text_anchor|BEAST_WORM_LONG_TRUNK}}
|-
| {{text_anchor|BEAST_WORM_LONG_ANTENNAE}}
|-
| {{text_anchor|BEAST_WORM_SHORT}}
|-
| {{text_anchor|BEAST_WORM_SHORT_MANDIBLES}}
|-
| {{text_anchor|BEAST_WORM_SHORT_HORNS}}
|-
| {{text_anchor|BEAST_WORM_SHORT_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_WORM_SHORT_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_WORM_SHORT_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_WORM_SHORT_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_WORM_SHORT_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_WORM_SHORT_EYE_ONE}}
|-
| {{text_anchor|BEAST_WORM_SHORT_EYE_TWO}}
|-
| {{text_anchor|BEAST_WORM_SHORT_EYE_THREE}}
|-
| {{text_anchor|BEAST_WORM_SHORT_SHELL_BACK}}
|-
| {{text_anchor|BEAST_WORM_SHORT_TRUNK}}
|-
| {{text_anchor|BEAST_WORM_SHORT_ANTENNAE}}
|-
| {{text_anchor|BEAST_INSECT}}
|-
| {{text_anchor|BEAST_INSECT_MANDIBLES}}
|-
| {{text_anchor|BEAST_INSECT_HORNS}}
|-
| {{text_anchor|BEAST_INSECT_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_INSECT_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_INSECT_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_INSECT_EYE_ONE}}
|-
| {{text_anchor|BEAST_INSECT_EYE_TWO}}
|-
| {{text_anchor|BEAST_INSECT_EYE_THREE}}
|-
| {{text_anchor|BEAST_INSECT_PROBOSCIS}}
|-
| {{text_anchor|BEAST_INSECT_SHELL_BACK}}
|-
| {{text_anchor|BEAST_INSECT_TRUNK}}
|-
| {{text_anchor|BEAST_INSECT_ANTENNAE}}
|-
| {{text_anchor|BEAST_SPIDER}}
|-
| {{text_anchor|BEAST_SPIDER_MANDIBLES}}
|-
| {{text_anchor|BEAST_SPIDER_HORNS}}
|-
| {{text_anchor|BEAST_SPIDER_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SPIDER_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SPIDER_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SPIDER_EYE_ONE}}
|-
| {{text_anchor|BEAST_SPIDER_EYE_TWO}}
|-
| {{text_anchor|BEAST_SPIDER_EYE_THREE}}
|-
| {{text_anchor|BEAST_SPIDER_SHELL_FRONT}}
|-
| {{text_anchor|BEAST_SPIDER_TRUNK}}
|-
| {{text_anchor|BEAST_SPIDER_ANTENNAE}}
|-
| {{text_anchor|BEAST_SCORPION}}
|-
| {{text_anchor|BEAST_SCORPION_MANDIBLES}}
|-
| {{text_anchor|BEAST_SCORPION_HORNS}}
|-
| {{text_anchor|BEAST_SCORPION_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SCORPION_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SCORPION_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SCORPION_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SCORPION_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SCORPION_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SCORPION_EYE_ONE}}
|-
| {{text_anchor|BEAST_SCORPION_EYE_TWO}}
|-
| {{text_anchor|BEAST_SCORPION_EYE_THREE}}
|-
| {{text_anchor|BEAST_SCORPION_TAIL_ONE}}
|-
| {{text_anchor|BEAST_SCORPION_TAIL_TWO}}
|-
| {{text_anchor|BEAST_SCORPION_TAIL_THREE}}
|-
| {{text_anchor|BEAST_SCORPION_SHELL_FRONT}}
|-
| {{text_anchor|BEAST_SCORPION_TRUNK}}
|-
| {{text_anchor|BEAST_SCORPION_ANTENNAE}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_MANDIBLES}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_HORNS}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_EYE_ONE}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_EYE_TWO}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_EYE_THREE}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_TAIL_ONE}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_TAIL_TWO}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_TAIL_THREE}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_SHELL_BACK}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_TRUNK}}
|-
| {{text_anchor|BEAST_BIPEDAL_DINOSAUR_ANTENNAE}}
|-
| {{text_anchor|BEAST_HUMANOID}}
|-
| {{text_anchor|BEAST_HUMANOID_MANDIBLES}}
|-
| {{text_anchor|BEAST_HUMANOID_HORNS}}
|-
| {{text_anchor|BEAST_HUMANOID_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_HUMANOID_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_HUMANOID_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_HUMANOID_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_HUMANOID_EYE_ONE}}
|-
| {{text_anchor|BEAST_HUMANOID_EYE_TWO}}
|-
| {{text_anchor|BEAST_HUMANOID_EYE_THREE}}
|-
| {{text_anchor|BEAST_HUMANOID_TAIL_ONE}}
|-
| {{text_anchor|BEAST_HUMANOID_TAIL_TWO}}
|-
| {{text_anchor|BEAST_HUMANOID_TAIL_THREE}}
|-
| {{text_anchor|BEAST_HUMANOID_SHELL_BACK}}
|-
| {{text_anchor|BEAST_HUMANOID_TRUNK}}
|-
| {{text_anchor|BEAST_HUMANOID_ANTENNAE}}
|-
| {{text_anchor|BEAST_FRONT_GRASP}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_HEX}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_OCT}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_MANDIBLES}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_HORNS}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_EYE_ONE}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_EYE_TWO}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_EYE_THREE}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_TAIL_ONE}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_TAIL_TWO}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_TAIL_THREE}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_SHELL_BACK}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_TRUNK}}
|-
| {{text_anchor|BEAST_FRONT_GRASP_ANTENNAE}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_HEX}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_OCT}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_MANDIBLES}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_HORNS}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_EYE_ONE}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_EYE_TWO}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_EYE_THREE}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_TAIL_ONE}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_TAIL_TWO}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_TAIL_THREE}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_SHELL_FRONT}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_TRUNK}}
|-
| {{text_anchor|BEAST_QUADRUPED_BULKY_ANTENNAE}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_HEX}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_OCT}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_MANDIBLES}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_HORNS}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_EYE_ONE}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_EYE_TWO}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_EYE_THREE}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_TAIL_ONE}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_TAIL_TWO}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_TAIL_THREE}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_SHELL_FRONT}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_TRUNK}}
|-
| {{text_anchor|BEAST_QUADRUPED_SLINKY_ANTENNAE}}
|-
| {{text_anchor|BEAST_WALRUS}}
|-
| {{text_anchor|BEAST_WALRUS_MANDIBLES}}
|-
| {{text_anchor|BEAST_WALRUS_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_WALRUS_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_WALRUS_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_WALRUS_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_WALRUS_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_WALRUS_EYE_ONE}}
|-
| {{text_anchor|BEAST_WALRUS_EYE_TWO}}
|-
| {{text_anchor|BEAST_WALRUS_EYE_THREE}}
|-
| {{text_anchor|BEAST_WALRUS_TAIL_ONE}}
|-
| {{text_anchor|BEAST_WALRUS_TAIL_TWO}}
|-
| {{text_anchor|BEAST_WALRUS_TAIL_THREE}}
|-
| {{text_anchor|BEAST_WALRUS_SHELL_BACK}}
|-
| {{text_anchor|BEAST_WALRUS_TRUNK}}
|-
| {{text_anchor|BEAST_WALRUS_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_AMORPHOUS}}
|-
| {{text_anchor|BEAST_SMALL_AMORPHOUS_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_SNAKE_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_LONG_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_WORM_SHORT_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_INSECT}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_PROBOSCIS}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_INSECT_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_SHELL_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_SPIDER_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_TAIL_ONE}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_TAIL_TWO}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_TAIL_THREE}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_SHELL_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_SCORPION_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_TAIL_ONE}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_TAIL_TWO}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_TAIL_THREE}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_BIPEDAL_DINOSAUR_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_TAIL_ONE}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_TAIL_TWO}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_TAIL_THREE}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_HUMANOID_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_HEX}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_OCT}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_TAIL_ONE}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_TAIL_TWO}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_TAIL_THREE}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_FRONT_GRASP_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_HEX}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_OCT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_TAIL_ONE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_TAIL_TWO}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_TAIL_THREE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_SHELL_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_BULKY_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_HEX}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_OCT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_HORNS}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_WINGS_BAT_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_TAIL_ONE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_TAIL_TWO}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_TAIL_THREE}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_SHELL_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_QUADRUPED_SLINKY_ANTENNAE}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_MANDIBLES}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_WINGS_LACY_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_WINGS_LACY_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_WINGS_FEATHERED_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_WINGS_FEATHERED_FRONT}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_WINGS_BAT_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_EYE_ONE}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_EYE_TWO}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_EYE_THREE}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_TAIL_ONE}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_TAIL_TWO}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_TAIL_THREE}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_SHELL_BACK}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_TRUNK}}
|-
| {{text_anchor|BEAST_SMALL_WALRUS_ANTENNAE}}
|-
| {{text_anchor|WEREBEAST_ANTEATER}}
|-
| {{text_anchor|WEREBEAST_ANTELOPE}}
|-
| {{text_anchor|WEREBEAST_APE}}
|-
| {{text_anchor|WEREBEAST_ARMADILLO}}
|-
| {{text_anchor|WEREBEAST_BADGER}}
|-
| {{text_anchor|WEREBEAST_BEAR}}
|-
| {{text_anchor|WEREBEAST_BEAVER}}
|-
| {{text_anchor|WEREBEAST_BISON}}
|-
| {{text_anchor|WEREBEAST_BUFFALO}}
|-
| {{text_anchor|WEREBEAST_BULL}}
|-
| {{text_anchor|WEREBEAST_CAPYBARA}}
|-
| {{text_anchor|WEREBEAST_CAMEL}}
|-
| {{text_anchor|WEREBEAST_CAT}}
|-
| {{text_anchor|WEREBEAST_CAVY}}
|-
| {{text_anchor|WEREBEAST_CHAMELEON}}
|-
| {{text_anchor|WEREBEAST_CHINCHILLA}}
|-
| {{text_anchor|WEREBEAST_CIVET}}
|-
| {{text_anchor|WEREBEAST_COATI}}
|-
| {{text_anchor|WEREBEAST_COYOTE}}
|-
| {{text_anchor|WEREBEAST_DEER}}
|-
| {{text_anchor|WEREBEAST_DONKEY}}
|-
| {{text_anchor|WEREBEAST_ELEPHANT}}
|-
| {{text_anchor|WEREBEAST_ELK}}
|-
| {{text_anchor|WEREBEAST_FOX}}
|-
| {{text_anchor|WEREBEAST_GECKO}}
|-
| {{text_anchor|WEREBEAST_GILA_MONSTER}}
|-
| {{text_anchor|WEREBEAST_GIRAFFE}}
|-
| {{text_anchor|WEREBEAST_GOAT}}
|-
| {{text_anchor|WEREBEAST_GOPHER}}
|-
| {{text_anchor|WEREBEAST_HARE}}
|-
| {{text_anchor|WEREBEAST_HEDGEHOG}}
|-
| {{text_anchor|WEREBEAST_HORSE}}
|-
| {{text_anchor|WEREBEAST_HYENA}}
|-
| {{text_anchor|WEREBEAST_IGUANA}}
|-
| {{text_anchor|WEREBEAST_JACKAL}}
|-
| {{text_anchor|WEREBEAST_KANGAROO}}
|-
| {{text_anchor|WEREBEAST_KOALA}}
|-
| {{text_anchor|WEREBEAST_LEMUR}}
|-
| {{text_anchor|WEREBEAST_LIZARD}}
|-
| {{text_anchor|WEREBEAST_LLAMA}}
|-
| {{text_anchor|WEREBEAST_LORIS}}
|-
| {{text_anchor|WEREBEAST_MAMMOTH}}
|-
| {{text_anchor|WEREBEAST_MARMOT}}
|-
| {{text_anchor|WEREBEAST_MOLE}}
|-
| {{text_anchor|WEREBEAST_MONGOOSE}}
|-
| {{text_anchor|WEREBEAST_MONITOR_LIZARD}}
|-
| {{text_anchor|WEREBEAST_MOOSE}}
|-
| {{text_anchor|WEREBEAST_MONKEY}}
|-
| {{text_anchor|WEREBEAST_MOUSE}}
|-
| {{text_anchor|WEREBEAST_OPOSSUM}}
|-
| {{text_anchor|WEREBEAST_PANDA}}
|-
| {{text_anchor|WEREBEAST_PANGOLIN}}
|-
| {{text_anchor|WEREBEAST_PANTHER}}
|-
| {{text_anchor|WEREBEAST_PIG}}
|-
| {{text_anchor|WEREBEAST_PORCUPINE}}
|-
| {{text_anchor|WEREBEAST_RABBIT}}
|-
| {{text_anchor|WEREBEAST_RACCOON}}
|-
| {{text_anchor|WEREBEAST_RAT}}
|-
| {{text_anchor|WEREBEAST_RHINOCEROS}}
|-
| {{text_anchor|WEREBEAST_SHEEP}}
|-
| {{text_anchor|WEREBEAST_SHREW}}
|-
| {{text_anchor|WEREBEAST_SKINK}}
|-
| {{text_anchor|WEREBEAST_SKUNK}}
|-
| {{text_anchor|WEREBEAST_SLOTH}}
|-
| {{text_anchor|WEREBEAST_SQUIRREL}}
|-
| {{text_anchor|WEREBEAST_TAPIR}}
|-
| {{text_anchor|WEREBEAST_TORTOISE}}
|-
| {{text_anchor|WEREBEAST_WARTHOG}}
|-
| {{text_anchor|WEREBEAST_WEASEL}}
|-
| {{text_anchor|WEREBEAST_WOLF}}
|-
| {{text_anchor|WEREBEAST_WOMBAT}}
|-
| {{text_anchor|WEREBEAST_ZEBRA}}
|}

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

Creature token

2024-03-08T23:48:05Z

Putnam3145:

{{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 cast respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguish tokens that can be applied to creature only, cast 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 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
|
| Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.{{verify|code}}

|-
| {{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
|
| Found on {{token|LARGE_PREDATOR|c}}s who ambush their prey. Instead of charging relentlessly at prey, the predator will wait till the prey is within a few squares before charging. May or may not work on other creatures. {{verify}}

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

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

|-
| {{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}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{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.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.

|-
| {{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
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures. Not currently useful in Fortress mode as doors can no longer be set unpassable for pets.{{version|50.03}}

|-
| {{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. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{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
|
| Gives the creature a bonus in caves. Also causes [[cave adaptation]].

|-
| {{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 to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{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). 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}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

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

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets the creature to be active at twilight 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. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

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

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets the creature to be active during the day 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]. It's also possible for another creature to [[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 3x3 [[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 colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, 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}}. 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. 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).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

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

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

|}

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

|-
| {{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}}.

|-
| {{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
|
| The creature will generate light, such as in adventurer mode at night.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{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}}
|
|
| 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.

|-
| {{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
|
| Sets the creature to be active at dawn 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. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to 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_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]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}}

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless. Makes the creature 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. 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
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

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

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

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

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

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets the creature to be active at night in adventure mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. 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
|
| Cannot be [[butcher|butchered]].

|-
| {{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}}.

|-
| {{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
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{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 traits. Standard is 0:50:100. See [[Personality trait]] 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 not prevent a caste from spawning.

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

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons 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
|
| Unknown.

|-
| {{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}}
|
|
| 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:

[creature] [verb text] the [description of creature's location]

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
|
*text set
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*text set
| Boasting speeches relating to killing this creature. Examples include text_dwarf.txt and text_elf.txt in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

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

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

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|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 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. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{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. If a civilization uses a custom pack animal via ALWAYS_PACK, you must manually add a capacity to the raws of that creature itself. Capacity defaults to null leading to empty caravans.

|-
| {{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.{{verify}}

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

|-
| {{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. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per 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.

|-
| {{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. Speeds up decay?{{verify}}

|-
| {{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
|
| Sets the creature to be active during the evening 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; while all vanilla attacks use only BODYPART (e.g. ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP), there are other options available.

{| {{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, 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; 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; 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.

|}

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

Creature

2024-02-28T06:55:20Z

Putnam3145: /* Agitation */

{{Quality|Masterwork|14:19, 12 February 2023 (UTC)}}
{{av}}{{Category|Creatures}}
[[File:creatures_preview2.png|right]]In ''Dwarf Fortress'', a '''creature''' is defined as any animate, normally-mobile (and for the sake of this article, non-[[vermin]]) being that can interact with the world and any element inside it. The creatures in the game range from being entirely realistic to completely mythical. Although most creatures are animals, [[dwarf|dwarves]], [[giant cave spider]]s, and even [[megabeast]]s are all also considered creatures. Various creatures can and will interact with a fortress or adventurer in many different ways.

Some creatures have [[skill]]s that match what type of creature they are (e.g. [[monkey]]s having legendary climbing skill). Though most creatures can be found in any mode, some are exclusive to [[adventure mode]] or [[fortress mode]]. Some creatures are randomly and procedurally generated, meaning they could have many different sprites in-game. Creatures of that type may have just one to a few sprites showcased out of many in the list below. A question mark placeholder may also be shown instead.

Also note that creatures with the {{token|ARENA_RESTRICTED}} or {{token|DOES_NOT_EXIST}} tokens cannot be spawned in the [[object testing arena]], similarly to [[vermin]] (e.g. [[fly|flies]], [[worm]]s).

Many standard-sized creatures in the game take the space of a single tile, while many giant versions of creatures, including many types of beasts, may take up the space of more than one tile. There are roughly 680 creatures in the game.

==Spawning==
[[File:creatures_many.png|thumb|right|124px|Same concept, but in ASCII mode.]]The creatures that will spawn on any given fortress map depend on the biome(s) that the fortress is in. Additionally, there are several [[creature token|creature token]]s in the [[raws]] that deal with creature spawning:
*<tt>[FREQUENCY:X]</tt>: This tag dictates ''how often'' a creature will spawn. It ranges from 0-100, and is a comparative number, where the higher this number is, the more likely the creature is to spawn.
*<tt>[CLUSTER_NUMBER:X]</tt>: This determines ''how many'' creatures will appear at one time on a map.
*<tt>[POPULATION_NUMBER:X]</tt>: This determines the ''total number'' of this type of creature that can ever visit your fortress. The exact number varies, depending on the map.

For example, [[deer]] have a <tt>[POPULATION_NUMBER:15:30]</tt>, meaning that if you kill between 15-30 deer, no more deer will ever visit your fortress.

==Reading the Table==
{{v50_creaturecurrent table head}}
|}
The above columns indicate, in order:
* '''Graphic:''' The sprite assigned to the creature. Seen only in the [[Premium version|Steam version]].
* '''Tile:''' The tile assigned to the creature, how you will see it without a graphic set.
* '''Name:''' The name of the creature as it displays in-game.
* '''Playable:''' If "No", the creature is not playable in any modes. "Fort" indicates that the creature is playable in fortress mode ({{token|SITE_CONTROLLABLE|e}}). "Adv" indicates that the creature is playable in adventure mode. All creatures except humans must have a population in an {{token|ALL_MAIN_POPS_CONTROLLABLE|e}} civilization in order to be playable in adventure mode; goblins (and other creatures) cannot be played from a goblin civ. Humans can be played whether or not a population exists due to {{token|OUTSIDER_CONTROLLABLE|c}}, but an {{tt|[ALL_MAIN_POPS_CONTROLLABLE]}} civ still needs to have existed at some point. Creatures with {{token|LOCAL_POPS_CONTROLLABLE|c}} are also playable in adventure mode.
* '''Hostile:''' If "Yes", then the creature will attack on sight, if "No" then the creature is either neutral, or friendly. [[Undead]] creatures are always hostile to living things.
* '''Food Source:''' If "Yes", then the creature can be butchered into an [[meat|edible substance]] that your dwarves will feed on.
* '''Adult Body Size:''' The average [[size]] of the creature when an adult. This can be anywhere from 500 for a [[rabbit]] to 25,000,000 for a [[dragon]]. This value represents the creature's volume in cm3, which, for creatures made of flesh, more-or-less equals the creature's weight in grams.[http://www.bay12forums.com/smf/index.php?topic=30026.msg831163#msg831163] These sizes do not correspond to the sizes which trigger [[pressure plate]]s. Size is modified with height and broadness (i.e. incredibly skinny and short is below the average weight, while a fat and tall one is above it).
* '''Pet Value:''' This is the value the creature can be bought and sold for as a [[pet]] during [[trading]].
* '''Biome:''' Where the creature can be found.
* '''Features:''' Any special features the creature possesses, including things such as [[cave blob|causing a syndrome]], [[dragon|breathing fire]], or [[giant cave spider|spinning webs]].

Note: If you wish to view alternate ways of sorting creatures, such as sorting by biomes and location, or sorting domestic creatures by features, there is a new page found here: [[Alternate creature sorting]]

==Creatures==
===Civilized===
====Main races====
These are intelligent creatures that form the dominant [[civilisation|civilized]] races of the world. While most are part of society, many have turned to [[Bandits|Banditry]].

{{v50_creaturecurrent_table_head}}
{{v50_creaturecurrent_table_row|name=Dwarf|symbol=☺|color=3:0:0|playable=Fort, Adv|hostile=No|food=No|size=60,000|value=Not tameable|biome=[[Mountain halls]], [[Fortress|dwarf fortress]]es, [[hillock]]s|note=Trading race}}
{{v50_creaturecurrent table row|name=Elf|symbol=e|color=3:0:0|playable=Adv|hostile=Variable1|food=No|size=60,000|value=Not tameable|biome=[[Forest retreat]]s|note=Trading race}}
{{v50_creaturecurrent table row|name=Human|symbol=U|color=3:0:0|playable=Adv|hostile=Variable1|food=No|size=70,000|value=Not tameable|biome=[[Town]]s and [[hamlet]]s|note=Trading race}}
{{v50_creaturecurrent table row|name=Goblin|symbol=g|color=7:0:0|playable=Adv|hostile=Usually1|food=No|size=60,000|value=Not tameable|biome=[[Dark fortress]]es and [[dark pit]]s|note=Snatchers2}}
{{v50_creaturecurrent table row|name=Kobold|symbol=k|color=6:0:0|playable=Adv|hostile=Usually1|food=No|size=20,000|value=Not tameable|biome=[[Cave]]s|note=Skulking race}}
|}
:1. Whether or not you are hostile with select civilized races depends on the history of your game world, and its length. Shorter histories mean less ongoing wars and less general hostility, good for a newer player to learn the basics.
:2. Snatchers try to snatch children of other civilizations. Snatched individuals become part of the Snatcher's civilization.

==== Underground Tribes ====
Intelligent [[animal people]] that form crude civilizations underground, but will not trade with you. They wield some weapons and can join adventurers.

{{v50_creaturecurrent_table_head}}
{{v50_creaturecurrent_table_row|name=Amphibian man|symbol=a|color=6:0:0|playable=No|hostile=Variable1|food=No|size=20,000|value=Not tameable|biome=Underground|note=Amphibious}}
{{v50_creaturecurrent_table_row|name=Antman|symbol=a|color=0:0:1|playable=No|hostile=Variable1|food=No|size=Variable2|value=Not tameable|biome=Underground|note=Four castes}}
{{v50_creaturecurrent_table_row|name=Bat man|symbol=b|color=0:0:1|playable=Adv|hostile=Variable1|food=No|size=35,050|value=Not tameable|biome=Underground|note=Can fly}}
{{v50_creaturecurrent_table_row|name=Cave fish man|symbol=f|color=7:0:1|playable=Adv|hostile=Variable1|food=No|size=35,500|value=Not tameable|biome=Underground|note=Amphibious}}
{{v50_creaturecurrent_table_row|name=Cave swallow man|symbol=s|color=0:0:1|playable=Adv|hostile=Variable1|food=No|size=35,050|value=Not tameable|biome=Underground|note=Can fly}}
{{v50_creaturecurrent_table_row|name=Olm man|symbol=o|color=7:0:1|playable=Adv|hostile=Variable1|food=No|size=35,100|value=Not tameable|biome=Underground|note=Amphibious}}
{{v50_creaturecurrent_table_row|name=Reptile man|symbol=r|color=2:0:0|playable=No|hostile=Variable1|food=No|size=50,000|value=Not tameable|biome=Underground|note=Amphibious}}
{{v50_creaturecurrent_table_row|name=Rodent man|symbol=r|color=0:0:1|playable=No|hostile=Variable1|food=No|size=40,000|value=Not tameable|biome=Underground|note=}}
{{v50_creaturecurrent_table_row|name=Serpent man|symbol=s|color=7:0:1|playable=No|hostile=Variable1|food=No|size=50,000|value=Not tameable|biome=Underground|note=Amphibious; Causes [[Syndrome]]}}
|}
:1. Whether an animal person civilization treats you as hostile or not seems random. {{verify}}
:2. Ant-men body sizes depend on their caste.

=== Livestock and Domestic Animals ===


Creatures that have long been [[Domestic animal|domesticated]], and either play a part in the [[meat industry]], or are simply [[pet]]s to keep dwarves company. Note: Except for [[wagon]]s, domestic animals can be bought at embark, or requested from dwarven caravans. Animals of these types below that are caught in the wild with [[cage trap]]s can be tamed after only one session with an [[animal trainer]].

{{v50_creaturecurrent table head}}
{{v50_creaturecurrent table row|name=Alpaca|symbol=a|color=7:0:1|food=Yes|playable=No|hostile=No|size=70,000|value=200|biome=N/A|note=Domestic, milkable and can be sheared}}
{{v50_creaturecurrent table row|graphic=[[File:peafowls_sprite_anim.gif]]|name=
Blue peafowl|symbol=p|color=1:0:1|food=Yes|playable=No|hostile=No|size=4,000|value=10|biome=Tropical broadleaf forest|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Cat|symbol=c|color=0:0:1|food=Yes|playable=No|hostile=No|size=5,000|value=20|biome=N/A|note=Domestic}}
{{v50_creaturecurrent table row|name=Cavy|symbol=c|color=7:0:0|food=No|playable=No|hostile=No|size=800|value=3|biome=Tropical savanna, grassland, and shrubland|note=Domestic}}
{{v50_creaturecurrent table row|graphic=[[File:chickens_sprite_anim.gif]]|name=Chicken|symbol=c|color=6:0:0|food=Yes|playable=No|hostile=No|size=3,000|value=10|biome=N/A|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Cow|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=No|size=600,000|value=300|biome=N/A|note=Domestic and milkable}}
{{v50_creaturecurrent table row|graphic=[[File:dogs_sprite_anim.gif]]|name=Dog|symbol=d|color=6:0:0|food=Yes|playable=No|hostile=No|size=30,000|value=30|biome=N/A|note=Domestic and trainable}}
{{v50_creaturecurrent table row|graphic=[[File:ducks_sprite_anim.gif]]|name=Duck|symbol=d|color=2:0:0|food=No|playable=No|hostile=No|size=1,000|value=10|biome=Any lakes and any wetland|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Donkey|symbol=D|color=6:0:0|food=Yes|playable=No|hostile=No|size=300,000|value=200|biome=N/A|note=Domestic, milkable, pack animal}}
{{v50_creaturecurrent table row|name=Goat|symbol=g|color=6:0:0|food=Yes|playable=No|hostile=No|size=50,000|value=50|biome=N/A|note=Domestic and milkable}}
{{v50_creaturecurrent table row|name=Goose|symbol=g|color=7:0:1|food=Yes|playable=No|hostile=No|size=4,500|value=10|biome=Temperate lakes and temperate marshes|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Guineafowl|symbol=g|color=0:0:1|food=No|playable=No|hostile=No|size=1,500|value=10|biome=N/A|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Horse|symbol=H|color=7:0:0|food=Yes|playable=No|hostile=No|size=500,000|value=200|biome=N/A|note=Domestic, milkable, wagon puller, pack animal}}
{{v50_creaturecurrent table row|name=Llama|symbol=L|color=7:0:1|food=Yes|playable=No|hostile=No|size=180,000|value=200|biome=N/A|note=Domestic, milkable and can be sheared}}
{{v50_creaturecurrent table row|name=Mule|symbol=M|color=7:0:0|food=Yes|playable=No|hostile=No|size=400,000|value=200|biome=N/A|note=Domestic, pack animal}}
{{v50_creaturecurrent table row|name=One-humped camel|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=No|size=500,000|value=500|biome=Any desert|note=Domestic, milkable, pack animal}}
{{v50_creaturecurrent table row|name=Pig|symbol=p|color=5:0:1|food=Yes|playable=No|hostile=No|size=60,000|value=100|biome=N/A|note=Domestic and milkable}}
{{v50_creaturecurrent table row|name=Rabbit|symbol=r|color=6:0:0|food=No|playable=No|hostile=No|size=500|value=3|biome=Temperate savanna, grassland, and shrubland|note=Domestic}}
{{v50_creaturecurrent table row|name=Reindeer|symbol=R|color=6:0:0|food=Yes|playable=No|hostile=No|size=130,000|value=200|biome=Tundra and taiga|note=Domestic and milkable}}
{{v50_creaturecurrent table row|graphic=[[File:sheep_sprite_anim.gif]]|name=Sheep|symbol=s|color=7:0:1|food=Yes|playable=No|hostile=No|size=50,000|value=100|biome=N/A|note=Domestic, milkable and can be sheared}}
{{v50_creaturecurrent table row|name=Turkey|symbol=t|color=4:0:1|food=Yes|playable=No|hostile=No|size=5,000|value=10|biome=Temperate forest, swamp and shrubland|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Two-humped camel|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=No|size=500,000|value=500|biome=Any desert|note=Domestic, milkable, pack animal}}
{{v50_creaturecurrent table row|graphic=[[File:wagon_sprite.png|x40px]]|name=Wagon|symbol=W|color=6:0:0|food=No|playable=No|hostile=No|size=12,000|value=Not tameable|biome=|note=A special "creature" - see [[wagon|article]]}}
{{v50_creaturecurrent table row|name=Water buffalo|symbol=W|color=0:0:1|food=Yes|playable=No|hostile=No|size=1,000,000|value=200|biome=Tropical wetland|note=Domestic, milkable, wagon puller, pack animal}}
{{v50_creaturecurrent table row|name=Yak|symbol=Y|color=6:0:0|food=Yes|playable=No|hostile=No|size=700,000|value=200|biome=Mountains|note=Domestic, milkable, wagon puller, pack animal}}
|}

===Beasts and Monsters===
All kind of monstrous creatures that roam the land and underground caverns, including: [[Semi-megabeast]]s, [[megabeast]]s, and randomly generated ones that can take any form. all very powerful and can easily be game-ending.

====Semi-Megabeasts====


{{v50_creaturecurrent table head}}
{{v50_creaturecurrent table row|name=Cyclops|symbol=C|color=4:0:1|food=No|playable=No|hostile=Yes|size=8,000,000|value=Not tameable|biome=All land|note=One eyed}}
{{v50_creaturecurrent table row|name=Ettin|symbol=E|color=6:0:1|food=No|playable=No|hostile=Yes|size=8,000,000|value=Not tameable|biome=All land|note=Has two heads}}
{{v50_creaturecurrent table row|name=Giant|symbol=G|color=3:0:0|food=No|playable=No|hostile=Yes|size=9,000,000|value=Not tameable|biome=All land|note=}}
{{v50_creaturecurrent table row|name=Minotaur|symbol=M|color=6:0:0|food=No|playable=No|hostile=Yes|size=220,000|value=Not tameable|biome=All land|note=Starts with combat skill}}
|}

====Megabeasts====


{{v50_creaturecurrent table head}}
{{v50_creaturecurrent table row|name=
Bronze colossus|symbol=C|color=6:0:0|food=No|playable=No|hostile=Yes|size=20,000,000|value=Not tameable|biome=All land|note=Made of bronze, fairly hard to kill, drops masterwork [[bronze]] [[statue]] on death}}
{{v50_creaturecurrent table row|name=Dragon|symbol=D|color=2:0:0|food=Yes|playable=No|hostile=Yes|size=25,000,000|value=10000|biome=All land|note=Breathes fire, trainable}}
{{v50_creaturecurrent table row|name=Hydra|symbol=H|color=4:0:1|food=Yes|playable=No|hostile=Yes|size=8,000,000|value=10000|biome=All land|note=Has seven heads}}
{{v50_creaturecurrent table row|name=Roc|symbol=R|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=20,000,000|value=10000|biome=All land|note=Can fly, trainable}}
|}

====Procedurally generated====
These creatures are procedurally generated, and different for every savefile. Their raws may be extracted from the world.dat file in uncompressed save folders.
{{v50_creaturecurrent table head}}
{{v50_creaturecurrent table row|graphic=[[File:beast_sprites_preview_anim.gif]]|name=Forgotten beast|symbol=Any|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=10,000,000|value=Not tameable|biome=All underground|note=See article for more information}}
{{v50_creaturecurrent table row|graphic=[[File:beast_sprites_preview_anim.gif]]|name=Titan|symbol=Any|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=10,000,000|value=Not tameable|biome=All above-ground|note=See article for more information}}
|}

=== Wild Animals ===
This section includes wild [[animals]] as well as their giant and humanoid counterparts. Wild animals are mostly found roaming the wilderness. Many of them are predators, while others are benign, and will not attack unless being attacked first. Some will be drawn to your stockpiles to [[steals drink|steal drink]], [[Steals food|food]] or [[Steals items|something shiny]]. Some can be easily overcome, and yet others can be significant threats, like the dreaded [[elephant]].

====Above Ground====

{{v50_creaturecurrent table head|class="wikitable sortable"}}
{{v50_creaturecurrent table row|name=Aardvark|symbol=a|color=7:0:0|food=Yes|playable=No|hostile=No|size=50,000|value=50|biome=Tropical shrubland, tropical savanna, tropical grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Aardvark man|symbol=a|color=7:0:0|food=No|playable=Adv|hostile=No|size=60,000|value=50|biome=Tropical shrubland, tropical savanna, tropical grassland|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Adder|symbol=a|color=6:0:0|food=Yes|playable=No|hostile=No|size=150|value=50|biome=Temperate grassland, temperate savanna, temperate shrubland, any temperate forest, any temperate wetland|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Adder man|symbol=a|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,075|value=50|biome=Temperate grassland, temperate savanna, temperate shrubland, any temperate forest, any temperate wetland|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Alligator|symbol=A|color=2:0:0|playable=No|hostile=Yes|food=Yes|size=400,000|value=650|biome=Freshwater swamps, marshes, rivers|note=Amphibious}}
{{v50_creaturecurrent table row|name=Anaconda|symbol=A|color=2:0:1|food=Yes|playable=No|hostile=Yes|size=100,000|value=200|biome=Any tropical swamp|note=}}
{{v50_creaturecurrent table row|name=Anaconda man|symbol=A|color=2:0:1|food=No|playable=Adv|hostile=Yes|size=85,000|value=200|biome=Any tropical swamp|note=Animal person}}
{{v50_creaturecurrent table row|name=Anole man|symbol=a|color=2:0:1|food=No|playable=Adv|hostile=Yes|size=35,045|value=n/a|biome=Any tropical forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Armadillo|symbol=a|color=7:0:0|food=Yes|playable=No|hostile=No|size=7,500|value=20|biome=Tropical savanna, tropical grassland, tropical shrubland, any tropical forest|note=Benign}}
{{v50_creaturecurrent table row|name=Armadillo man|symbol=a|color=7:0:0|food=No|playable=Adv|hostile=No|size=38,750|value=20|biome=Tropical savanna, tropical grassland, tropical shrubland, any tropical forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Aye-aye|symbol=a|color=7:0:0|food=Yes|playable=No|hostile=No|size=2,500|value=50|biome=Tropical dry broadleaf forest, tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Aye-aye man|symbol=a|color=7:0:0|food=No|playable=Adv|hostile=No|size=36,250|value=50|biome=Tropical dry broadleaf forest, tropical moist broadleaf forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Badger|symbol=b|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=15,000|value=25|biome=Taiga, any temperate savanna, grassland, shrubland, forest|note=}}
{{v50_creaturecurrent table row|name=Badger man|symbol=b|color=7:0:0|food=No|playable=Adv|hostile=No|size=42,500|value=25|biome=Taiga, any temperate forest, temperate shrubland, temperate savanna, temperate grassland|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Bark scorpion man|symbol=s|color=6:0:1|food=No|playable=Adv|hostile=No|size=35,001|value=Not tameable|biome=Any desert, tropical grassland, tropical savanna, tropical shrubland, tropical conifer forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Barn owl|symbol=b|color=6:0:0|food=Yes|playable=No|hostile=No|size=500|value=25|biome=Any wetland, any temperate forest, tropical conifer forest, tropical dry broadleaf forest, any shrubland, any savanna, any grassland, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Barn owl man|symbol=b|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,250|value=25|biome=Any wetland, any temperate forest, tropical conifer forest, tropical dry broadleaf forest, any shrubland, any savanna, any grassland, any desert|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Beak dog|symbol=B|color=4:0:0|food=Yes|playable=No|hostile=Yes|size=150,000|value=50|biome=Evil marshes|note=Can be mounted by goblins}}
{{v50_creaturecurrent table row|name=Beetle man|symbol=b|color=4:0:0|food=No|playable=Adv|hostile=Yes|size=35,000|value=n/a|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Bilou|symbol=g|color=0:0:1|food=Yes|playable=No|hostile=No|size=6,000|value=500|biome=Tropical broadleaf forest|note=}}
{{v50_creaturecurrent_table_row|name=Black bear|symbol=B|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=120,000|value=300|biome=Taiga, temperate forest|note=Steals booze}}
{{v50_creaturecurrent_table_row|name=Black bear man|symbol=B|color=0:0:1|food=No|playable=Adv|hostile=Yes|size=95,000|value=n/a|biome=Forest taiga, any temperate forest|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Black mamba|symbol=s|color=0:0:1|food=Yes|playable=No|hostile=No|size=5,000|value=50|biome=Tropical savanna, tropical shrubland, any tropical forest, any tropical swamp|note=Lays eggs}}
{{v50_creaturecurrent_table_row|name=Black mamba man|symbol=s|color=0:0:1|food=No|playable=Adv|hostile=No|size=37,500|value=50|biome=Tropical savanna, tropical shrubland, any tropical forest, any tropical swamp|note=Animal person, Lays eggs}}
{{v50_creaturecurrent_table_row|name=Black-crested gibbon|symbol=g|color=0:0:1|food=Yes|playable=No|hostile=No|size=6,000|value=500|biome=Tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent_table_row|name=Black-handed gibbon|symbol=g|color=0:0:1|food=Yes|playable=No|hostile=No|size=6,000|value=500|biome=Tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent_table_row|name=Blizzard man|symbol=M|color=3:0:1|food=No|playable=No|hostile=Yes|size=300,000|value=Not tameable|biome=Tundra, glacier|note=}}
{{v50_creaturecurrent_table_row|graphic=[[File:peafowls_sprite_anim.gif]]|name=Blue peafowl|symbol=p|color=1:0:1|food=Yes|playable=No|hostile=No|size=4,000|value=10|biome=Tropical broadleaf forest|note=Domestic, lay eggs}}
{{v50_creaturecurrent_table_row|name=Bluejay man|symbol=b|color=1:0:1|food=No|playable=Adv|hostile=Yes|size=35,050|value=n/a|biome= Temperate grassland, temperate savanna, temperate shrubland, temperate broadleaf forest, temperate conifer forest|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Bobcat|symbol=b|color=6:0:0|food=Yes|playable=No|hostile=No|size=8,000|value=75|biome=Any forest, any desert, tropical freshwater swamp, tropical saltwater swamp, temperate freshwater swamp, temperate saltwater swamp, mangrove swamp, mountain|note=}}
{{v50_creaturecurrent_table_row|name=Bobcat man|symbol=b|color=6:0:0|food=No|playable=Adv|hostile=No|size=39,000|value=75|biome=Any forest, any desert, tropical freshwater swamp, tropical saltwater swamp, temperate freshwater swamp, temperate saltwater swamp, mangrove swamp, mountain|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Bonobo|symbol=b|color=0:0:1|food=Yes|playable=No|hostile=No|size=50,000|value=500|biome=Tropical broadleaf forest, shrubland|note=}}
{{v50_creaturecurrent_table_row|name=Brown recluse spider man|symbol=s|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Temperate broadleaf forest|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Bushmaster|symbol=s|color=6:0:0|food=Yes|playable=No|hostile=No|size=8,500|value=50|biome=Tropical moist broadleaf forest|note=Lays eggs}}
{{v50_creaturecurrent_table_row|name=Bushmaster man|symbol=s|color=6:0:0|food=No|playable=Adv|hostile=No|size=39,250|value=50|biome=Tropical moist broadleaf forest|note=Animal person, Lays eggs}}
{{v50_creaturecurrent_table_row|name=Bushtit man|symbol=b|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,002|value=30|biome=Any temperate forest|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent_table_row|name=Buzzard|symbol=b|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=1,400|value=30|biome=Any desert, temperate grassland, savanna, marsh|note=Steals food, lays eggs}}
{{v50_creaturecurrent_table_row|name=Buzzard man|symbol=b|color=0:0:1|food=No|playable=Adv|hostile=Yes|size=35,700|value=n/a|biome=Temperate freshwater marsh, temperate saltwater marsh, temperate grassland, temperate savanna, any desert|note=Animal person, lays eggs}}
{{v50_creaturecurrent_table_row|name=Capuchin|symbol=c|color=7:0:1|food=Yes|playable=No|hostile=No|size=3,500|value=50|biome=Any tropical forest, mangrove swamp|note=}}
{{v50_creaturecurrent_table_row|name=Capuchin man|symbol=c|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=36,750|value=50|biome=Any tropical forest, mangrove swamp|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Capybara|symbol=c|color=6:0:0|food=Yes|playable=No|hostile=No|size=45,000|value=100|biome=Any wetland|note=Makes sounds in Adventure mode}}
{{v50_creaturecurrent_table_row|name=Capybara man|symbol=c|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=57,499|value=100|biome=Any wetland|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Cardinal man|symbol=c|color=4:0:1|food=No|playable=Adv|hostile=Yes|size=35,025|value=n/a|biome= temperate grassland, temperate savanna, temperate shrubland, temperate broadleaf forest, temperate conifer forest |note=Animal person}}
{{v50_creaturecurrent_table_row|name=Cassowary|symbol=c|color=0:0:1|food=Yes|playable=No|hostile=No|size=50,000|value=100|biome=Tropical moist broadleaf forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent_table_row|name=Cassowary man|symbol=c|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=60,000|value=100|biome=Tropical moist broadleaf forest|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent_table_row|name=Cavy|symbol=c|color=7:0:0|food=No|playable=No|hostile=No|size=800|value=3|biome=Tropical savanna, grassland, shrubland|note=Domestic}}
{{v50_creaturecurrent_table_row|name=Chameleon man|symbol=c|color=2:0:1|food=No|playable=Adv|hostile=Yes|size=35,075|value=n/a|biome=Any tropical forest, shrubland tropical, savanna tropical, any desert|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Cheetah|symbol=c|color=6:0:1|playable=No|hostile=Yes|food=Yes|size=50,000|value=200|biome=Tropical savanna, grassland, shrubland|note=}}
{{v50_creaturecurrent_table_row|name=Cheetah man|symbol=c|color=6:0:1|food=No|playable=Adv|hostile=Yes|size=60,000|value=n/a|biome=tropical savanna, tropical grassland, tropical shrubland|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Chimpanzee|symbol=c|color=0:0:1|playable=No|hostile=No|food=Yes|size=50,000|value=500|biome=Tropical broadleaf forest, shrubland|note=}}
{{v50_creaturecurrent_table_row|name=Chinchilla|symbol=c|color=7:0:0|food=Yes|playable=No|hostile=No|size=500|value=3|biome=Mountain|note=Benign}}
{{v50_creaturecurrent_table_row|name=Chinchilla man|symbol=c|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=35,250|value=3|biome=Mountain|note=Animal person, Benign}}
{{v50_creaturecurrent_table_row|name=Chipmunk man|symbol=c|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=35,150|value=n/a|biome=Any temperate forest|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Coati|symbol=c|color=6:0:0|food=Yes|playable=No|hostile=No|size=6,000|value=50|biome=Any temperate forest, any tropical forest|note=}}
{{v50_creaturecurrent_table_row|name=Coati man|symbol=c|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=38,000|value=50|biome=Any temperate forest, any tropical forest|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Cockatiel man|symbol=c|color=7:0:1|food=No|playable=Adv|hostile=No|size=35,045|value=30|biome=Any desert, temperate grassland|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent_table_row|name=Copperhead snake|symbol=s|color=6:0:0|food=Yes|playable=No|hostile=No|size=500|value=50|biome=Temperate broadleaf forest, any temperate swamp|note=}}
{{v50_creaturecurrent_table_row|name=Copperhead snake man|symbol=s|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=35,250|value=50|biome=Temperate broadleaf forest, any temperate swamp|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Cougar|symbol=c|color=6:0:1|playable=No|hostile=Yes|food=Yes|size=60,000|value=100|biome=Any forest, any shrubland|note=}}
{{v50_creaturecurrent_table_row|name=Cougar man|symbol=c|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=65,000|value=n/a|biome=Any temperate forest, any tropical forest, temperate shrubland, tropical shrubland |note=Animal person}}
{{v50_creaturecurrent_table_row|name=Coyote|symbol=c|color=7:0:0|food=Yes|playable=No|hostile=No|size=15,000|value=50|biome=Mountain, tundra, taiga, any temperate forest, temperate savanna, temperate grassland, temperate shrubland, any temperate wetland, any desert|note=}}
{{v50_creaturecurrent_table_row|name=Coyote man|symbol=c|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=42,500|value=50|biome=Mountain, tundra, taiga, any temperate forest, temperate savanna, temperate grassland, temperate shrubland, any temperate wetland, any desert|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Crow man|symbol=c|color=0:0:1|food=No|playable=Adv|hostile=No|size=35,250|value=10|biome=Temperate grassland, temperate savanna, temperate shrubland, taiga, any temperate forest, any temperate wetland|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent_table_row|name=Dark gnome|symbol=g|color=3:0:0|food=No|playable=No|hostile=Yes|size=15,000|value=Not tameable|biome=Evil mountain|note=Steals booze}}
{{v50_creaturecurrent_table_row|graphic=[[File:deer_sprites_anim.gif]]|name=Deer|symbol=D|color=6:0:0|playable=No|hostile=No|food=Yes|size=140,000|value=50|biome=Taiga, temperate forest|note=Benign}}
{{v50_creaturecurrent_table_row|graphic=[[File:deer_man_sprites_anim.gif]]|name=Deer man|symbol=d|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=105,000|value=n/a|biome=Forest taiga, any temperate forest|note=Animal person}}
{{v50_creaturecurrent_table_row|name=Desert tortoise|symbol=t|color=6:0:0|food=Yes|playable=No|hostile=No|size=5,500|value=50|biome=Any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent_table_row|name=Desert tortoise man|symbol=t|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=37,750|value=50|biome=Any desert|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Dingo|symbol=d|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=20,000|value=50|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Dingo man|symbol=d|color=6:0:1|food=Yes|playable=Adv|hostile=Yes|size=45,000|value=50|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|graphic=[[File:ducks_sprite_anim.gif]]|name=Duck|symbol=d|color=2:0:0|food=No|playable=No|hostile=No|size=1,000|value=10|biome=Any lakes, any wetland|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Eagle|symbol=e|color=6:0:0|food=Yes|playable=No|hostile=No|size=4,000|value=25|biome=Any wetland, any forest, any shrubland, any savanna, any grassland, any desert, mountain, tundra|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Eagle man|symbol=e|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=37,000|value=25|biome=Any wetland, any forest, any shrubland, any savanna, any grassland, any desert, mountain, tundra|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Echidna|symbol=e|color=6:0:0|food=Yes|playable=No|hostile=No|size=10,000|value=50|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Echidna man|symbol=e|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=40,000|value=50|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland, any desert|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Elephant|symbol=E|color=7:0:0|food=Yes|playable=No|hostile=No|size=5,000,000|value=500|biome=Tropical forest, shrubland|note=Trainable}}
{{v50_creaturecurrent table row|name=Elephant man|symbol=E|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=2,535,000|value=n/a|biome=Any tropical forest, shrubland tropical|note=Animal person}}
{{v50_creaturecurrent table row|graphic=[[File:elk_sprites_anim.gif]]|name=Elk|symbol=E|color=6:0:0|food=Yes|playable=No|hostile=No|size=300,000|value=100|biome=Tundra, temperate grassland|note=}}
{{v50_creaturecurrent table row|graphic=[[File:elk_man_sprites_anim.gif]]|name=Elk man|symbol=E|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=185,000|value=n/a|biome=Tundra, temperate grassland |note=Animal person}}
{{v50_creaturecurrent table row|name=Emu|symbol=E|color=6:0:0|food=Yes|playable=No|hostile=No|size=35,000|value=100|biome=Temperate shrubland, any temperate forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Emu man|symbol=E|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=52,500|value=100|biome=Temperate shrubland, any temperate forest|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Firefly man|symbol=f|color=2:0:1|food=No|playable=Adv|hostile=Yes|size=35,000|value=n/a|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Fly man|symbol=f|color=0:0:1|food=No|playable=Adv|hostile=Yes|size=35,000|value=n/a|biome=Any non-freezing biome, any pool|note=}}
{{v50_creaturecurrent table row|name=Flying squirrel man|symbol=s|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,100|value=10|biome=Any temperate forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Foul blendec|symbol=b|color=0:0:1|food=No|playable=No|hostile=Yes|size=60,000|value=250|biome=Most evil forest|note=}}
{{v50_creaturecurrent table row|name=Fox|symbol=f|color=4:0:0|playable=No|hostile=No|food=Yes|size=6,000|value=25|biome=Taiga, temperate forest|note=}}
{{v50_creaturecurrent table row|name=Fox man|symbol=f|color=4:0:0|food=No|playable=Adv|hostile=Yes|size=38,000|value=n/a|biome=Forest taiga, any temperate forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Gazelle|symbol=g|color=6:0:0|playable=No|hostile=No|food=Yes|size=20,000|value=50|biome=Tropical savanna, grassland|note=}}
{{v50_creaturecurrent table row|name=Gazelle man|symbol=g|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=45,000|value=n/a|biome= Tropical savanna, tropical grassland|note=}}
{{v50_creaturecurrent table row|name=Giant aardvark|symbol=A|color=7:0:0|food=Yes|playable=No|hostile=No|size=560,000|value=500|biome=Tropical shrubland, tropical savanna, tropical grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Giant adder|symbol=A|color=6:0:0|food=Yes|playable=No|hostile=No|size=201,049|value=500|biome=Temperate grassland, temperate savanna, temperate shrubland, any temperate forest, any temperate wetland|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant anaconda|symbol=A|color=2:0:1|food=Yes|playable=No|hostile=Yes|size=933,000|value=500|biome=Any tropical swamp|note=}}
{{v50_creaturecurrent table row|name=Giant anole|symbol=A|color=2:0:1|food=Yes|playable=No|hostile=Yes|size=200,629|value=500|biome=Any tropical forest|note=}}
{{v50_creaturecurrent table row|name=Giant armadillo|symbol=A|color=7:0:0|food=Yes|playable=No|hostile=No|size=252,750|value=1000|biome=Tropical savanna, tropical grassland, tropical shrubland, any tropical forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant aye-aye|symbol=A|color=7:0:0|food=Yes|playable=No|hostile=No|size=217,525|value=500|biome=Tropical dry broadleaf forest, tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant badger|symbol=B|color=7:0:0|food=Yes|playable=No|hostile=No|size=306,000|value=500|biome=Taiga, any temperate forest, temperate shrubland, temperate savanna, temperate grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Giant bark scorpion|symbol=S|color=6:0:1|food=No|playable=No|hostile=No|size=200,021|value=500|biome=Any desert, tropical grassland, tropical savanna, tropical shrubland, tropical conifer forest|note=}}
{{v50_creaturecurrent table row|name=Giant barn owl|symbol=B|color=6:0:0|food=Yes|playable=No|hostile=No|size=203,500|value=500|biome=Any wetland, any temperate forest, tropical conifer forest, tropical dry broadleaf forest, any shrubland, any savanna, any grassland, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant beetle|symbol=B|color=4:0:0|food=Yes|playable=No|hostile=Yes|size=200,007|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant black bear|symbol=B|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=1,084,800|value=500|biome=Forest taiga, any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Giant black mamba|symbol=S|color=0:0:1|food=Yes|playable=No|hostile=No|size=235,100|value=500|biome=Tropical savanna, tropical shrubland, any tropical forest, any tropical swamp|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant bluejay|symbol=B|color=1:0:1|food=Yes|playable=No|hostile=Yes|size=200,700|value=500|biome=Temperate grassland, temperate savanna, temperate shrubland, temperate broadleaf forest, temperate conifer forest |note=}}
{{v50_creaturecurrent table row|name=Giant bobcat|symbol=B|color=6:0:0|food=Yes|playable=No|hostile=No|size=256,320|value=500|biome=Any forest, any desert, tropical freshwater swamp, tropical saltwater swamp, temperate freshwater swamp, temperate saltwater swamp, mangrove swamp, mountain|note=}}
{{v50_creaturecurrent table row|name=Giant brown recluse spider|symbol=S|color=6:0:0|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Temperate broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Giant bushmaster|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=259,845|value=500|biome=Tropical moist broadleaf forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant bushtit|symbol=B|color=6:0:0|food=No|playable=No|hostile=No|size=200,035|value=500|biome=Any temperate forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant buzzard|symbol=B|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=209,804|value=500|biome=Temperate freshwater marsh, temperate saltwater marsh, temperate grassland, temperate savanna, any desert|note=}}
{{v50_creaturecurrent table row|name=Giant capuchin|symbol=C|color=7:0:1|food=Yes|playable=No|hostile=No|size=224,560|value=500|biome=Any tropical forest, mangrove swamp|note=}}
{{v50_creaturecurrent table row|name=Giant capybara|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=No|size=523,350|value=500|biome=Any wetland|note=Makes sounds in Adventure mode}}
{{v50_creaturecurrent table row|name=Giant cardinal|symbol=C|color=4:0:1|food=Yes|playable=No|hostile=Yes|size=200,350|value=500|biome=Temperate grassland, temperate savanna, temperate shrubland, temperate broadleaf forest, temperate conifer forest |note=}}
{{v50_creaturecurrent table row|name=Giant cassowary|symbol=C|color=0:0:1|food=Yes|playable=No|hostile=No|size=560,000|value=500|biome=Tropical moist broadleaf forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant chameleon|symbol=C|color=2:0:1|food=Yes|playable=No|hostile=Yes|size=201,049|value=500|biome=Any tropical forest, shrubland tropical, savanna tropical, any desert|note=}}
{{v50_creaturecurrent table row|name=Giant cheetah|symbol=C|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=560,000|value=500|biome=Tropical savanna, grassland, shrubland|note=Trainable}}
{{v50_creaturecurrent table row|name=Giant chinchilla|symbol=C|color=7:0:0|food=Yes|playable=No|hostile=No|size=203,500|value=500|biome=Mountain|note=Benign}}
{{v50_creaturecurrent table row|name=Giant chipmunk|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=202,101|value=500|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Giant coati|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=No|size=242,160|value=500|biome=Any temperate forest, any tropical forest|note=}}
{{v50_creaturecurrent table row|name=Giant cockatiel|symbol=C|color=7:0:1|food=No|playable=No|hostile=No|size=200,629|value=500|biome=Any desert, temperate grassland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant copperhead snake|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=203,500|value=500|biome=Temperate broadleaf forest, any temperate swamp|note=}}
{{v50_creaturecurrent table row|name=Giant cougar|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=633,600|value=500|biome=Any temperate forest, any tropical forest, shrubland temperate, shrubland tropical|note=}}
{{v50_creaturecurrent table row|name=Giant coyote|symbol=C|color=7:0:0|food=Yes|playable=No|hostile=No|size=306,000|value=500|biome=Mountain, tundra, taiga, any temperate forest, temperate savanna, temperate grassland, temperate shrubland, any temperate wetland, any desert|note=}}
{{v50_creaturecurrent table row|name=Giant crow|symbol=C|color=0:0:1|food=No|playable=No|hostile=No|size=203,500|value=500|biome=Temperate grassland, temperate savanna, temperate shrubland, taiga, any temperate forest, any temperate wetland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant deer|symbol=D|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=1,237,600|value=500|biome=Forest taiga, any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Giant desert scorpion|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=200,000|value=2500|biome=Savage desert|note=No pain, no stun, no emotion; deadly [[Syndrome]]. '''No longer exists past [[Release_information/0.42.06|0.42.06]].'''}}
{{v50_creaturecurrent table row|name=Giant desert tortoise|symbol=T|color=6:0:0|food=Yes|playable=No|hostile=No|size=238,645|value=500|biome=Any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant dingo|symbol=D|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=341,800|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant eagle|symbol=E|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=228,040|value=500|biome=Savage mountain|note=Trainable}}
{{v50_creaturecurrent table row|name=Giant echidna|symbol=E|color=6:0:0|food=Yes|playable=No|hostile=No|size=270,500|value=500|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant elephant|symbol=E|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=40,000,000|value=500|biome=Any tropical forest, tropical shrubland |note=}}
{{v50_creaturecurrent table row|name=Giant elk|symbol=E|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=2,478,000|value=500|biome=Tundra, temperate grassland |note=}}
{{v50_creaturecurrent table row|name=Giant emu|symbol=E|color=6:0:0|food=Yes|playable=No|hostile=No|size=450,100|value=500|biome=Temperate shrubland, any temperate forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant firefly|symbol=F|color=2:0:1|food=Yes|playable=No|hostile=Yes|size=200,007|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant fly|symbol=F|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=200,007|value=500|biome=Any non-freezing biome, any pool|note=}}
{{v50_creaturecurrent table row|name=Giant flying squirrel|symbol=S|color=6:0:0|food=No|playable=No|hostile=No|size=201,400|value=500|biome=Any temperate forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant fox|symbol=F|color=4:0:0|food=Yes|playable=No|hostile=Yes|size=242,160|value=500|biome=Forest taiga, any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Giant gazelle|symbol=G|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=341,800|value=500|biome=savanna tropical, grassland tropical|note=}}
{{v50_creaturecurrent table row|name=Giant gila monster|symbol=G|color=4:0:1|food=Yes|playable=No|hostile=No|size=214,020|value=500|biome=Any desert|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant giraffe|symbol=G|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=8,030,000|value=500|biome=tropical savanna, tropical shrubland |note=}}
{{v50_creaturecurrent table row|name=Giant grackle|symbol=G|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=200,840|value=500|biome=temperate grassland, temperate savanna |note=}}
{{v50_creaturecurrent table row|name=Giant grasshopper|symbol=G|color=2:0:1|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=Benign}}
{{v50_creaturecurrent table row|name=Giant gray langur|symbol=L|color=7:0:0|food=Yes|playable=No|hostile=No|size=306,000|value=500|biome=Any desert, any grassland, any savanna, any shrubland, any forest|note=}}
{{v50_creaturecurrent table row|name=Giant gray squirrel|symbol=S|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=202,101|value=500|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Giant great horned owl|symbol=O|color=7:0:0|food=Yes|playable=No|hostile=No|size=214,020|value=500|biome=Any forest, any shrubland, any savanna, any grassland, any desert, mangrove swamp, mountain, tundra|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant green tree frog|symbol=F|color=2:0:1|food=No|playable=No|hostile=No|size=200,700|value=500|biome=Temperate freshwater pool, temperate freshwater lake, temperate freshwater swamp, temperate freshwater marsh|note=Benign}}
{{v50_creaturecurrent table row|name=Giant grey parrot|symbol=P|color=7:0:0|food=Yes|playable=No|hostile=No|size=202,800|value=500|biome=Tropical moist broadleaf forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant grizzly bear|symbol=B|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=1,700,000|value=500|biome=Forest taiga, any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Giant groundhog|symbol=G|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=221,040|value=500|biome=Temperate shrubland, temperate savanna, temperate grassland |note=}}
{{v50_creaturecurrent table row|name=Giant hamster|symbol=H|color=7:0:0|food=No|playable=No|hostile=No|size=201,049|value=500|biome=Any non-freezing biome|note=Benign}}
{{v50_creaturecurrent table row|name=Giant hare|symbol=H|color=6:0:0|food=Yes|playable=No|hostile=No|size=224,560|value=500|biome=Temperate savanna, temperate grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Giant hedgehog|symbol=H|color=6:0:0|food=No|playable=No|hostile=No|size=205,600|value=500|biome=Temperate shrubland, temperate savanna|note=Benign}}
{{v50_creaturecurrent table row|name=Giant hippo|symbol=H|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=12,030,000|value=500|biome=tropical saltwater river, tropical brackishwater river, tropical freshwater river, tropical saltwater lake, tropical brackishwater lake, tropical freshwater lake|note=}}
{{v50_creaturecurrent table row|name=Giant hoary marmot|symbol=M|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=270,500|value=500|biome=Mountain|note=}}
{{v50_creaturecurrent table row|name=Giant honey badger|symbol=B|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=298,900|value=500|biome=Any tropical forest, tropical shrubland, tropical savanna, tropical grassland, any tropical wetland, any desert|note=}}
{{v50_creaturecurrent table row|name=Giant hornbill|symbol=H|color=0:0:1|food=Yes|playable=No|hostile=No|size=217,525|value=500|biome=Any tropical forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant hyena|symbol=H|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=633,600|value=500|biome=Tropical savanna, tropical grassland, tropical shrubland|note=}}
{{v50_creaturecurrent table row|name=Giant ibex|symbol=I|color=6:0:0|food=Yes|playable=No|hostile=No|size=560,000|value=500|biome=Any grassland, any desert|note=Benign}}
{{v50_creaturecurrent table row|name=Giant iguana|symbol=I|color=2:0:1|food=Yes|playable=No|hostile=Yes|size=228,040|value=500|biome=Any tropical forest|note=}}
{{v50_creaturecurrent table row|name=Giant impala|symbol=I|color=6:0:0|food=Yes|playable=No|hostile=No|size=560,000|value=500|biome=Tropical savanna, tropical grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Giant jackal|symbol=J|color=6:0:0|food=Yes|playable=No|hostile=No|size=306,000|value=500|biome=Tropical shrubland, tropical savanna, tropical grassland|note=}}
{{v50_creaturecurrent table row|name=Giant jaguar|symbol=J|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=745,500|value=500|biome=Savage tropical areas, any desert|note=Trainable}}
{{v50_creaturecurrent table row|name=Giant jumping spider|symbol=J|color=0:0:1|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant kakapo|symbol=K|color=2:0:0|food=Yes|playable=No|hostile=No|size=221,040|value=500|biome=Temperate shrubland, temperate savanna, temperate grassland, any temperate forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant kangaroo|symbol=K|color=6:0:0|food=Yes|playable=No|hostile=No|size=857,700|value=500|biome=Temperate grassland, temperate savanna, temperate shrubland, any desert|note=Benign}}
{{v50_creaturecurrent table row|name=Giant kea|symbol=K|color=2:0:0|food=Yes|playable=No|hostile=No|size=207,010|value=500|biome=Any temperate forest, temperate shrubland, mountain|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant kestrel|symbol=K|color=4:0:0|food=Yes|playable=No|hostile=No|size=201,750|value=500|biome=Tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh, any shrubland, any savanna, any grassland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant king cobra|symbol=K|color=0:0:1|food=Yes|playable=No|hostile=No|size=242,160|value=500|biome=Any tropical forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant kingsnake|symbol=K|color=7:0:1|food=Yes|playable=No|hostile=No|size=210,510|value=500|biome=Any temperate forest, temperate shrubland, mountain, any desert|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant kiwi|symbol=K|color=6:0:0|food=Yes|playable=No|hostile=No|size=217,525|value=1000|biome=Any temperate forest, temperate shrubland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant koala|symbol=K|color=7:0:0|food=Yes|playable=No|hostile=No|size=270,500|value=500|biome=Temperate broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant leopard|symbol=L|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=560,000|value=500|biome=Savage tropical areas, any desert|note=Trainable}}
{{v50_creaturecurrent table row|name=Giant leopard gecko|symbol=G|color=6:0:1|food=No|playable=No|hostile=No|size=200,350|value=500|biome=Any desert|note=}}
{{v50_creaturecurrent table row|name=Giant lion|symbol=L|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=1,700,000|value=500|biome=Tropical savanna, Tropical grassland, Tropical shrubland |note=Trainable}}
{{v50_creaturecurrent table row|name=Giant lion tamarin|symbol=L|color=6:0:1|food=No|playable=No|hostile=No|size=204,302|value=500|biome=Tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant lizard|symbol=L|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=201,400|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant lorikeet|symbol=L|color=4:0:1|food=No|playable=No|hostile=No|size=201,400|value=500|biome=Tropical moist broadleaf forest, mangrove swamp|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant louse|symbol=L|color=6:0:0|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant lynx|symbol=L|color=6:0:0|food=Yes|playable=No|hostile=No|size=377,750|value=500|biome=Taiga|note=}}
{{v50_creaturecurrent table row|name=Giant magpie|symbol=M|color=0:0:1|food=No|playable=No|hostile=No|size=201,400|value=500|biome=Temperate grassland, temperate savanna, temperate shrubland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant mandrill|symbol=M|color=1:0:1|food=Yes|playable=No|hostile=Yes|size=341,800|value=500|biome=Tropical moist broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Giant mantis|symbol=M|color=2:0:1|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant masked lovebird|symbol=L|color=2:0:1|food=No|playable=No|hostile=No|size=200,629|value=500|biome=Any tropical forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant monarch butterfly|symbol=B|color=4:0:1|food=Yes|playable=No|hostile=Yes|size=200,007|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant mongoose|symbol=M|color=7:0:0|food=Yes|playable=No|hostile=No|size=221,040|value=500|biome=Tropical savanna, tropical shrubland|note=Benign}}
{{v50_creaturecurrent table row|name=Giant monitor lizard|symbol=M|color=6:0:0|food=Yes|playable=No|hostile=No|size=933,000|value=500|biome=Tropical grassland, tropical savanna, tropical shrubland, any tropical forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant moose|symbol=M|color=6:0:0|food=Yes|playable=No|hostile=No|size=4,257,750|value=1000|biome=Taiga, any temperate forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant mosquito|symbol=M|color=0:0:1|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome, any pool|note=}}
{{v50_creaturecurrent table row|name=Giant moth|symbol=M|color=6:0:0|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=Benign}}
{{v50_creaturecurrent table row|name=Giant mountain goat|symbol=G|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=560,000|value=500|biome=Mountain|note=}}
{{v50_creaturecurrent table row|name=Giant muskox|symbol=M|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=2,362,650|value=500|biome=Tundra, temperate grassland |note=}}
{{v50_creaturecurrent table row|name=Giant ocelot|symbol=O|color=6:0:1|food=Yes|playable=No|hostile=No|size=377,750|value=500|biome=Any tropical forest, mangrove swamp, tropical savanna, tropical grassland|note=}}
{{v50_creaturecurrent table row|name=Giant one-humped camel|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=4,055,000|value=500|biome=any desert|note=}}
{{v50_creaturecurrent table row|name=Giant opossum|symbol=O|color=7:0:0|food=Yes|playable=No|hostile=No|size=221,040|value=500|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Giant oriole|symbol=O|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=200,280|value=500|biome=Temperate broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Giant osprey|symbol=O|color=7:0:1|food=Yes|playable=No|hostile=No|size=214,020|value=500|biome=Any ocean, any lake, any river, tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant ostrich|symbol=O|color=0:0:1|food=Yes|playable=No|hostile=No|size=857,700|value=1000|biome=Tropical savanna, tropical grassland, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant pangolin|symbol=P|color=6:0:0|food=Yes|playable=No|hostile=No|size=235,100|value=500|biome=Tropical grassland, tropical savanna, tropical shrubland, any tropical forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant parakeet|symbol=P|color=2:0:1|food=No|playable=No|hostile=No|size=200,840|value=500|biome=Tropical grassland, tropical savanna, tropical shrubland, any tropical forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant peach-faced lovebird|symbol=L|color=2:0:1|food=No|playable=No|hostile=No|size=200,419|value=500|biome=Temperate grassland, temperate savanna, temperate shrubland, temperate broadleaf forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant peregrine falcon|symbol=P|color=6:0:0|food=Yes|playable=No|hostile=No|size=113,292|value=500|biome=Any wetland, any temperate forest, tropical conifer forest, tropical dry broadleaf forest, taiga, any shrubland, any savanna, any grassland, any desert, mountain, tundra|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant polar bear|symbol=B|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=3,268,000|value=500|biome=Glacier, tundra|note=}}
{{v50_creaturecurrent table row|name=Giant porcupine|symbol=P|color=6:0:0|food=Yes|playable=No|hostile=No|size=263,430|value=500|biome=Temperate shrubland, temperate savanna, temperate grassland, temperate conifer forest, taiga, any desert, tundra|note=Benign}}
{{v50_creaturecurrent table row|name=Giant python|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=1,700,000|value=500|biome=Tropical moist broadleaf forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant raccoon|symbol=R|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=249,270|value=500|biome=Taiga forest, any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Giant rattlesnake|symbol=S|color=7:0:0|food=Yes|playable=No|hostile=No|size=249,270|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant raven|symbol=R|color=0:0:1|food=No|playable=No|hostile=No|size=208,403|value=500|biome=Temperate grassland, temperate savanna, temperate shrubland, taiga, any temperate forest, any temperate wetland, tundra, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant red panda|symbol=P|color=4:0:0|food=Yes|playable=No|hostile=No|size=235,100|value=500|biome=Any temperate forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant red squirrel|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=202,101|value=500|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Giant rhesus macaque|symbol=M|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=235,100|value=500|biome=Shrubland temperate, savanna temperate, grassland temperate|note=}}
{{v50_creaturecurrent table row|name=Giant rhinoceros|symbol=R|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=24,000,000|value=500|biome=Grassland tropical, savanna tropical, shrubland tropical|note=}}
{{v50_creaturecurrent table row|name=Giant roach|symbol=R|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=200,007|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant skink|symbol=S|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=203,500|value=500|biome=Any temperate, any tropical, any desert|note=}}
{{v50_creaturecurrent table row|name=Giant skunk|symbol=S|color=0:0:1|food=Yes|playable=No|hostile=No|size=228,040|value=500|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Giant sloth|symbol=S|color=7:0:0|food=Yes|playable=No|hostile=No|size=242,160|value=500|biome=Any tropical forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant sloth bear|symbol=B|color=0:0:1|food=Yes|playable=No|hostile=No|size=933,000|value=500|biome=Any tropical forest|note=}}
{{v50_creaturecurrent table row|name=Giant slug|symbol=S|color=6:0:0|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=Benign}}
{{v50_creaturecurrent table row|name=Giant snail|symbol=S|color=7:0:0|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=Benign}}
{{v50_creaturecurrent table row|name=Giant snowy owl|symbol=O|color=7:0:1|food=Yes|playable=No|hostile=No|size=214,020|value=500|biome=Tundra|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant sparrow|symbol=S|color=6:0:0|food=No|playable=No|hostile=No|size=200,210|value=500|biome=Any grassland, any savanna, any shrubland, any temperate forest, any tropical forest, any desert, any wetland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant spider monkey|symbol=M|color=0:0:1|food=Yes|playable=No|hostile=No|size=259,845|value=500|biome=Tropical moist broadleaf forest, tropical dry broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant stoat|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=202,450|value=500|biome=Taiga, tundra|note=Benign}}
{{v50_creaturecurrent table row|name=Giant swan|symbol=S|color=7:0:1|food=Yes|playable=No|hostile=No|size=270,500|value=500|biome=Any temperate lake, any temperate marsh|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant tapir|symbol=T|color=7:0:1|food=Yes|playable=No|hostile=No|size=1,700,000|value=500|biome=Tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Giant thrips|symbol=T|color=6:0:0|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=Benign}}
{{v50_creaturecurrent table row|name=Giant tick|symbol=T|color=6:0:0|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Giant tiger|symbol=T|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=1,894,500|value=500|biome=Some savage tropical areas|note=Trainable}}
{{v50_creaturecurrent table row|name=Giant tortoise|symbol=T|color=6:0:0|food=Yes|playable=No|hostile=No|size=300,000|value=50|biome=Tropical shrubland, tropical savanna|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant tortoise man|symbol=T|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=185,000|value=50|biome=Tropical shrubland, tropical savanna|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant two-humped camel|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=4,055,000|value=500|biome=any desert|note=}}
{{v50_creaturecurrent table row|name=Giant vulture|symbol=V|color=4:0:0|food=Yes|playable=No|hostile=Yes|size=263,430|value=500|biome=Grassland tropical, savanna tropical, any desert|note=}}
{{v50_creaturecurrent table row|name=Giant warthog|symbol=W|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=933,000|value=500|biome=Savanna tropical, grassland tropical, shrubland tropical|note=}}
{{v50_creaturecurrent table row|name=Giant weasel|symbol=W|color=6:0:0|food=Yes|playable=No|hostile=No|size=201,400|value=500|biome=Any land|note=Benign}}
{{v50_creaturecurrent table row|name=Giant white stork|symbol=S|color=7:0:1|food=Yes|playable=No|hostile=No|size=221,040|value=500|biome=Any grassland, any wetland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant wild boar|symbol=B|color=6:0:0|food=Yes|playable=No|hostile=No|size=783,199|value=500|biome=Any savanna, any grassland, any shrubland, any forest, any wetland|note=Benign}}
{{v50_creaturecurrent table row|name=Giant wolf|symbol=W|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=486,800|value=500|biome=Tundra, forest taiga, any temperate forest, shrubland temperate|note=}}
{{v50_creaturecurrent table row|name=Giant wolverine|symbol=W|color=6:0:0|food=Yes|playable=No|hostile=No|size=341,800|value=500|biome=Taiga, mountain|note=Benign}}
{{v50_creaturecurrent table row|name=Giant wombat|symbol=W|color=6:0:0|food=Yes|playable=No|hostile=No|size=377,750|value=500|biome=Any temperate forest, temperate shrubland, mountain|note=Benign}}
{{v50_creaturecurrent table row|name=Giant wren|symbol=W|color=6:0:0|food=No|playable=No|hostile=No|size=200,280|value=500|biome=Any forest, any grassland, any savanna, any shrubland, any wetland, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Gigantic panda|symbol=P|color=7:0:1|food=Yes|playable=No|hostile=No|size=1,160,900|value=1000|biome=Temperate forest|note=Trainable}}
{{v50_creaturecurrent table row|name=Gigantic tortoise|symbol=T|color=6:0:0|food=Yes|playable=No|hostile=No|size=2,478,000|value=1500|biome=Tropical shrubland, tropical savanna|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Gila monster|symbol=g|color=4:0:1|food=Yes|playable=No|hostile=No|size=2,000|value=50|biome=Any desert|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Gila monster man|symbol=g|color=4:0:1|food=Yes|playable=Adv|hostile=No|size=36,000|value=50|biome=Any desert|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Giraffe|symbol=G|color=6:0:0|food=Yes|playable=No|hostile=No|size=1,000,000|value=500|biome=Tropical savanna, shrubland|note=}}
{{v50_creaturecurrent table row|name=Giraffe man|symbol=G|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=535,000|value=n/a|biome=Savanna tropical, shrubland tropical|note=Animal person}}
{{v50_creaturecurrent table row|name=Goose|symbol=g|color=7:0:1|food=Yes|playable=No|hostile=No|size=4,500|value=10|biome=Temperate lakes, temperate marshes|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Gorilla|symbol=G|color=0:0:1|playable=No|hostile=No|food=Yes|size=150,000|value=500|biome=Tropical broadleaf forest, swamp|note=Trainable}}
{{v50_creaturecurrent table row|name=Grackle man|symbol=g|color=0:0:1|food=No|playable=Adv|hostile=Yes|size=35,060|value=n/a|biome=Temperate grassland, temperate savanna|note=}}
{{v50_creaturecurrent table row|name=Grasshopper man|symbol=g|color=2:0:1|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Gray gibbon|symbol=g|color=0:0:1|playable=No|hostile=No|food=Yes|size=6,000|value=500|biome=Tropical broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Gray langur|symbol=l|color=7:0:0|food=Yes|playable=No|hostile=No|size=15,000|value=50|biome=Any desert, any grassland, any savanna, any shrubland, any forest|note=}}
{{v50_creaturecurrent table row|name=Gray langur man|symbol=l|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=42,500|value=50|biome=Any desert, any grassland, any savanna, any shrubland, any forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Gray squirrel man|symbol=s|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=35,150|value=n/a|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Great horned owl|symbol=o|color=7:0:0|food=Yes|playable=No|hostile=No|size=2,000|value=25|biome=Any forest, any shrubland, any savanna, any grassland, any desert, mangrove swamp, mountain, tundra|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Great horned owl man|symbol=o|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=36,000|value=25|biome=Any forest, any shrubland, any savanna, any grassland, any desert, mangrove swamp, mountain, tundra|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Green tree frog man|symbol=f|color=2:0:1|food=No|playable=Adv|hostile=No|size=35,050|value=10|biome=Temperate freshwater pool, temperate freshwater lake, temperate freshwater swamp, temperate freshwater marsh|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Grey parrot|symbol=p|color=7:0:0|food=Yes|playable=No|hostile=No|size=400|value=10|biome=Tropical moist broadleaf forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Grey parrot man|symbol=p|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=35,200|value=10|biome=Tropical moist broadleaf forest|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Grimeling|symbol=g|color=2:0:0|food=No|playable=No|hostile=Yes|size=70,000|value=Not tameable|biome=Evil swamps|note=}}
{{v50_creaturecurrent table row|name=Grizzly bear|symbol=B|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=200,000|value=500|biome=Taiga, temperate forest|note=Steals booze, trainable}}
{{v50_creaturecurrent table row|name=Grizzly bear man|symbol=B|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=135,000|value=n/a|biome=Forest taiga, any temperate forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Groundhog|symbol=g|color=6:0:0|playable=No|hostile=No|food=Yes|size=3,000|value=50|biome=Temperate savanna, grassland, shrubland|note=}}
{{v50_creaturecurrent table row|name=Groundhog man|symbol=g|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=36,500|value=n/a|biome=Shrubland temperate, savanna temperate, grassland temperate|note=Animal person}}
{{v50_creaturecurrent table row|name=Guineafowl|symbol=g|color=0:0:1|food=Yes|playable=No|hostile=No|size=1,500|value=10|biome=Mountain|note=}}
{{v50_creaturecurrent table row|name=Hamster man|symbol=h|color=7:0:0|food=No|playable=Adv|hostile=No|size=35,075|value=10|biome=Any non-freezing biome|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Hare|symbol=h|color=6:0:0|food=Yes|playable=No|hostile=No|size=3,500|value=10|biome=Temperate savanna, temperate grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Hare man|symbol=h|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=36,750|value=10|biome=Temperate savanna, temperate grassland|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Harpy|symbol=h|color=6:0:0|food=No|playable=No|hostile=Yes|size=60,000|value=n/a|biome=Evil savanna, grassland, shrubland, marshes|note=All harpies are females}}
{{v50_creaturecurrent table row|name=Hedgehog man|symbol=h|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,400|value=10|biome=Temperate shrubland, temperate savanna|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Hoary marmot|symbol=m|color=7:0:0|food=Yes|playable=No|hostile=No|size=10,000|value=50|biome=Mountain|note=}}
{{v50_creaturecurrent table row|name=Hoary marmot man|symbol=m|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=40,000|value=n/a|biome=Mountain|note=Animal person}}
{{v50_creaturecurrent table row|name=Honey badger|symbol=b|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=14,000|value=25|biome=Any tropical land, any desert|note=can become enraged at random}}
{{v50_creaturecurrent table row|name=Honey badger man|symbol=b|color=7:0:1|food=No|playable=Adv|hostile=Yes|size=42,000|value=n/a|biome=Any tropical forest, shrubland tropical, savanna tropical, grassland tropical, any tropical wetland, any desert|note=Animal person}}
{{v50_creaturecurrent table row|name=Hornbill|symbol=h|color=0:0:1|food=Yes|playable=No|hostile=No|size=2,500|value=25|biome=Any tropical forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Hornbill man|symbol=h|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=36,250|value=25|biome=Any tropical forest|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Horse|symbol=H|color=7:0:0|food=Yes|playable=No|hostile=No|size=500,000|value=200|biome=Grassland temperate, savanna temperate|note=}}
{{v50_creaturecurrent table row|name=Hyena|symbol=h|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=60,000|value=50|biome=Tropical savanna, tropical grassland, tropical shrubland|note=}}
{{v50_creaturecurrent table row|name=Hyena man|symbol=h|color=6:0:0|food=Yes|playable=Adv|hostile=Yes|size=64,999|value=50|biome=Tropical savanna, tropical grassland, tropical shrubland|note=Animal person}}
{{v50_creaturecurrent table row|name=Ibex|symbol=i|color=6:0:0|food=Yes|playable=No|hostile=No|size=50,000|value=50|biome=Any grassland, any desert|note=Benign}}
{{v50_creaturecurrent table row|name=Ibex man|symbol=i|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=60,000|value=50|biome=Any grassland, any desert|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Ice wolf|symbol=w|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=50,000|value=50|biome=Evil tundra, glacier|note=Evil}}
{{v50_creaturecurrent table row|name=Iguana|symbol=i|color=2:0:1|food=Yes|playable=No|hostile=Yes|size=4,000|value=400|biome=Any tropical forest|note=}}
{{v50_creaturecurrent table row|name=Iguana man|symbol=i|color=2:0:1|food=No|playable=Adv|hostile=Yes|size=37,000|value=n/a|biome=Any tropical forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Impala|symbol=i|color=6:0:0|food=Yes|playable=No|hostile=No|size=50,000|value=50|biome=Tropical savanna, tropical grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Impala man|symbol=i|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=60,000|value=50|biome=Tropical savanna, tropical grassland|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Jackal|symbol=j|color=6:0:0|food=Yes|playable=No|hostile=No|size=15,000|value=50|biome=Tropical shrubland, tropical savanna, tropical grassland|note=}}
{{v50_creaturecurrent table row|name=Jackal man|symbol=j|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=42,500|value=50|biome=Tropical shrubland, tropical savanna, tropical grassland|note=Animal person}}
{{v50_creaturecurrent table row|name=Jaguar|symbol=J|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=75,000|value=100|biome=Any tropical land, any desert|note=Trainable}}
{{v50_creaturecurrent table row|name=Jaguar man|symbol=J|color=6:0:1|food=No|playable=Adv|hostile=Yes|size=72,500|value=n/a|biome=Any tropical, badland desert, rock desert, sand desert |note=Animal person}}
{{v50_creaturecurrent table row|name=Jumping spider man|symbol=j|color=0:0:1|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Kakapo|symbol=k|color=2:0:0|food=Yes|playable=No|hostile=No|size=3,000|value=50|biome=Temperate shrubland, temperate savanna, temperate grassland, any temperate forest|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Kakapo man|symbol=k|color=2:0:0|food=Yes|playable=Adv|hostile=No|size=36,500|value=50|biome=Temperate shrubland, temperate savanna, temperate grassland, any temperate forest|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Kangaroo|symbol=K|color=6:0:0|food=Yes|playable=No|hostile=No|size=90,000|value=100|biome=Temperate grassland, temperate savanna, temperate shrubland, any desert|note=Benign}}
{{v50_creaturecurrent table row|name=Kangaroo man|symbol=K|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=80,000|value=100|biome=Temperate grassland, temperate savanna, temperate shrubland, any desert|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Kea|symbol=k|color=2:0:0|food=Yes|playable=No|hostile=No|size=1,000|value=25|biome=Any temperate forest, temperate shrubland, mountain|note=Lays eggs, steals objects}}
{{v50_creaturecurrent table row|name=Kea man|symbol=k|color=2:0:0|food=Yes|playable=Adv|hostile=No|size=35,500|value=25|biome=Any temperate forest, temperate shrubland, mountain|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Kestrel|symbol=k|color=4:0:0|food=Yes|playable=No|hostile=No|size=250|value=25|biome=Tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh, any shrubland, any savanna, any grassland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Kestrel man|symbol=k|color=4:0:0|food=Yes|playable=Adv|hostile=No|size=35,125|value=25|biome=Tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh, any shrubland, any savanna, any grassland|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=King cobra|symbol=k|color=0:0:1|food=Yes|playable=No|hostile=No|size=6,000|value=200|biome=Any tropical forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=King cobra man|symbol=k|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=38,000|value=200|biome=Any tropical forest|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Kingsnake|symbol=k|color=7:0:1|food=Yes|playable=No|hostile=No|size=1,500|value=50|biome=Any temperate forest, temperate shrubland, mountain, any desert|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Kingsnake man|symbol=k|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=35,750|value=50|biome=Any temperate forest, temperate shrubland, mountain, any desert|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Kiwi|symbol=k|color=6:0:0|food=Yes|playable=No|hostile=No|size=2,500|value=10|biome=Any temperate forest, temperate shrubland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Kiwi man|symbol=k|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=36,250|value=10|biome=Any temperate forest, temperate shrubland|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Koala|symbol=k|color=7:0:0|food=Yes|playable=No|hostile=No|size=10,000|value=50|biome=Temperate broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Koala man|symbol=k|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=40,000|value=50|biome=Temperate broadleaf forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Leopard|symbol=l|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=50,000|value=100|biome=Any tropical land, any desert|note=Trainable}}
{{v50_creaturecurrent table row|name=Leopard man|symbol=l|color=6:0:1|food=No|playable=Adv|hostile=Yes|size=60,000|value=n/a|biome=Any tropical, desert badland, desert rock, desert sand|note=Animal person}}
{{v50_creaturecurrent table row|name=Leopard gecko man|symbol=g|color=6:0:1|food=No|playable=Adv|hostile=No|size=35,025|value=10|biome=Any desert|note=Animal person}}
{{v50_creaturecurrent table row|graphic=[[File:lion_sprite_anim.gif]]|name=Lion|symbol=L|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=200,000|value=200|biome=Tropical savanna, grassland, shrubland|note=Trainable}}
{{v50_creaturecurrent table row|graphic=[[File:lion_man_sprite_anim.gif]]|name=Lion man|symbol=L|color=6:0:1|food=No|playable=Adv|hostile=Yes|size=135,000|value=n/a|biome=Tropical savanna, tropical grassland, tropical shrubland |note=Animal person}}
{{v50_creaturecurrent table row|name=Lion tamarin man|symbol=l|color=6:0:1|food=No|playable=Adv|hostile=No|size=35,310|value=10|biome=Tropical moist broadleaf forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Lizard man|symbol=l|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=35,100|value=n/a|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Llama|symbol=L|color=7:0:1|food=Yes|playable=No|hostile=No|size=180,000|value=200|biome=mountain|note=}}
{{v50_creaturecurrent table row|name=Lorikeet man|symbol=l|color=4:0:1|food=No|playable=Adv|hostile=No|size=35,100|value=30|biome=Tropical moist broadleaf forest, mangrove swamp|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Louse man|symbol=l|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Lynx|symbol=l|color=6:0:0|food=Yes|playable=No|hostile=No|size=25,000|value=75|biome=Taiga|note=}}
{{v50_creaturecurrent table row|name=Lynx man|symbol=l|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=47,500|value=75|biome=Taiga|note=Animal person}}
{{v50_creaturecurrent table row|name=Magpie man|symbol=m|color=0:0:1|food=No|playable=Adv|hostile=No|size=35,100|value=30|biome=Temperate grassland, temperate savanna, temperate shrubland|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Mandrill|symbol=m|color=1:0:1|food=Yes|playable=No|hostile=No|size=20,000|value=50|biome=Tropical moist broadleaf forest|note=Trainable}}
{{v50_creaturecurrent table row|name=Mandrill man|symbol=m|color=1:0:1|food=No|playable=Adv|hostile=Yes|size=45,000|value=n/a|biome=Tropical moist broadleaf forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Mantis man|symbol=m|color=2:0:1|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Masked lovebird man|symbol=l|color=2:0:1|food=No|playable=Adv|hostile=No|size=35,045|value=30|biome=Any tropical forest|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Monarch butterfly man|symbol=b|color=4:0:1|food=No|playable=Adv|hostile=Yes|size=35,000|value=n/a|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Mongoose|symbol=m|color=7:0:0|food=Yes|playable=No|hostile=No|size=3,000|value=25|biome=Tropical savanna, tropical shrubland|note=Benign}}
{{v50_creaturecurrent table row|name=Mongoose man|symbol=m|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=36,500|value=25|biome=Tropical savanna, tropical shrubland|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Monitor lizard|symbol=M|color=6:0:0|food=Yes|playable=No|hostile=No|size=100,000|value=400|biome=Tropical grassland, tropical savanna, tropical shrubland, any tropical forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Monitor lizard man|symbol=M|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=85,000|value=400|biome=Tropical grassland, tropical savanna, tropical shrubland, any tropical forest|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|graphic=[[File:moose_sprite_anim.gif]]|name=Moose|symbol=M|color=6:0:0|food=Yes|playable=No|hostile=No|size=525,000 (males) 315,000 (females)|value=300|biome=Taiga, temperate forest|note=Benign}}
{{v50_creaturecurrent table row|graphic=[[File:moose_man_sprite_anim.gif]]|name=Moose man|symbol=M|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=297,500|value=300|biome=Taiga, any temperate forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Mosquito man|symbol=m|color=0:0:1|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome, any pool|note=Animal person}}
{{v50_creaturecurrent table row|name=Moth man|symbol=m|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Mountain gnome|symbol=g|color=0:0:1|food=No|playable=No|hostile=No|size=15,000|value=Not tameable|biome=Good mountain|note=Steals booze}}
{{v50_creaturecurrent table row|name=Mountain goat|symbol=g|color=7:0:1|food=Yes|playable=No|hostile=No|size=50,000|value=50|biome=Mountain|note=}}
{{v50_creaturecurrent table row|name=Mountain goat man|symbol=g|color=7:0:1|food=No|playable=Adv|hostile=Yes|size=60,000|value=n/a|biome=Mountain|note=Animal person}}
{{v50_creaturecurrent table row|name=Muskox|symbol=M|color=6:0:0|food=Yes|playable=No|hostile=No|size=285,000|value=300|biome=Tundra, grassland|note=Wagon puller, pack animal}}
{{v50_creaturecurrent table row|name=Muskox man|symbol=M|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=177,500|value=n/a|biome=Tundra, grassland temperate|note=}}
{{v50_creaturecurrent table row|name=Nightwing|symbol=N|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=120,000|value=n/a|biome=Evil desert|note=Can fly}}
{{v50_creaturecurrent table row|name=Ocelot|symbol=o|color=6:0:1|food=Yes|playable=No|hostile=No|size=25,000|value=100|biome=Any tropical forest, mangrove swamp, tropical savanna, tropical grassland|note=}}
{{v50_creaturecurrent table row|name=Ocelot man|symbol=o|color=6:0:1|food=Yes|playable=Adv|hostile=No|size=47,500|value=100|biome=Any tropical forest, mangrove swamp, tropical savanna, tropical grassland|note=Animal person}}
{{v50_creaturecurrent table row|name=Ogre|symbol=O|color=7:0:0|food=No|playable=No|hostile=Yes|size=6,000,000|value=Not tameable|biome=Evil savanna, grassland, shrubland|note=}}
{{v50_creaturecurrent table row|name=One-humped camel|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=No|size=500,000|value=500|biome=Any desert|note=Benign, pack animal}}
{{v50_creaturecurrent table row|name=One-humped camel man|symbol=C|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=285,000|value=n/a|biome=Any desert|note=Animal person}}
{{v50_creaturecurrent table row|name=Opossum|symbol=o|color=7:0:0|food=Yes|playable=No|hostile=No|size=3,000|value=10|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Opossum man|symbol=o|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=36,500|value=10|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Orangutan|symbol=O|color=6:0:0|food=Yes|playable=No|hostile=No|size=80,000|value=500|biome=Tropical moist broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Oriole man|symbol=o|color=6:0:1|food=No|playable=Adv|hostile=Yes|size=35,020|value=n/a|biome=Forest temperate broadleaf|note=Animal person}}
{{v50_creaturecurrent table row|name=Osprey|symbol=o|color=7:0:1|food=Yes|playable=No|hostile=No|size=2,000|value=25|biome=Any ocean, any lake, any river, tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Osprey man|symbol=o|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=36,000|value=25|biome=Any ocean, any lake, any river, tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|graphic=[[File:ostrich_sprite_anim.gif]]|name=Ostrich|symbol=O|color=0:0:1|food=Yes|playable=No|hostile=No|size=90,000|value=100|biome=Tropical savanna, tropical grassland, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|graphic=[[File:ostrich_man_sprite_anim.gif]]|name=Ostrich man|symbol=O|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=80,000|value=100|biome=Tropical savanna, tropical grassland, any desert|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Panda|symbol=P|color=7:0:1|food=Yes|playable=No|hostile=No|size=130,000|value=300|biome=Temperate forest|note=}}
{{v50_creaturecurrent table row|name=Panda man|symbol=P|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=100,000|value=300|biome=Any temperate forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Pangolin|symbol=p|color=6:0:0|food=Yes|playable=No|hostile=No|size=5,000|value=20|biome=Tropical grassland, tropical savanna, tropical shrubland, any tropical forest|note=Benign}}
{{v50_creaturecurrent table row|name=Pangolin man|symbol=p|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=37,500|value=20|biome=Tropical grassland, tropical savanna, tropical shrubland, any tropical forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Parakeet man|symbol=p|color=2:0:1|food=No|playable=Adv|hostile=No|size=35,060|value=30|biome=Tropical grassland, tropical savanna, tropical shrubland, any tropical forest|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Peach-faced lovebird man|symbol=l|color=2:0:1|food=No|playable=Adv|hostile=No|size=35,030|value=30|biome=Temperate grassland, temperate savanna, temperate shrubland, temperate broadleaf forest|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Peregrine falcon|symbol=p|color=6:0:0|food=Yes|playable=No|hostile=No|size=600|value=25|biome=Any wetland, any temperate forest, tropical conifer forest, tropical dry broadleaf forest, taiga, any shrubland, any savanna, any grassland, any desert, mountain, tundra|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Peregrine falcon man|symbol=p|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=35,300|value=25|biome=Any wetland, any temperate forest, tropical conifer forest, tropical dry broadleaf forest, taiga, any shrubland, any savanna, any grassland, any desert, mountain, tundra|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Pig|symbol=p|color=5:0:1|food=Yes|playable=No|hostile=No|size=60,000|value=100|biome=Temperate grassland, temperate savanna |note=}}
{{v50_creaturecurrent table row|name=Pileated gibbon|symbol=g|color=0:0:1|food=Yes|playable=No|hostile=No|size=6,000|value=500|biome=Tropical moist broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Polar bear|symbol=B|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=400,000|value=750|biome=Tundra, glacier|note=Steals booze, trainable}}
{{v50_creaturecurrent table row|name=Polar bear man|symbol=B|color=7:0:1|food=No|playable=Adv|hostile=Yes|size=235,000|value=n/a|biome=Glacier, tundra|note=Animal person}}
{{v50_creaturecurrent table row|name=Porcupine|symbol=p|color=6:0:0|food=Yes|playable=No|hostile=No|size=9,000|value=50|biome=Temperate shrubland, temperate savanna, temperate grassland, temperate conifer forest, taiga, any desert, tundra|note=Benign}}
{{v50_creaturecurrent table row|name=Porcupine man|symbol=p|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=39,500|value=50|biome=Temperate shrubland, temperate savanna, temperate grassland, temperate conifer forest, taiga, any desert, tundra|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Python|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=200,000|value=50|biome=Tropical moist broadleaf forest|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Python man|symbol=S|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=135,000|value=n/a|biome=Tropical moist broadleaf forest|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Rabbit|symbol=r|color=6:0:0|food=Yes|playable=No|hostile=No|size=500|value=3|biome=Temperate shrubland, temperate savanna, temperate grassland |note=}}
{{v50_creaturecurrent table row|name=Raccoon|symbol=r|color=7:0:0|food=Yes|playable=No|hostile=No|size=7,000|value=25|biome=Taiga, temperate forest|note=Steals items and food}}
{{v50_creaturecurrent table row|name=Raccoon man|symbol=r|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=38,500|value=n/a|biome=Forest taiga, any temperate forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Rat man|symbol=r|color=0:0:1|food=No|playable=Adv|hostile=Yes|size=35,150|value=n/a|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Rattlesnake|symbol=s|color=7:0:0|food=Yes|playable=No|hostile=No|size=7,000|value=20|biome=Any non-freezing biome|note=}}
{{v50_creaturecurrent table row|name=Rattlesnake man|symbol=s|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=38,500|value=n/a|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Raven|symbol=r|color=0:0:1|food=No|playable=No|hostile=No|size=1,200|value=25|biome=Temperate grassland, temperate savanna, temperate shrubland, taiga, any temperate forest, any temperate wetland, tundra, any desert|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Raven man|symbol=r|color=0:0:1|food=No|playable=Adv|hostile=No|size=35,600|value=25|biome=Temperate grassland, temperate savanna, temperate shrubland, taiga, any temperate forest, any temperate wetland, tundra, any desert|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Red panda|symbol=p|color=4:0:0|food=Yes|playable=No|hostile=No|size=5,000|value=25|biome=Any temperate forest|note=Benign}}
{{v50_creaturecurrent table row|name=Red panda man|symbol=p|color=4:0:0|food=Yes|playable=Adv|hostile=No|size=37,500|value=25|biome=Any temperate forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Red squirrel man|symbol=s|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=35,150|value=n/a|biome=Any temperate forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Reindeer|symbol=R|color=6:0:0|food=Yes|playable=No|hostile=No|size=130,000|value=200|biome=Tundra, taiga|note=Domestic, milkable}}
{{v50_creaturecurrent table row|name=Rhesus macaque|symbol=m|color=7:0:0|food=Yes|playable=No|hostile=No|size=5,000|value=50|biome=Temperate savanna, grassland, shrubland|note=Steals items and food}}
{{v50_creaturecurrent table row|name=Rhesus macaque man|symbol=m|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=37,500|value=n/a|biome=Temperate shrubland, temperate savanna, temperate grassland |note=Animal person}}
{{v50_creaturecurrent table row|name=Rhinoceros|symbol=R|color=7:0:0|food=Yes|playable=No|hostile=No|size=3,000,000|value=500|biome=Tropical savanna, grassland, shrubland|note=}}
{{v50_creaturecurrent table row|name=Rhinoceros man|symbol=R|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=1,535,000|value=n/a|biome=Tropical grassland, tropical savanna, tropical shrubland |note=Animal person}}
{{v50_creaturecurrent table row|name=Roach man|symbol=r|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=35,000|value=n/a|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Saltwater crocodile|symbol=C|color=2:0:0|playable=No|hostile=Yes|food=Yes|size=800,000|value=700|biome=Any tropical swamps, marshes, rivers|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Saltwater crocodile man|symbol=C|color=2:0:0|food=No|playable=Adv|hostile=Yes|size=435,000|value=n/a|biome=Tropical freshwater swamp, tropical freshwater marsh, tropical saltwater swamp, tropical saltwater marsh, mangrove swamp, tropical saltwater river, tropical brackishwater river, tropical freshwater river |note=Animal person}}
{{v50_creaturecurrent table row|name=Sasquatch|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=300,000|value=Not tameable|biome=Temperate forest, taiga|note=}}
{{v50_creaturecurrent table row|name=Satyr|symbol=s|color=6:0:0|food=No|playable=No|hostile=No|size=60,000|value=n/a|biome=Most good forest|note=}}
{{v50_creaturecurrent table row|graphic=[[File:sheep_sprite_anim.gif]]|name=Sheep|symbol=s|color=7:0:1|food=Yes|playable=No|hostile=No|size=50,000|value=100|biome=Temperate grassland, temperate savanna |note=}}
{{v50_creaturecurrent table row|name=Siamang|symbol=s|color=0:0:1|food=Yes|playable=No|hostile=No|size=12,000|value=500|biome=Tropical moist broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Silvery gibbon|symbol=g|color=0:0:1|food=Yes|playable=No|hostile=No|size=6,000|value=500|biome=Tropical moist broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Skink man|symbol=s|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=35,250|value=n/a|biome=Any temperate, any tropical, any desert|note=Animal person}}
{{v50_creaturecurrent table row|name=Skunk|symbol=s|color=0:0:1|food=Yes|playable=No|hostile=No|size=4,000|value=50|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland|note=Benign}}
{{v50_creaturecurrent table row|name=Skunk man|symbol=s|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=37,000|value=50|biome=Any temperate forest, temperate shrubland, temperate savanna, temperate grassland|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Sloth|symbol=s|color=7:0:0|food=Yes|playable=No|hostile=No|size=6,000|value=50|biome=Any tropical forest|note=Benign}}
{{v50_creaturecurrent table row|name=Sloth bear|symbol=B|color=0:0:1|food=Yes|playable=No|hostile=No|size=100,000|value=250|biome=Any tropical forest|note=}}
{{v50_creaturecurrent table row|name=Sloth bear man|symbol=B|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=85,000|value=250|biome=Any tropical forest|note=Animal person}}
{{v50_creaturecurrent table row|name=Sloth man|symbol=s|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=38,000|value=50|biome=Any tropical forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Slug man|symbol=s|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,000|value=10|biome=Any non-freezing biome|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Snail man|symbol=s|color=7:0:0|food=No|playable=Adv|hostile=No|size=35,000|value=10|biome=Any non-freezing biome|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Snowy owl|symbol=o|color=7:0:1|food=Yes|playable=No|hostile=No|size=2,000|value=25|biome=Tundra|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Snowy owl man|symbol=o|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=36,000|value=25|biome=Tundra|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Sparrow man|symbol=s|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,015|value=30|biome=Any grassland, any savanna, any shrubland, any temperate forest, any tropical forest, any desert, any wetland|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Spider monkey|symbol=m|color=0:0:1|food=Yes|playable=No|hostile=No|size=8,500|value=50|biome=Tropical moist broadleaf forest, tropical dry broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Spider monkey man|symbol=m|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=39,250|value=50|biome=Tropical moist broadleaf forest, tropical dry broadleaf forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Stoat|symbol=s|color=6:0:0|food=Yes|playable=No|hostile=No|size=350|value=25|biome=Taiga, tundra|note=Benign}}
{{v50_creaturecurrent table row|name=Stoat man|symbol=s|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=35,175|value=25|biome=Taiga, tundra|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Strangler|symbol=s|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=40,000|value=250|biome=Evil tropical moist broadleaf forest|note=}}
{{v50_creaturecurrent table row|name=Swan|symbol=s|color=7:0:1|food=Yes|playable=No|hostile=No|size=10,000|value=10|biome=Any temperate lake, any temperate marsh|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Swan man|symbol=s|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=40,000|value=10|biome=Any temperate lake, any temperate marsh|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Tapir|symbol=T|color=7:0:1|food=Yes|playable=No|hostile=No|size=200,000|value=200|biome=Tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Tapir man|symbol=T|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=135,000|value=200|biome=Tropical moist broadleaf forest|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Thrips man|symbol=t|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Tick man|symbol=t|color=0:0:1|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome|note=Animal person}}
{{v50_creaturecurrent table row|name=Tiger|symbol=T|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=225,000|value=200|biome=Most tropical biomes|note=Trainable}}
{{v50_creaturecurrent table row|name=Tiger man|symbol=T|color=6:0:1|food=No|playable=Adv|hostile=Yes|size=147,500|value=n/a|biome=Savage tropical areas|note=Animal person}}
{{v50_creaturecurrent table row|name=Toad man|symbol=t|color=2:0:0|food=No|playable=Adv|hostile=Yes|size=35,100|value=n/a|biome=Any pool|note=Animal person}}
{{v50_creaturecurrent table row|name=Turkey|symbol=t|color=4:0:1|food=Yes|playable=No|hostile=No|size=5,000|value=10|biome=Temperate forest, swamp, shrubland|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Two-humped camel|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=No|size=500,000|value=500|biome=Any desert|note=Benign, pack animal}}
{{v50_creaturecurrent table row|name=Two-humped camel man|symbol=C|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=285,000|value=n/a|biome=Any desert|note=Animal person}}
{{v50_creaturecurrent table row|name=Unicorn|symbol=U|color=7:0:1|food=Yes|playable=No|hostile=No|size=600,000|value=1000|biome=Good taiga, forest, shrubland|note=}}
{{v50_creaturecurrent table row|name=Vulture|symbol=v|color=4:0:0|food=Yes|playable=No|hostile=No|size=9,000|value=30|biome=Any desert, tropical grassland, savanna|note=Steals food}}
{{v50_creaturecurrent table row|name=Vulture man|symbol=v|color=4:0:0|food=No|playable=Adv|hostile=Yes|size=39,500|value=n/a|biome=Tropicalgrassland, tropical savanna, any desert|note=Animal person}}
{{v50_creaturecurrent table row|name=Warthog|symbol=W|color=6:0:0|food=Yes|playable=No|hostile=No|size=100,000|value=100|biome=Tropical savanna, grassland, shrubland|note=}}
{{v50_creaturecurrent table row|name=Warthog man|symbol=W|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=85,000|value=n/a|biome=Savanna tropical, grassland tropical, shrubland tropical|note=Animal person}}
{{v50_creaturecurrent table row|name=Water buffalo|symbol=W|color=0:0:1|food=Yes|playable=No|hostile=No|size=1,000,000|value=200|biome=Tropical wetland|note=Domestic, milkable, wagon puller, pack animal}}
{{v50_creaturecurrent table row|name=Weasel|symbol=w|color=6:0:0|food=Yes|playable=No|hostile=No|size=200|value=10|biome=Any land biome|note=Benign}}
{{v50_creaturecurrent table row|name=Weasel man|symbol=w|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=35,100|value=10|biome=Any land|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=White stork|symbol=s|color=7:0:1|food=Yes|playable=No|hostile=No|size=3,000|value=25|biome=Any grassland, any wetland|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=White stork man|symbol=s|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=36,500|value=n/a|biome=Any grassland, any wetland|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=White-browed gibbon|symbol=g|color=7:0:1|food=Yes|playable=No|hostile=No|size=6,000|value=500|biome=Tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=White-handed gibbon|symbol=g|color=6:0:0|food=Yes|playable=No|hostile=No|size=6,000|value=500|biome=Tropical moist broadleaf forest|note=Benign}}
{{v50_creaturecurrent table row|name=Wild boar|symbol=B|color=6:0:0|food=Yes|playable=No|hostile=No|size=80,000|value=100|biome=Any savanna, any grassland, any shrubland, any forest, any wetland|note=Benign}}
{{v50_creaturecurrent table row|name=Wild boar man|symbol=B|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=75,000|value=100|biome=Any savanna, any grassland, any shrubland, any forest, any wetland|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Wolf|symbol=w|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=40,000|value=50|biome=Tundra, taiga, temperate forest/shrubland|note=}}
{{v50_creaturecurrent table row|name=Wolf man|symbol=w|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=55,000|value=n/a|biome=Tundra, forest taiga, any temperate forest, shrubland temperate|note=Animal person}}
{{v50_creaturecurrent table row|name=Wolverine|symbol=w|color=6:0:0|food=Yes|playable=No|hostile=No|size=20,000|value=25|biome=Taiga, mountain|note=Benign}}
{{v50_creaturecurrent table row|name=Wolverine man|symbol=w|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=45,000|value=25|biome=Taiga, mountain|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Wombat|symbol=w|color=6:0:0|food=Yes|playable=No|hostile=No|size=25,000|value=50|biome=Any temperate forest, temperate shrubland, mountain|note=Benign}}
{{v50_creaturecurrent table row|name=Wombat man|symbol=w|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=47,500|value=n/a|biome=Any temperate forest, temperate shrubland, mountain|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Worm man|symbol=w|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=35,050|value=n/a|biome=Forest taiga, any temperate, any tropical|note=Animal person}}
{{v50_creaturecurrent table row|name=Wren man|symbol=w|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,020|value=30|biome=Any forest, any grassland, any savanna, any shrubland, any wetland, any desert|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Yak|symbol=Y|color=6:0:0|food=Yes|playable=No|hostile=No|size=700,000|value=200|biome=Mountain|note=Domestic, milkable, wagon puller, pack animal}}
{{v50_creaturecurrent table row|name=Yeti|symbol=Y|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=300,000|value=n/a|biome=Mountain, glacier, tundra|note=}}
|}

====Subterranean====

{{v50_creaturecurrent table head}}
{{v50_creaturecurrent table row|name=Amethyst man|symbol=M|color=5:0:1|food=No|playable=No|hostile=Yes|size=70,000|value=Not tameable|biome=Caverns (3)|note=Leaves behind an [[amethyst]]}}
{{v50_creaturecurrent table row|name=Blind cave bear|symbol=B|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=200,000|value=500|biome=Caverns (1,2)|note=}}
{{v50_creaturecurrent table row|name=Blind cave ogre|symbol=O|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=7,000,000|value=500|biome=Caverns (2,3)|note=}}
{{v50_creaturecurrent table row|name=Blood man|symbol=M|color=4:0:0|food=No|playable=No|hostile=Yes|size=70,000|value=Not tameable|biome=Evil Caverns (3)|note=}}
{{v50_creaturecurrent table row|name=Bugbat|symbol=b|color=5:0:0|food=Yes|playable=No|hostile=No|size=10,000|value=20|biome=Caverns (2,3)|note=}}
{{v50_creaturecurrent table row|name=Cave blob|symbol=o|color=6:0:1|food=No|playable=No|hostile=No|size=20,000|value=50|biome=Caverns (3)|note=Causes [[syndrome]]}}
{{v50_creaturecurrent table row|name=Cave crocodile|symbol=C|color=7:0:0|playable=No|hostile=Yes|food=Yes|size=600,000|value=750|biome=Caverns (1,2)|note=}}
{{v50_creaturecurrent table row|graphic=[[File:cave_dragon_sprite_anim.gif]]|name=Cave dragon|symbol=D|color=7:0:1|playable=No|hostile=Yes|food=Yes|size=15,000,000|value=10000|biome=Caverns (3)|note=Trainable}}
{{v50_creaturecurrent table row|name=Cave floater|symbol=f|color=6:0:1|playable=No|hostile=No|food=No|size=40,000|value=50|biome=Caverns (2,3)|note=Causes [[syndrome]]}}
{{v50_creaturecurrent table row|name=Creeping eye|symbol=e|color=7:0:1|food=Yes|playable=No|hostile=No|size=20,000|value=50|biome=Caverns (3)|note=}}
{{v50_creaturecurrent table row|name=Crundle|symbol=c|color=4:0:0|food=Yes|playable=No|hostile=Yes|size=10,000|value=50|biome=Caverns (2,3)|note=}}
{{v50_creaturecurrent table row|name=Draltha|symbol=D|color=6:0:1|playable=No|hostile=No|food=Yes|size=2,500,000|value=500|biome=Caverns (1,2)|note=}}
{{v50_creaturecurrent table row|name=Drunian|symbol=d|color=7:0:0|playable=No|hostile=No|food=Yes|size=50,000|value=50|biome=Caverns (1,2)|note=Steals food and items}}
{{v50_creaturecurrent table row|name=Elk bird|symbol=E|color=6:0:0|food=Yes|playable=No|hostile=No|size=100,000|value=400|biome=Caverns (1,2,3)|note=}}
{{v50_creaturecurrent table row|name=Fire imp|symbol=i|color=6:0:1|food=Yes|playable=No|hostile=Yes|size=6,000|value=Not tameable|biome=Magma|note=Throws fireballs}}
{{v50_creaturecurrent table row|name=Fire man|symbol=M|color=4:0:1|food=No|playable=No|hostile=Yes|size=70,000|value=Not tameable|biome=Magma|note=Throws fireballs and leaves behind [[ash|ashes]]}}
{{v50_creaturecurrent table row|name=Flesh ball|symbol=o|color=6:0:0|food=Yes|playable=No|hostile=No|size=70,000|value=10|biome=Subterranean water - Cavern (3)|note=}}
{{v50_creaturecurrent table row|name=Floating guts|symbol=%|color=7:0:0|playable=No|hostile=No|food=Yes|size=20,000|value=10|biome=Caverns (2,3)}}
{{v50_creaturecurrent table row|name=Gabbro man|symbol=M|color=0:0:1|food=No|playable=No|hostile=Yes|size=70,000|value=Not tameable|biome=Caverns (3)|note=Leaves behind [[gabbro]]}}
{{v50_creaturecurrent table row|name=Giant bat|symbol=B|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=200,000|value=750|biome=Caverns (1,2)|note=Trainable}}
{{v50_creaturecurrent table row|name=Giant cave spider|symbol=S|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=200,000|value=2500|biome=Caverns (1,2)|note=Spins/throws [[web]]s and causes [[syndrome]]}}
{{v50_creaturecurrent table row|name=Giant cave swallow|symbol=C|color=0:0:1|food=Yes|playable=No|hostile=No{{verify}}|size=200,000|value=700|biome=Caverns (1,2)|note=Trainable}}
{{v50_creaturecurrent table row|name=Giant cave toad|symbol=T|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=200,000|value=750|biome=Caverns (1,2)|note=}}
{{v50_creaturecurrent table row|name=Giant earthworm|symbol=W|color=7:0:0|food=Yes|playable=No|hostile=No|size=200,000|value=500|biome=Caverns (1,2)|note=}}
{{v50_creaturecurrent table row|name=Giant mole|symbol=m|color=6:0:0|food=Yes|playable=No|hostile=No{{verify}}|size=200,000|value=350|biome=Caverns (1,2) |note=Steals food and booze}}
{{v50_creaturecurrent table row|name=Giant olm|symbol=O|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=200,000|value=750|biome=Caverns (1,2)|note=}}
{{v50_creaturecurrent table row|name=Giant rat|symbol=R|color=0:0:1|food=Yes|playable=No|hostile=No{{verify}}|size=200,000|value=500|biome=Caverns (1,2) |note=Steals food and booze}}
{{v50_creaturecurrent table row|name=Gorlak|symbol=g|color=6:0:1|food=Yes|playable=Adv|hostile=No|size=50,000|value=Not tameable|biome=Good caverns (1,2,3)|note=}}
{{v50_creaturecurrent table row|name=Green devourer|symbol=G|color=2:0:1|food=Yes|playable=No|hostile=Yes|size=70,000|value=200|biome=Caverns (2,3)|note=}}
{{v50_creaturecurrent table row|name=Gremlin|symbol=g|color=2:0:1|playable=No|hostile=No|food=No|size=10,000|value=N/A|biome=Caverns (1,2,3)|note=[[Gremlin|Cause mischief around fortress]]}}
{{v50_creaturecurrent table row|name=Helmet snake|symbol=s|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=50,000|value=50|biome=Caverns (1,2)|note=Causes [[syndrome]]}}
{{v50_creaturecurrent table row|name=Hungry head|symbol=h|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=5,000|value=50|biome=Caverns (3)|note=Flying}}
{{v50_creaturecurrent table row|name=Iron man|symbol=M|color=0:0:1|food=No|playable=No|hostile=Yes|size=70,000|value=Not tameable|biome=Caverns (3)|note=Causes [[syndrome]]}}
{{v50_creaturecurrent table row|graphic=[[File:jabberer_sprite_anim.gif]]|name=Jabberer|symbol=J|color=5:0:1|food=Yes|playable=No|hostile=Yes|size=4,500,000|value=1500|biome=Caverns (2,3)|note=Trainable}}
{{v50_creaturecurrent table row|name=Large rat|symbol=r|color=6:0:0|food=Yes|playable=No|hostile=No|size=25,000|value=250|biome=Caverns (1)|note=Steals food}}
{{v50_creaturecurrent table row|name=Magma crab|symbol=C|color=0:0:1|playable=No|hostile=Yes|food=Yes|size=30,000|value=200|biome=Magma|note=Throws molten [[basalt]]}}
{{v50_creaturecurrent table row|name=Magma man|symbol=M|color=4:0:1|food=No|playable=No|hostile=Yes|size=70,000|value=Not tameable|biome=Magma|note=Leaves behind [[obsidian]]}}
{{v50_creaturecurrent table row|name=Manera|symbol=m|color=6:0:0|food=No|playable=No|hostile=No|size=60,000|value=Not tameable|biome=Evil Caverns (2)|note=}}
{{v50_creaturecurrent table row|name=Molemarian|symbol=M|color=4:0:1|food=No|playable=No|hostile=Yes|size=90,000|value=400|biome=Caverns (2,3)|note=}}
{{v50_creaturecurrent table row|name=Mud man|symbol=M|color=6:0:0|food=No|playable=No|hostile=Yes|size=70,000|value=Not tameable|biome=Caverns (3)|note=}}
{{v50_creaturecurrent table row|name=Naked mole dog|symbol=n|color=4:0:1|food=Yes|playable=No|hostile=No|size=60,000|value=350|biome=Caverns (1)|note=Steals food}}
{{v50_creaturecurrent table row|name=Plump helmet man|symbol=m|color=5:0:0|food=No|playable=Adv|hostile=No|size=50,000|value=Not tameable|biome=Caverns (2,3)|note=}}
{{v50_creaturecurrent table row|name=Pond grabber|symbol=p|color=1:0:1|food=Yes|playable=No|hostile=Yes|size=30,000|value=50|biome=Caverns (1,2)|note=Aquatic}}
{{v50_creaturecurrent table row|name=Reacher|symbol=R|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=70,000|value=100|biome=Caverns (2,3)|note=}}
{{v50_creaturecurrent table row|name=Rutherer|symbol=R|color=7:0:0|food=Yes|playable=No|hostile=No|size=3,000,000|value=600|biome=Caverns (2,3)|note=Exotic Mount}}
{{v50_creaturecurrent table row|name=Troglodyte|symbol=t|color=6:0:0|food=No|playable=No|hostile=Yes|size=60,000|value=Not tameable|biome=Caverns (1,2)|note=}}
{{v50_creaturecurrent table row|name=Troll|symbol=T|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=250,000|value=Not tameable|biome=Caverns (1,2,3)|note=Forms civilizations}}
{{v50_creaturecurrent table row|name=Voracious cave crawler|symbol=C|color=1:0:0|food=Yes|playable=No|hostile=Yes|size=900,000|value=1000|biome=Caverns (2,3)|note=}}
|}

====Aquatic====
Note: This does not include subterranean sea creatures.

{{v50_creaturecurrent table head}}
{{v50_creaturecurrent table row|name=Albatross|symbol=a|color=7:0:1|food=Yes|playable=No|hostile=No|size=8,000|value=10|biome=Any ocean|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Albatross man|symbol=a|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=39,000|value=10|biome=Any ocean|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Alligator|symbol=A|color=2:0:0|playable=No|hostile=Yes|food=Yes|size=400,000|value=650|biome=Freshwater swamp, marsh, river|note=Amphibious, Lays eggs.}}
{{v50_creaturecurrent table row|name=Alligator man|symbol=A|color=2:0:0|food=No|playable=Adv|hostile=Yes|size=235,000|value=n/a|biome=Temperate freshwater swamp, temperate freshwater marsh, swamp tropical freshwater swamp, tropical freshwater marsh, temperate freshwater river, tropical freshwater river, temperate brackishwater river, tropical brackishwater river|note=Animal person}}
{{v50_creaturecurrent table row|name=Alligator snapping turtle|symbol=T|color=2:0:0|food=Yes|playable=No|hostile=No|size=80,000|value=25|biome=Temperate freshwater river, temperate brackishwater river, temperate freshwater lake, temperate brackishwater lake, temperate freshwater pool, temperate brackishwater pool|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Angelshark|symbol=s|color=6:0:0|food=Yes|playable=No|hostile=No|size=15,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Axolotl man|symbol=a|color=5:0:0|food=No|playable=Adv|hostile=No|size=35,100|value=10|biome=Tropical saltwater lake, tropical brackishwater lake, tropical freshwater lake|note=Animal person}}
{{v50_creaturecurrent table row|name=Basking shark|symbol=S|color=7:0:0|food=Yes|playable=No|hostile=No|size=15,000,000|value=1000|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Beak dog|symbol=B|color=4:0:0|food=Yes|playable=No|hostile=Yes|size=150,000|value=50|biome=Temperate freshwater marsh, temperate saltwater marsh, tropical freshwater marsh, tropical saltwater marsh|note=}}
{{v50_creaturecurrent table row|name=Beaver|symbol=b|color=6:0:0|food=Yes|playable=No|hostile=No|size=20,000|value=25|biome=Any temperate lake, any temperate river|note=Benign}}
{{v50_creaturecurrent table row|name=Beaver man|symbol=b|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=45,000|value=25|biome=Any temperate lake, any temperate river|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Blacktip reef shark|symbol=s|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=15,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Blue shark|symbol=S|color=1:0:1|food=Yes|playable=No|hostile=Yes|size=300,000|value=400|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Bluefin tuna|symbol=α|color=1:0:1|food=Yes|playable=No|hostile=No|size=600,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Bluefish|symbol=α|color=3:0:1|food=Yes|playable=No|hostile=No|size=15,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Bull shark|symbol=S|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=150,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Buzzard|symbol=b|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=1,400|value=30|biome=Marsh temperate freshwater, marsh temperate saltwater, grassland temperate, savanna temperate, any desert|note=}}
{{v50_creaturecurrent table row|name=Buzzard man|symbol=b|color=0:0:1|food=No|playable=Adv|hostile=Yes|size=35,700|value=n/a|biome=Marsh temperate freshwater, marsh temperate saltwater, grassland temperate, savanna temperate, any desert|note=Animal person}}
{{v50_creaturecurrent table row|name=Carp|symbol=α|color=3:0:0|playable=No|hostile=No|food=Yes|size=40,000|value=50|biome=Freshwater river, freshwater lake|note=}}
{{v50_creaturecurrent table row|name=Cod|symbol=α|color=7:0:0|food=Yes|playable=No|hostile=No|size=50,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Coelacanth|symbol=C|color=1:0:1|food=Yes|playable=No|hostile=No|size=80,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Common skate|symbol=ò|color=6:0:0|food=Yes|playable=No|hostile=No|size=100,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|graphic=[[File:snapping_turtle_sprite.png]]|name=Common snapping turtle|symbol=t|color=2:0:0|food=Yes|playable=No|hostile=No|size=30,000|value=25|biome=Temperate freshwater river, temperate brackishwater river, temperate freshwater lake, temperate brackishwater lake, temperate freshwater pool, temperate brackishwater pool|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Conger eel|symbol=~|color=7:0:0|food=Yes|playable=No|hostile=No|size=50,000|value=400|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Crab|symbol=c|color=4:0:1|food=Yes|playable=No|hostile=No|size=8,000|value=Not tameable|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Crab man|symbol=c|color=4:0:1|food=Yes|playable=Adv|hostile=No|size=39,000|value=Not tameable|biome=Any ocean|note=Animal person}}
{{v50_creaturecurrent table row|name=Cuttlefish man|symbol=c|color=6:0:0|food=No|playable=Adv|hostile=No|size=35,500|value=10|biome=Any ocean|note=Animal person}}
{{v50_creaturecurrent table row|name=Damselfly man|symbol=d|color=3:0:1|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any pool|note=Animal person}}
{{v50_creaturecurrent table row|name=Dragonfly man|symbol=d|color=3:0:1|food=No|playable=Adv|hostile=Yes|size=35,000|value=n/a|biome=Any pool|note=Animal person}}
{{v50_creaturecurrent table row|graphic=[[File:ducks_sprite_anim.gif]]|name=Duck|symbol=d|color=2:0:0|food=No|playable=No|hostile=No|size=1,000|value=10|biome=Any lake, any wetland|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Elephant seal|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=3,000,000|value=400|biome=Arctic ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Elephant seal man|symbol=S|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=1,535,000|value=400|biome=Arctic ocean|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Emperor penguin|symbol=p|color=7:0:1|food=Yes|playable=No|hostile=No|size=30,000|value=10|biome=Arctic ocean|note=}}
{{v50_creaturecurrent table row|name=Fly man|symbol=f|color=0:0:1|food=No|playable=Adv|hostile=Yes|size=35,000|value=n/a|biome=Any non-freezing biome, any pool|note=Animal person}}
{{v50_creaturecurrent table row|name=Frill shark|symbol=s|color=3:0:0|food=Yes|playable=No|hostile=Yes|size=60,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Giant albatross|symbol=A|color=7:0:1|food=Yes|playable=No|hostile=No|size=256,320|value=500|biome=Any ocean|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant alligator|symbol=A|color=2:0:0|food=Yes|playable=No|hostile=Yes|size=3,268,000|value=500|biome=Swamp, marsh, river|note=}}
{{v50_creaturecurrent table row|name=Giant axolotl|symbol=A|color=5:0:0|food=No|playable=No|hostile=No|size=201,400|value=500|biome=Tropical saltwater lake, tropical brackishwater lake, tropical freshwater lake|note=}}
{{v50_creaturecurrent table row|name=Giant beaver|symbol=B|color=6:0:0|food=Yes|playable=No|hostile=No|size=341,800|value=500|biome=Any temperate lake, any temperate river|note=Benign}}
{{v50_creaturecurrent table row|name=Giant buzzard|symbol=B|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=209,804|value=500|biome=Temperate marsh|note=}}
{{v50_creaturecurrent table row|name=Giant crab|symbol=C|color=4:0:1|food=Yes|playable=No|hostile=No|size=256,320|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Giant cuttlefish|symbol=C|color=6:0:0|food=No|playable=No|hostile=No|size=207,010|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Giant damselfly|symbol=D|color=3:0:1|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any pool|note=}}
{{v50_creaturecurrent table row|name=Giant dragonfly|symbol=D|color=3:0:1|food=Yes|playable=No|hostile=Yes|size=200,007|value=500|biome=Any pool|note=}}
{{v50_creaturecurrent table row|name=Giant elephant seal|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=24,119,999|value=500|biome=Arctic ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Giant fly|symbol=F|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=200,007|value=500|biome=Any non-freezing biome, any pool|note=}}
{{v50_creaturecurrent table row|name=Giant green tree frog|symbol=F|color=2:0:1|food=No|playable=No|hostile=No|size=200,700|value=500|biome=Temperate freshwater pool, temperate freshwater lake, temperate freshwater swamp, temperate freshwater marsh|note=Benign}}
{{v50_creaturecurrent table row|name=Giant grouper|symbol=G|color=1:0:0|food=Yes|playable=No|hostile=No|size=600,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Giant harp seal|symbol=H|color=7:0:0|food=Yes|playable=No|hostile=No|size=1,428,900|value=500|biome=Arctic ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Giant hippo|symbol=H|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=12,030,000|value=500|biome=Any river, lake|note=}}
{{v50_creaturecurrent table row|name=Giant horseshoe crab|symbol=C|color=6:0:0|food=Yes|playable=No|hostile=No|size=214,020|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Giant kestrel|symbol=K|color=4:0:0|food=Yes|playable=No|hostile=Yes|size=201,750|value=500|biome=Marsh|note=}}
{{v50_creaturecurrent table row|name=Giant leech|symbol=L|color=0:0:1|food=No|playable=No|hostile=No|size=200,700|value=500|biome=Any pool, any lake|note=}}
{{v50_creaturecurrent table row|name=Giant leopard seal|symbol=L|color=0:0:1|food=Yes|playable=No|hostile=No|size=3,268,000|value=500|biome=Arctic ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Giant loon|symbol=L|color=0:0:1|food=Yes|playable=No|hostile=No|size=242,160|value=500|biome=Temperate saltwater lake, temperate brackishwater lake, temperate freshwater lake|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant mink|symbol=M|color=6:0:0|food=Yes|playable=No|hostile=No|size=205,600|value=500|biome=Any temperate lake, any temperate river|note=Benign}}
{{v50_creaturecurrent table row|name=Giant moon snail|symbol=S|color=4:0:1|food=No|playable=No|hostile=No|size=201,400|value=500|biome=Temperate ocean|note=}}
{{v50_creaturecurrent table row|name=Giant mosquito|symbol=M|color=0:0:1|food=No|playable=No|hostile=No|size=200,007|value=500|biome=Any non-freezing biome, any pool|note=}}
{{v50_creaturecurrent table row|name=Giant narwhal|symbol=N|color=7:0:0|food=Yes|playable=No|hostile=No|size=9,624,000|value=2000|biome=Arctic ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Giant nautilus|symbol=N|color=4:0:1|food=No|playable=No|hostile=No|size=203,500|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Giant octopus|symbol=O|color=7:0:0|food=Yes|playable=No|hostile=No|size=235,100|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Giant orca|symbol=O|color=0:0:1|food=Yes|playable=No|hostile=No|size=20,000,000|value=500|biome=Any ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Giant osprey|symbol=O|color=7:0:1|food=Yes|playable=No|hostile=No|size=214,020|value=500|biome=Any ocean, any lake, any river, tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant otter|symbol=O|color=6:0:0|food=Yes|playable=No|hostile=No|size=270,500|value=500|biome=Any pool, any lake, any river|note=Benign}}
{{v50_creaturecurrent table row|name=Giant penguin|symbol=P|color=0:0:1|food=Yes|playable=No|hostile=No|size=228,080|value=500|biome=Arctic ocean|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant platypus|symbol=P|color=6:0:0|food=Yes|playable=No|hostile=No|size=214,020|value=500|biome=Any river|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant pond turtle|symbol=T|color=2:0:0|food=No|playable=No|hostile=No|size=203,500|value=500|biome=Any pool|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant puffin|symbol=P|color=0:0:1|food=Yes|playable=No|hostile=No|size=205,252|value=500|biome=Arctic ocean|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|graphic=[[File:giant_red-winged_blackbird_sprite.png]]|name=Giant red-winged blackbird|symbol=R|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=200,350|value=500|biome=Temperate marsh|note=}}
{{v50_creaturecurrent table row|name=Giant saltwater crocodile|symbol=C|color=2:0:0|food=Yes|playable=No|hostile=Yes|size=6,440,000|value=500|biome=Any swamp, marsh, river|note=}}
{{v50_creaturecurrent table row|name=Giant snapping turtle|symbol=T|color=2:0:0|food=Yes|playable=No|hostile=No|size=414,000|value=500|biome=Temperate freshwater river, temperate brackishwater river, temperate freshwater lake, temperate brackishwater lake, temperate freshwater pool, temperate brackishwater pool|note=Lays eggs}}
{{v50_creaturecurrent table row|name=Giant sperm whale|symbol=W|color=7:0:0|food=Yes|playable=No|hostile=No|size=200,000,000|value=500|biome=Any ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Giant sponge|symbol=S|color=4:0:1|food=No|playable=No|hostile=No|size=560,000|value=500|biome=Any ocean, any lake, any river|note=Benign}}
{{v50_creaturecurrent table row|name=Giant swan|symbol=S|color=7:0:1|food=Yes|playable=No|hostile=No|size=270,500|value=500|biome=Any temperate lake, any temperate marsh|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Giant toad|symbol=T|color=2:0:0|food=Yes|playable=No|hostile=Yes|size=201,400|value=500|biome=Any pool|note=}}
{{v50_creaturecurrent table row|name=Giant walrus|symbol=W|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=12,030,000|value=500|biome=Arctic Ocean|note=}}
{{v50_creaturecurrent table row|name=Gigantic squid|symbol=S|color=7:0:1|food=No|playable=No|hostile=No|size=201,400|value=2000|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Goose|symbol=g|color=7:0:1|food=Yes|playable=No|hostile=No|size=4,500|value=10|biome=Temperate lake, temperate marsh|note=Domestic, lay eggs}}
{{v50_creaturecurrent table row|name=Great barracuda|symbol=b|color=2:0:0|food=Yes|playable=No|hostile=Yes|size=60,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Great white shark|symbol=S|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=2,000,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Green tree frog man|symbol=f|color=2:0:1|food=No|playable=Adv|hostile=No|size=35,050|value=10|biome=Temperate freshwater pool, temperate freshwater lake, temperate freshwater swamp, temperate freshwater marsh|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Grimeling|symbol=g|color=2:0:0|food=Yes|playable=No|hostile=Yes|size=70,000|value=n/a|biome=Swamp, marsh|note=}}
{{v50_creaturecurrent table row|name=Halibut|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=No|size=200,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Hammerhead shark|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=500,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Harp seal|symbol=H|color=7:0:0|food=Yes|playable=No|hostile=No|size=165,000|value=100|biome=Arctic ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Harp seal man|symbol=h|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=117,500|value=100|biome=Arctic ocean|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Harpy|symbol=h|color=6:0:0|food=Yes|playable=No|hostile=Yes|size=60,000|value=30|biome=Marsh|note=}}
{{v50_creaturecurrent table row|name=Hippo|symbol=H|color=7:0:0|playable=No|hostile=No|food=Yes|size=1,500,000|value=400|biome=Tropical river, tropical lake|note=}}
{{v50_creaturecurrent table row|name=Hippo man|symbol=H|color=7:0:0|food=No|playable=Adv|hostile=Yes|size=785,000|value=n/a|biome=Tropical river, tropical lake|note=Animal person}}
{{v50_creaturecurrent table row|name=Horseshoe crab|symbol=c|color=6:0:0|food=Yes|playable=No|hostile=No|size=2,000|value=Not tameable|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Horseshoe crab man|symbol=c|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=36,000|value=Not tameable|biome=Any ocean|note=Animal person}}
{{v50_creaturecurrent table row|name=Kestrel|symbol=k|color=4:0:0|food=Yes|playable=No|hostile=No|size=250|value=25|biome=Marsh|note=}}
{{v50_creaturecurrent table row|name=Kestrel man|symbol=k|color=4:0:0|food=No|playable=Adv|hostile=Yes|size=35,125|value=n/a|biome=Marsh|note=Animal person}}
{{v50_creaturecurrent table row|name=Leech man|symbol=l|color=0:0:1|food=No|playable=Adv|hostile=No|size=35,050|value=n/a|biome=Any pool, any lake|note=Animal person}}
{{v50_creaturecurrent table row|name=Leopard seal|symbol=L|color=0:0:1|food=Yes|playable=No|hostile=No|size=400,000|value=350|biome=Arctic ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Leopard seal man|symbol=L|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=235,000|value=350|biome=Arctic ocean|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Little penguin|symbol=p|color=1:0:1|food=No|playable=No|hostile=No|size=1,500|value=10|biome=Arctic ocean|note=}}
{{v50_creaturecurrent table row|name=Longfin mako shark|symbol=S|color=3:0:1|food=Yes|playable=No|hostile=Yes|size=80,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Longnose gar|symbol=g|color=6:0:0|playable=No|hostile=No|food=Yes|size=20,000|value=200|biome=Temperate river, temperate lake|note=}}
{{v50_creaturecurrent table row|name=Loon|symbol=l|color=0:0:1|food=Yes|playable=No|hostile=No|size=6,000|value=10|biome=Temperate saltwater lake, temperate brackishwater lake, temperate freshwater lake|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Loon man|symbol=l|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=38,000|value=n/a|biome=Temperate saltwater lake, temperate brackishwater lake, temperate freshwater lake|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Manta ray|symbol=►|color=7:0:0|food=Yes|playable=No|hostile=No|size=2,300,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Marlin|symbol=α|color=1:0:1|food=Yes|playable=No|hostile=No|size=800,000|value=500|biome=Tropical ocean, temperate ocean|note=}}
{{v50_creaturecurrent table row|graphic=[[File:merperson_sprite_anim.gif]]|name=Merperson|symbol=M|color=3:0:1|food=No|playable=No|hostile=No|size=70,000|value=n/a|biome=Good ocean|note=}}
{{v50_creaturecurrent table row|name=Milkfish|symbol=α|color=3:0:1|food=Yes|playable=No|hostile=No|size=10,000|value=50|biome=Almost any water|note=}}
{{v50_creaturecurrent table row|name=Mink|symbol=m|color=6:0:0|food=Yes|playable=No|hostile=No|size=800|value=50|biome=Any temperate lake, any temperate river|note=Benign}}
{{v50_creaturecurrent table row|name=Mink man|symbol=m|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=35,400|value=50|biome=Any temperate lake, any temperate river|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Moon snail man|symbol=s|color=4:0:1|food=No|playable=Adv|hostile=No|size=35,100|value=10|biome=Temperate ocean|note=Animal person}}
{{v50_creaturecurrent table row|name=Mosquito man|symbol=m|color=0:0:1|food=No|playable=Adv|hostile=No|size=35,000|value=Not tameable|biome=Any non-freezing biome, any pool|note=Animal person}}
{{v50_creaturecurrent table row|name=Narwhal|symbol=N|color=7:0:0|food=Yes|playable=No|hostile=No|size=1,200,000|value=100|biome=Arctic ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Narwhal man|symbol=N|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=635,000|value=100|biome=Arctic ocean|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Nautilus man|symbol=n|color=4:0:1|food=No|playable=Adv|hostile=No|size=35,250|value=n/a|biome=Any ocean|note=Animal person}}
{{v50_creaturecurrent table row|name=Nurse shark|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=150,000|value=300|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Ocean sunfish|symbol=α|color=3:0:0|food=Yes|playable=No|hostile=No|size=1,000,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Octopus|symbol=o|color=7:0:0|food=Yes|playable=No|hostile=No|size=5,000|value=10|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Octopus man|symbol=o|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=37,500|value=n/a|biome=Any ocean|note=Animal person}}
{{v50_creaturecurrent table row|name=Opah|symbol=α|color=4:0:1|food=Yes|playable=No|hostile=No|size=200,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Orca|symbol=O|color=0:0:1|food=Yes|playable=No|hostile=No|size=5,000,000|value=750|biome=Any ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Orca man|symbol=O|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=2,535,000|value=n/a|biome=Any ocean|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Osprey|symbol=o|color=7:0:1|food=Yes|playable=No|hostile=No|size=2,000|value=25|biome=Any ocean, any lake, any river, tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Osprey man|symbol=o|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=36,000|value=25|biome=Any ocean, any lake, any river, tropical freshwater marsh, tropical saltwater marsh, temperate freshwater marsh, temperate saltwater marsh|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Otter man|symbol=o|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=50,000|value=n/a|biome=Any pool, any lake, any river|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Penguin|symbol=p|color=0:0:1|food=No|playable=No|hostile=No|size=4,000|value=10|biome=Arctic ocean|note=}}
{{v50_creaturecurrent table row|name=Penguin man|symbol=p|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=37,000|value=10|biome=Arctic ocean|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|graphic=[[File:pike_sprite.png]]|name=Pike (fish)|Pike|symbol=α|color=2:0:0|food=Yes|playable=No|hostile=No|size=35,000|value=200|biome=Temperate river, temperate lake|note=}}
{{v50_creaturecurrent table row|name=Platypus|symbol=p|color=6:0:0|food=No|playable=No|hostile=No|size=2,000|value=10|biome=All river|note=}}
{{v50_creaturecurrent table row|name=Platypus man|symbol=p|color=6:0:0|food=Yes|playable=Adv|hostile=No|size=36,000|value=10|biome=Any river|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Pond turtle man|symbol=t|color=2:0:0|food=No|playable=Adv|hostile=No|size=35,250|value=10|biome=Any pool|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Puffin|symbol=p|color=0:0:1|food=Yes|playable=No|hostile=No|size=750|value=10|biome=Arctic ocean|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Puffin man|symbol=p|color=0:0:1|food=Yes|playable=Adv|hostile=No|size=35,375|value=10|biome=Arctic ocean|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Red-winged blackbird man|symbol=r|color=0:0:1|food=No|playable=Adv|hostile=Yes|size=35,025|value=n/a|biome=Temperate marsh|note=Animal person}}
{{v50_creaturecurrent table row|name=River otter|symbol=o|color=6:0:0|food=Yes|playable=No|hostile=No|size=10,000|value=25|biome=Any pool, any lake, any river|note=Benign}}
{{v50_creaturecurrent table row|name=Saltwater crocodile|symbol=C|color=2:0:0|playable=No|hostile=Yes|food=Yes|size=800,000|value=700|biome=Any tropical swamp, marsh, river|note=}}
{{v50_creaturecurrent table row|name=Saltwater crocodile man|symbol=C|color=2:0:0|food=No|playable=Adv|hostile=Yes|size=435,000|value=n/a|biome=Swamp, marsh, river|note=Animal person}}
{{v50_creaturecurrent table row|name=Sea lamprey|symbol=~|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=20,000|value=200|biome=Almost any water|note=}}
{{v50_creaturecurrent table row|name=Sea monster|symbol=M|color=0:0:1|food=Yes|playable=No|hostile=Yes|size=8,000,000|value=1000|biome=Evil ocean|note=}}
{{v50_creaturecurrent table row|name=Sea otter|symbol=o|color=6:0:0|food=Yes|playable=No|hostile=No|size=30,000|value=25|biome=Temperate ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Sea serpent|symbol=S|color=3:0:1|food=Yes|playable=No|hostile=Yes|size=9,000,000|value=1000|biome=Savage ocean|note=}}
{{v50_creaturecurrent table row|name=Shortfin mako shark|symbol=S|color=3:0:1|food=Yes|playable=No|hostile=Yes|size=80,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Snapping turtle man|symbol=t|color=2:0:0|food=Yes|playable=Adv|hostile=No|size=50,000|value=25|biome=Temperate freshwater river, temperate brackishwater river, temperate freshwater lake, temperate brackishwater lake, temperate freshwater pool, temperate brackishwater pool|note=Animal person, Lays eggs}}
{{v50_creaturecurrent table row|name=Sperm whale|symbol=W|color=7:0:0|food=Yes|playable=No|hostile=No|size=25,000,000|value=1000|biome=Any ocean|note=Benign}}
{{v50_creaturecurrent table row|name=Sperm whale man|symbol=W|color=7:0:0|food=Yes|playable=Adv|hostile=No|size=12,535,000|value=n/a|biome=Any ocean|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Spiny dogfish|symbol=s|color=6:0:0|food=Yes|playable=No|hostile=No|size=30,000|value=200|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Sponge|symbol=s|color=4:0:1|food=No|playable=No|hostile=No|size=50,000|value=10|biome=Any ocean, any lake, any river|note=Benign}}
{{v50_creaturecurrent table row|name=Sponge man|symbol=s|color=4:0:1|food=No|playable=Adv|hostile=No|size=60,000|value=n/a|biome=Any ocean, any lake, any river|note=Animal person, Benign}}
{{v50_creaturecurrent table row|name=Spotted wobbegong|symbol=S|color=6:0:0|food=Yes|playable=No|hostile=No|size=80,000|value=n/a|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Squid man|symbol=s|color=7:0:1|food=No|playable=Adv|hostile=No|size=35,100|value=10|biome=Any ocean|note=Animal person}}
{{v50_creaturecurrent table row|name=Stingray|symbol=ò|color=7:0:0|food=Yes|playable=No|hostile=No|size=5,000|value=200|biome=Almost any water|note=}}
{{v50_creaturecurrent table row|name=Sturgeon|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=No|size=1,500,000|value=300|biome=Any ocean, any river|note=}}
{{v50_creaturecurrent table row|name=Swan|symbol=s|color=7:0:1|food=Yes|playable=No|hostile=No|size=10,000|value=10|biome=Any temperate lake, any temperate marsh|note=Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Swan man|symbol=s|color=7:0:1|food=Yes|playable=Adv|hostile=No|size=40,000|value=10|biome=Any temperate lake, any temperate marsh|note=Animal person, Lays eggs, Benign}}
{{v50_creaturecurrent table row|name=Swordfish|symbol=α|color=3:0:1|food=Yes|playable=No|hostile=No|size=650,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Tiger shark|symbol=S|color=7:0:0|food=Yes|playable=No|hostile=Yes|size=500,000|value=500|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Tigerfish|symbol=α|color=3:0:1|food=Yes|playable=No|hostile=Yes|size=50,000|value=200|biome=Tropical freshwater river, tropical lake|note=}}
{{v50_creaturecurrent table row|name=Toad man|symbol=t|color=2:0:0|food=No|playable=Adv|hostile=Yes|size=35,100|value=n/a|biome=Any pool|note=Animal person}}
{{v50_creaturecurrent table row|name=Walrus|symbol=W|color=6:0:0|food=Yes|playable=No|hostile=No|size=1,500,000|value=400|biome=Arctic ocean|note=}}
{{v50_creaturecurrent table row|name=Walrus man|symbol=W|color=6:0:0|food=No|playable=Adv|hostile=Yes|size=785,000|value=n/a|biome=Arctic ocean|note=Animal person}}
{{v50_creaturecurrent table row|name=Whale shark|symbol=W|color=6:0:0|food=Yes|playable=No|hostile=No|size=20,000,000|value=1000|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Whitetip reef shark|symbol=s|color=7:0:1|food=Yes|playable=No|hostile=Yes|size=15,000|value=200|biome=Any ocean|note=}}
|}

====Agitation====
Disruption of the environment of a savage biome, such as deforestation or overfishing, may cause the appearance of "agitated" animals. Agitated animals, regardless of their normal behavior, will directly seek out and attack dwarves. Agitation can be removed by [[Taming|taming]].

== Night Creatures / Other ==


===Night creatures===
These creatures are either vicious creatures that attack in the night, or are created through certain [[Interaction token|interaction]]s - be it a condition of the game, or intentionally by another creature.
{{v50_creaturecurrent_table_head}}
{{v50_creaturecurrent_table_row|graphic=[[File:Animated dead example anim.gif]]|name=Undead|Animated dead|symbol=Ñ|color=3:0:0|food=Yes|playable=No|hostile=Yes|size=Varies|value=Not tameable|biome=[[Evil]] biomes, [[tower (necromancy)|tower]]s, [[camp]]s|note= Formerly living creatures animated through magic.}}
{{v50_creaturecurrent_table_row|graphic=[[File:bogeyman_sprite.png]]|name=Bogeyman|symbol=ñ|color=0:0:1|food=No|playable=No|hostile=Yes|size=Varies|value=Not tameable|biome=[[Evil]] biomes{{Version|0.47.01}}; All above-ground pre-{{Version|0.47.01}}|note=See article for more information}}
{{v50_creaturecurrent_table_row|graphic=[[File:experiment_sprite.png]]|name=Experiment|symbol=Varies|color=7:0:1|food=No|playable=Adv1|hostile=Possibly|size=Varies|value=Not tameable|biome=[[Tower (necromancy)|Tower]]s, Towns and cities1|note= Failed or successful products of experimentation on living citizens or livestock.}}
{{v50_creaturecurrent_table_row|name=Ghost|symbol=Ñ|color=7:1:1|food=No|playable=No|hostile=Possibly|size=Varies|value=Not tameable|biome=Any|note=Spiritual residents who have not been memorialized properly.}}
{{v50_creaturecurrent_table_row|name=Infected ghoul|symbol=Ñ|color=4:0:1|food=No|playable=No|hostile=Yes|size=Varies|value=Not tameable|biome=[[Tower (necromancy)|Tower]]s|note=Undead creatures who can spread their condition through bites.}}
{{v50_creaturecurrent_table_row|name=Intelligent undead|symbol=Ñ|color=3:0:1|food=No|playable=Adv2|hostile=Possibly|size=Varies|value=Not tameable|biome=All above-ground|note=Former historical figures raised from the dead. Retain part of their personality.}}
{{v50_creaturecurrent_table_row|graphic=[[File:mummy_preview_sprite.png]]|name=Mummy|symbol=Ñ|color=6:0:1|food=No|playable=No|hostile=Yes|size=Varies|value=Not tameable|biome=[[Tomb]]s|note=Undead rulers who will attack when disturbed, as well as lay curses.}}
{{v50_creaturecurrent_table_row|name=Necromancer|symbol=Ñ|color=5:0:1|food=No|playable=Adv3|hostile=Yes|size=Varies|value=Not tameable|biome=[[Tower (necromancy)|Tower]]s, [[camp]]s|note=Immortal beings who are able to raise the dead.}}
{{v50_creaturecurrent_table_row|graphic=[[File:night_troll_sprite.png]]|name=Night troll|symbol=Ñ|color=2:0:0|food=No|playable=No|hostile=Yes|size=Varies|value=Not tameable|biome=All above-ground|note=A stalker troll that kidnaps and mates with victims.}}
{{v50_creaturecurrent_table_row|graphic=[[File:moon_sprite.png]]|name=Nightmare|symbol=Ñ|color=0:0:1|food=No|playable=No|hostile=Yes|size=Varies{{verify}}|value=Not tameable|biome=N/A|note=See article for more information}}
{{v50_creaturecurrent_table_row|name=Vampire|symbol=Ñ|color=4:0:0|food=No|playable=Adv4|hostile=Yes|size=Varies|value=Not tameable|biome=All above-ground|note=Immortal beings who feed on blood and can appear in migrant waves while disguised.}}
{{v50_creaturecurrent_table_row|name=Werebeast|symbol=Ñ|color=6:0:0|food=No|playable=No|hostile=Yes|size=Varies|value=Not tameable|biome=All above-ground|note=Sapient creatures cursed to transform into a cross of themselves and an animal on a full moon.}}
|}
:1. In some worlds, intelligent experiments escape their creators and join normal civilizations. They will then be playable in adventurer mode. 
:2. The player cannot normally start out as an intelligent undead, but can [[unretire]] a former adventurer that has been resurrected. This can also be done (without unretiring) by using [[adventurer party|adventurer parties]]. 
:3. The player cannot start out as a necromancer, but can gain necromancer powers by reading a slab or book containing the secrets of life and death. 
:4. The player cannot start out as a vampire, but can become one if feeding on spilled vampire blood. [[Animal people]] with the ability to suck blood can also gain vampirism by blood-sucking a vampire during combat.

===Hidden Fun Stuff===

{{spoiler}}
{{v50_creaturecurrent table head}}
{{v50_creaturecurrent_table_row|graphic=[[File:beast_sprites_preview_anim.gif]]|name=Demon|symbol=&|color=7:0:1|food=No|playable=No|hostile=Yes|size=10,000,000|value=Not tameable|biome=[[Underworld]]|note=See article for more information}}
{{v50_creaturecurrent_table_row|graphic=[[File:beast_sprites_preview_anim.gif]]|name=Angel|symbol=Ä|color=7:0:1|food=No|playable=No†|hostile=Yes|size=varies|value=Not tameable|biome=[[Vault]]s|note=See article for more information}}
|}

†except in a few [http://www.bay12forums.com/smf/index.php?topic=172326.msg7869456#msg7869456 special cases]

===Nonexistent===

{{v50_creaturecurrent table head}}
{{v50_creaturecurrent_table_row|name=Centaur|symbol=C|color=6:0:0|food=N/A|size=N/A|value=N/A|playable=No|hostile=N/A|biome=Nowhere|note=Only found in engravings}}
{{v50_creaturecurrent_table_row|name=Chimera|symbol=C|color=2:0:1|food=N/A|size=N/A|value=N/A|playable=No|hostile=N/A|biome=Nowhere|note=Only found in engravings}}
{{v50_creaturecurrent_table_row|name=Griffon|symbol=G|color=7:0:1|food=N/A|size=N/A|value=N/A|playable=No|hostile=N/A|biome=Nowhere|note=Only found in engravings}}
|}

==Trivia==
*[[File:placeholder_sprite.png|right]]If the game does not recognize a creature and/or cannot the find the sprite associate for it, the sprite will default to a blue, round, blob-like face with stubby legs.
{{Translation
| dwarven = mes
| elvish = amu
| goblin = los
| human = mos
}}
{{Creatures}}
{{Category|Creatures| }}
[[ru:Creature]]

Surroundings

2024-02-28T06:54:42Z

Putnam3145: /* Savage */

{{migrated article}}
{{Quality|Unrated}}
[[File:surroundings_preview.png|thumb|400px|right|A good biome, neutral biome and a bloody, evil biome.]]'''Surroundings''' affect the types of [[crop|plant]] life, wild [[animal]]s and [[creatures]] which will appear in play within a given [[biome]]. The surrounding type is formed of two components: spirit and savagery. It is possible to start a [[fortress]] that overlaps multiple alignment types (for example, a terrifying [[forest]] and a calm [[shrubland]]). Some players consider this desirable, as it provides diversity in your little corner of the world, but it also has its dangers in the form of more ferocious wildlife.

Some plants and animals are unique to a certain type of surroundings and will only be found if those surroundings are present on the map. Note that most creatures also require a specific [[climate]] to spawn in. Again, it's important to check the specific biomes making up your site. Once a [[creature]] spawns on the map, it is under no compulsion to stay in its own biome and can roam as it pleases. Because of this, the specifics of what means what can be difficult to pin down sometimes.

[[Cavern]]s are not affected by alignments, despite some subterranean creature definitions including an alignment. Good creatures like the [[gorlak]], evil creatures like the [[troll]] and savage creatures like the [[giant cave spider]] can be found in any cavern, regardless of whether the fortress is settled in good/evil/savage surroundings or not.

Selecting surroundings is the closest (but not the only) thing to selecting a difficulty for the game. Surroundings may be removed in the 'Myth & Magic' update.[http://www.bay12forums.com/smf//index.php?topic=169696.msg8341484#msg8341484] This version of the game currently does not have the surrounding types show as color-coded, though the information box at the side of the screen will still inform the player of any type of surroundings the player's cursor hovers over.

== Combinations & characteristics of surroundings ==
The names given to different areas will reflect their moral standing. For example, good biomes may be named "The Hills of Sweetness" while an evil one may be named "The Prairie of Agony". Neutral biomes will generally have more generic names, such as "The Beige Jungles". Not all worlds will contain every kind of combinations. For example, a world that is low in savagery may not contain Joyous Wilds surroundings.
{| {{prettytable}}
|-style="background:#dddddd"
|style="background:#aaaaaa"| ||'''Benign'''||'''Neutral'''||'''Savage'''
|-
|style="background:#dddddd"|'''Good'''||Serene||Mirthful||Joyous Wilds
|-
|style="background:#dddddd"|'''Neutral'''||Calm||Wilderness||Untamed Wilds
|-
|style="background:#dddddd"|'''Evil'''||Sinister||Haunted||Terrifying
|}

===Good===

:Including {{DFtext|Serene|1:1}}, {{DFtext|Mirthful|2:1}} and {{DFtext|Joyous Wilds|3:1}}

[[File:good_biome_v50.png|thumb|120px|left|A sharp green good biome.]]'''Good''' biomes tend to have less aggressive (often {{token|BENIGN}}) and weaker [[creatures]], except for the [[unicorn]]. They also tend to have more [[fanciful]] creatures than neutral biomes. Good regions also support the wild [[sun berry]], which makes the best [[alcohol]] in the game. There are generally slight changes between ''Benign Good'' and ''Savage Good''. Though these biomes are the safest in the game, they can still come with a challenge. Therefore, players should still not be too complacent.

Good biomes will usually appear as luscious green patches, with that green being a more vibrant and sharp green than neutral biomes.

====Distinctive flora & fauna====
* Animals: [[merperson]], [[mountain gnome]], [[satyr]], [[unicorn]]
* Plants: [[bubble bulb]], [[downy grass]], [[sun berry]]
* Trees: [[feather tree]]
* Vermin: [[fairy]], [[fluffy wambler]], [[pixie]]
{{clear}}

===Neutral===

:Including {{DFtext|Calm|7:0}}, {{DFtext|Wilderness|2:0}} and {{DFtext|Untamed Wilds|6:1}}

[[File:neutral_biome_v50.png|thumb|120px|left|A generic, neutral biome.]]'''Neutral''' regions are the easiest to understand. They generally mimic the real world, with recognizable wildlife. They can be quite dangerous depending on the region, holding anything from benign and weak weasels, to the generally non-aggressive but physically powerful [[elephant]]s, to the very aggressive and very dangerous [[giant eagle]]s. As one might expect, ''Benign Neutral'' zones are really very safe, while ''Savage Neutral'' areas can pose some major difficulties, depending on the dominating climate, landforms, [[giant badger|or]] [[giant kea|wildlife]]. You'll find most of the standard aboveground plants in these alignments, such as [[prickle berry|prickle berries]], [[rope reed]], [[strawberry|strawberries]] and the like.
{{clear}}

===Evil===
:Including {{DFtext|Sinister|5:0}}, {{DFtext|Haunted|5:1}} and {{DFtext|Terrifying|5:1}}

[[File:bad_biome_v50.png|frame|left|Dark brown patch of an evil biome.]]'''Evil''' regions are much more dangerous and strange than their ''Neutral'' and ''Good'' counterparts across the board. First, in addition to the ordinary wildlife native to the biome, various other [[creatures]] that are nasty, dangerous, and spiteful such as [[beak dog]]s, [[harpy|harpies]], and [[ogre]]s can be found in evil regions.

Evil regions may exist either on their own (where they are known as "primordial" evil regions) or they may be caused by the presence of [[demon]]s or [[necromancer]]s ruling over a [[site]] in it (known as "circumstantial" evil regions). An evil region possesses [[sphere]]s associated with the entities, if any, inhabiting it, which influences the surroundings to some extent. E.G: Blight, death, and disease regions kill plant life, while nightmare regions are home to [[Bogeyman|bogeymen]]. Primordial evil areas are eternal, but circumstantial evil regions may fade away if there is no activity in the area, making it possible to revert it back to normal. Presumably, slaying the demons or necromancers responsible for the corruption is the way to do so.{{version|0.47.01}}

Most evil regions have associated evil [[weather]]. Evil clouds can inflict various [[syndrome]]s on par with those of [[forgotten beast]]s, or instantly transform creatures into freakishly powerful [[Undead#Thralls, Husks, and_Zombies|thralls]]. Evil rains may also inflict random evil syndromes, albeit less severe ones, and always cause unhappy [[thought]]s and a desire to wash (evil!). Evil rain won't refill pools, but a single evil biome may have both evil and regular rain, even at the same time.

About half of all evil regions are "reanimating", meaning that all wildlife and plantlife will be [[undead]], and any creature that dies will, after a short time, be reanimated as undead. Undead are hostile to all living creatures, and feel no fear or pain. In general, undead wildlife is '''extremely''' dangerous, especially in Terrifying regions, since the undead may include zombified fliers that swoop down and rip your dwarves to shreds with little to no warning at all, and even discounting those, typically harmless creatures like [[beaver]]s will turn out to be necro-buffed monstrosities that are out for all living blood.

Undead can only be killed in [[combat]] by beheading, bisection, or pulping damage, or otherwise by [[Butcher|butchering]], [[Cave-in|cave-ins]], [[Dwarven atom smasher|particle physics]], or good old fashioned [[Magma|magma]]. Beheading, bisection and butchering may leave remains that can be reanimated; any partial corpse or body part that is not "mangled" and contains at least one hand or head can reanimate. This includes [[skin]], and even [[hair]] left over from butchering or shearing. Remains can reanimate while your dwarves are processing them, frightening any nearby dwarves and canceling job orders. That being said, reanimated hair is not much of a threat and your dwarves will likely quickly dispatch them. The resulting mangled remains can still be processed just like the original material, but without the risk of job cancellations. {{clear}}

Creatures that can [[Building destroyer|destroy buildings]], [[Trapavoid|avoid traps]] or [[Steals items|steal items]] will retain these abilities in undeath. Undead do not need to breathe, so they will not be stopped by rivers or moats, and aquatic undead can and will come ashore. Furthermore, the usual strategy of dealing with wildlife by avoiding confrontation is impossible since the undead will always stay in a state of "perpetually murderous towards all living beings" no matter how much you decide to bother them. Maybe a [[vampire]] or [[necromancer]] can help?

If your [[Embark|embark]] site spans multiple biomes then only the evil part will have the reanimating effect, and only wildlife appearing from that side will be undead. The reanimating effect extends all the way underground. The trees at embark may all be dead, and though they can be cut down for logs, will not regrow. Undead shrubs are useless for [[Herbalist|gathering]], too.

When embarking in a reanimating evil region, it is advised to move everything underground as soon as possible, and immediately set up plenty of [[trap]]s and/or a [[military]] armed with blunt weapons. Be very careful with [[refuse]] stockpiles and butcher's shops. Keep livestock to a minimum, as they are a liability. Needless to say, hunting is a very bad idea.

Evil regions are so inhospitable that beginners might find evil surroundings—even ''Benign Evil''—too difficult. Still, players may wish to embark in such surroundings for <s>a challenge</s> [[fun]].

Evil regions can appear on the map as either dark brown or a dim sandy brown. There is no functional difference between these regions.

: ''So, in ASCII, for most regions (not oceans apparently), there's a special variable that says whether an evil region is gray-red, or light/dark magenta. It defaults to zero, which is the magenta version, but when the "evilify" region function is called, it is randomized from 0-1. There's also a version of this function used for circumstantially evil areas, and it appears to also set the variable from 0-1. If either of those things aren't working, then the colors would probably all be magenta.''
:
: — [https://dwarffortresswiki.org/index.php/Toady_One Toady One] ([http://www.bay12forums.com/smf//index.php?topic=169696.msg8341484#msg8341484])

====Distinctive flora & fauna====
* Animals: [[beak dog]], [[blizzard man]], [[dark gnome]], [[foul blendec]], [[grimeling]], [[harpy]], [[ice wolf]], [[nightwing]], [[ogre]], [[sea monster]], [[strangler]]
* Plants: [[sliver barb]], [[staring eyeball]], [[wormy tendril]]
* Trees: [[glumprong]]
* Vermin: [[blood gnat]], [[demon rat]], [[knuckle worm]], [[phantom spider]]

===Savage===
: Including {{DFtext|Untamed Wilds|6:1}}, {{DFtext|Joyous Wilds|3:1}} and {{DFtext|Terrifying|5:1}}

'''Savage''' surroundings are the only surroundings which have [[giant animal|giant]] and [[animal people|humanoid]] versions of some animals. It is also possible that two groups of animals happen outside on a savage biome, instead of one. They are also far more varied in wildlife than the other biomes.

Most of the creatures in savage biomes will leave you alone, especially the animal people, who are harmless (with a few exceptions), and most of the giant creatures will not be hostile, but then again, a savage biome may just surprise you with [[giant kea]]s or [[giant badger]]s, and some of the creatures found in savage biomes are dangerous indeed. If you don't know what to expect, just look it up. "Savage Good" regions are called Joyous Wilds, "Savage Neutral" regions are called Untamed Wilds, and "Savage Evil" regions are called <s>excessively fun</s> Terrifying.

Savage biomes also house [[whip vine]]s, a high-value millable/brewable aboveground crop, and [[highwood]]s, a slow-growing tree that can grow as thick as 3×3.

As of v50.01, animals can become ''agitated'', which increases their proactive desire to attack your dwarves. This behavior occurs only in Savage regions.

Civilizations, except for [[elf|elves]], who are naturally at peace with animals, typically do not settle in high-savagery regions, which may cause problems during [[world generation]] if the game can't find enough low-savagery regions to place civilizations in.

====Distinctive flora & fauna====
* Animals: above-ground [[animal people]], [[giant animal]]s, [[giant desert scorpion]] (pre-[[Release information/0.42.04|0.42.04]]), [[sasquatch]], [[sea serpent]], [[yeti]]
* Plants: [[whip vine]]
* Trees: [[highwood]]
* Vermin: [[acorn fly]], [[fox squirrel]], [[moghopper]], [[two-legged rhino lizard]]

{{World}}