Dwarf Fortress Wiki - User contributions [en]

Template:Current/version

2026-05-21T18:51:58Z

Quietust:

53.14<noinclude>

This template is the most recent version (hopefully).
Include it in places that you want to refer to the most recent version.

If this template isn't up to date, feel free to correct it.

== See also ==
{{tl|current/version/ns}}

[[Category:Version {{current/version}}]][[category:wiki]][[Category:Version templates]]</noinclude>

Template:Current/version

2026-05-15T12:29:08Z

Quietust:

53.13<noinclude>

This template is the most recent version (hopefully).
Include it in places that you want to refer to the most recent version.

If this template isn't up to date, feel free to correct it.

== See also ==
{{tl|current/version/ns}}

[[Category:Version {{current/version}}]][[category:wiki]][[Category:Version templates]]</noinclude>

Building token

2026-05-15T03:53:31Z

Quietust: again, this is specifically grown wood

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

'''Building tokens''' control the functionality of custom [[building]]s.

All custom buildings are defined as objects of type BUILDING_WORKSHOP or BUILDING_FURNACE; [[workshop]]s show up in the Build > Workshops ({{Menu icon|b|o}}) menu, while [[furnace]]s show up in the Build > Workshops > Furnaces ({{Menu icon|b|o|u}}) menu.

You also must add any new custom buildings to the [[Entity token|civilization]] that you want to use it.

Additionally, furnaces must be designed by an [[mason]] before being constructed (and will gain [[quality]] accordingly), though they will always use the labor(s) specified in the building definition, rather than ones based on the materials being used.

{{Urist asks|q=Is there a {{tooltip|WYSIWYG|What you see is what you get}} editor for ASCII buildings?|a=
[http://www.bay12forums.com/smf/index.php?topic=54004 Custom Workshop Workshop] is a standalone program designed for this purpose.

There is also a [https://jose96xd.github.io/DF_Tools/Modules/BuildingASCIIVisualizer.html Building ASCII Visualizer] web app included in DFTools. Special character IDs can be found on the [[Character table]].
}}

{{clear}}

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

|-
| {{text anchor|NAME}}
| name
| The name of the custom building.

|-
| {{text anchor|NAME_COLOR}}
| [[Color#Modding_color|fg:bg:bright]]
| The [[color]] of the building's name when {{K|q}}uerying it. Seemingly ignored for furnaces, which are hardcoded to 4:0:1.

|-
| {{text anchor|DIM}}
| width:height
| The size of the custom building, in number of tiles. Defaults to 3:3. Maximum possible size is 31x31.

|-
| {{text anchor|WORK_LOCATION}}
| x:y
| The tile (1:1 for upper-left) in which dwarves will stand when they are performing tasks. Defaults to 3:3 (bottom-right).

|-
| {{text anchor|BUILD_LABOR}}
| [[labor token]]
| The labor required to construct the custom building. If multiple BUILD_LABOR tokens are specified, then any of the indicated labors can be used to construct the building; if none are specified, then no labors are required.

|-
| {{text anchor|BUILD_KEY}}
| [[Interface.txt#Key_bindings|key bind]]
| The shortcut key used in the Build menu for selecting the custom building. For example: "CUSTOM_SHIFT_S"

|-
| {{text anchor|BLOCK}}
|
* row
* tiles...
| Specifies whether or not each workshop tile blocks movement. The first parameter is the row (1 = top), and each subsequent parameter is a 0 (nonblocking) or 1 (blocking) for each column, left to right.

|-
| {{text anchor|TILE}}
|
* stage
* row
* tiles...
| Specifies the characters used to represent the custom building. The first parameter is the building stage, varying from 0 (awaiting construction) to N (completed) where N is between 1 and 3, the 2nd parameter is the row number, and each subsequent parameter is a character number (or literal character enclosed in 'quotes').

|-
| {{text anchor|COLOR}}
|
* stage
* row
* colors...
| Specifies the [[Color|colors]] in which the custom building's tiles will be displayed. The first parameter is the building stage, the 2nd parameter is the row number, and subsequent parameters are either sets of 3 numbers (foreground:background:brightness), or the token "MAT" to use the color of the primary building material, for each tile in the row. MAT may not be available on BUILDING_FURNACEs.{{verify}} However a color settings of 4:0:1 will translate into MAT for furnaces instead.

|-
| {{text anchor|BUILD_ITEM}}
|
* quantity
* [[item token]]
* [[material token]]
| Specifies one of the objects necessary to construct the custom building. Each BUILD_ITEM can be followed by zero or more modifiers.

|-
| {{text anchor|NEEDS_MAGMA}}
|
| Specifies that one of the building's tiles (other than the WORK_LOCATION) must be hanging over [[magma]] in order for the building to function. Buildings with this token also ignore the [FUEL] token in their reactions.
|

|-
| {{text anchor|TOOLTIP}}
| tooltip
| Adds a tooltip for the building.
|}

==Item Modifiers==
Building items have many of the same modifiers as [[Reactions#Modifiers|reagents]] in custom reactions.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [{{text anchor|ANY_BONE_MATERIAL}}]
| Item material must have the [BONE] token.
|-
| [{{text anchor|ANY_HORN_MATERIAL}}]
| Item material must have the [HORN] token.
|-
| [{{text anchor|ANY_LEATHER_MATERIAL}}]
| Item material must have the [LEATHER] token.
|-
| [{{text anchor|ANY_PEARL_MATERIAL}}]
| Item material must have the [PEARL] token.
|-
| [{{text anchor|ANY_PLANT_MATERIAL}}]
| Item material must be subordinate to a PLANT object.
|-
| [{{text anchor|ANY_SHELL_MATERIAL}}]
| Item material must have the [SHELL] token.
|-
| [{{text anchor|ANY_SILK_MATERIAL}}]
| Item material must have the [SILK] token.
|-
| [{{text anchor|ANY_SOAP_MATERIAL}}]
| Item material must have the [SOAP] token.
|-
| [{{text anchor|ANY_STRAND_TISSUE}}]
| Item is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT].
|-
| [{{text anchor|ANY_TOOTH_MATERIAL}}]
| Item material must have the [TOOTH] token.
|-
| [{{text anchor|ANY_YARN_MATERIAL}}]
| Item material must have the [YARN] token.
|-
| [{{text anchor|BUILDMAT}}]
| Item must be a general [[building material]] - BAR, BLOCKS, BOULDER, or WOOD.
|-
| [{{text anchor|CAN_USE_ARTIFACT}}]
| Item can be an Artifact.
|-
| [{{text anchor|CONTAINS_LYE}}]
| Item must be a BARREL or TOOL which contains at least one item of type LIQUID_MISC made of LYE.
|-
| [{{text anchor|EMPTY}}]
| If the item is a container, it must be empty.
|-
| [{{text anchor|FIRE_BUILD_SAFE}}]
| Item material must be stable at temperatures below 11000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe.
|-
| [{{text anchor|GLASS_MATERIAL}}]
| Item material must have the [IS_GLASS] token. All 3 types of [[glass]] have this token hardcoded.
|-
| [{{text anchor|GROWN_NOT_CRAFTED}}]
| Item must be a GROWN wooden item, such as a "grown wooden sword" from an Elven caravan.
|-
| [{{text anchor|HAS_MATERIAL_REACTION_PRODUCT}}:X]
| Item's material has a [MATERIAL_REACTION_PRODUCT] token with the appropriate ID.
|-
| [{{text anchor|HAS_TOOL_USE}}:X]
| Item must be a [[tool]] with the specific TOOL_USE value. The item type must be TOOL:NONE for this to make any sense.
|-
| [{{text anchor|MAGMA_BUILD_SAFE}}]
| Item material must be stable at temperatures below 12000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe.
|-
| [{{text anchor|METAL_ORE}}:X]
| Item material must be an ore of the specified metal.
|-
| [{{text anchor|MIN_DIMENSION}}:X]
| Item's dimension must be at least this large. The item type must be BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, or CLOTH for this to work.
|-
| [{{text anchor|NO_EDGE_ALLOWED}}]
| Item 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.
|-
| [{{text anchor|NOT_CONTAIN_BARREL_ITEM}}]
| If the item is a container, it must not contain [[lye]] or [[milk]]. Not necessary if specifying [EMPTY].
|-
| [{{text anchor|NOT_ENGRAVED}}]
| Item can not be engraved. For example, a memorial slab can not be engraved.
|-
| [{{text anchor|NOT_WEB}}]
| Item must be collected (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| [{{text anchor|POTASHABLE}}] (Deprecated)
| Alias for [CONTAINS_LYE].
|-
| [{{text anchor|REACTION_CLASS}}:X]
| Item's material has a [REACTION_CLASS] token with the appropriate ID.
|-
| [{{text anchor|UNROTTEN}}]
| Item must not be rotten, mainly for organic materials.
|-
| [{{text anchor|USE_BODY_COMPONENT}}]
| Item must be a body part (CORPSE or CORPSEPIECE).
|-
| [{{text anchor|WEB_ONLY}}]
| Item must be undisturbed (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| [{{text anchor|WORTHLESS_STONE_ONLY}}]
| Item material must be non-[[economic]].
|}

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

Reaction

2026-05-15T03:52:11Z

Quietust: clarify that it's specifically grown WOODEN items, then plump helmets become irrelevant

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

'''Reactions''' are modular, editable formulas that take specific ingredients, or reagents, and use them to produce a desired item. Most manufacturing jobs are [https://github.com/DFHack/df-structures/blob/master/df.job.xml hardcoded]—building beds or creating glass, for example—but a few are data-driven, and it's (sometimes) quite simple to add additional ones. There is a separate page with custom [[reaction examples]].

== Reaction differences between modes ==

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 produce it. Exclusive non-{{token|SPECIAL|inorganic}} metals, such as [[steel]], may appear on [[bandit]]s and other entities with access to all materials.

In [[adventure mode]], reactions are freely available in the {{Adv menu icon|x}} create menu, 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 {{token|PERMITTED_REACTION|e}} 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]]
* DYER - [[Dyer's shop]]
* 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]]

==== Building key ====
This used to define the shortcut key(s) used to queue up the reaction in a workshop during gameplay. Doesn't do anything in the current version. {{version|50.01}}

=== 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. They 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, which is not visible to the player, but 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).

When no item type is specified (as in NONE:NONE), workers will not be able to find otherwise eligible items if they are inside of barrels (at least when reagents are PLANT or PLANT_GROWTH type). This is likely a bug.

==== 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 [[File:Mag glass icon.png]] 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 [[File:Mag glass icon.png]] 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]], [[still]] or [[craftsdwarf's workshop]] cannot be made automatic.

==== Mode enabled ====

Some reaction tokens enable a reaction to be used by everyone in a certain mode. These tokens are not exclusive relations; for example, you can assign an {{token|ADVENTURE_MODE_ENABLED|reaction}} reaction with a building to an entity and their citizens can then perform it at that building in [[fortress mode]].

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Description
|-
| ADVENTURE_MODE_ENABLED
| Available to all [[adventurer]]s, regardless of origin civilization. Required for adventurers to craft anything, as they do not use the recipes available to their origin civilization.
|-
| FORTRESS_MODE_ENABLED
| Available to all [[fortress mode]] games. Without {{token|PERMITTED_REACTION|entity}} on a specific entity, materials produced by it will not normally be added to their civilization resources.
|-
| WORLDGEN_ENABLED
| If possible, reaction's output will be added to all civilizations during worldgen, allowing the civilization to trade or embark with them.
|}

==== 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 if assigned to a workshop and the civilization has access.

|-
| style="vertical-align: top"| {{text anchor|FORTRESS_MODE_ENABLED}}{{version|Lua beta}}
|
|
| style="vertical-align: top"| This reaction can be accessed when playing as any civilization in [[Fortress mode]], regardless of {{token|PERMITTED_REACTION|e}}. Particularly useful for compatibility or [[Lua scripting]].

|-
| style="vertical-align: top"| {{text anchor|WORLDGEN_ENABLED}}{{version|Lua beta}}
|
|
| style="vertical-align: top"| Adds the materials provided by the reaction to all civilizations, regardless of {{token|PERMITTED_REACTION|e}}.

|-
| 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 [[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|GROWN_NOT_CRAFTED}}
|
| style="vertical-align: top"| Reagent modifier
| style="vertical-align: top"| Reagent must be a GROWN wooden item, such as a "grown wooden shield" from an Elven caravan.

|-
| 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]]

DF2014:White jade

2026-05-13T00:54:37Z

Quietust: Reverted edits by 118.6.14.37 (talk) to last revision by LethosorBot

{{quality|Fine|21:54, 7 December 2010 (UTC)}}{{gemlookup/0}}{{av}}

'''White jades''' are low-value [[gem]]s that only appear in [[alluvial layer]]s.

{{Translation| dwarven = volal otil | elvish = alire anara | goblin = uslun toslu | human = mela kesmel}}

[[File:Incense burner with flower handles and paired lions knob, China, Qing dynasty, 18th-19th century AD, white jade - Matsuoka Museum of Art - Tokyo, Japan - DSC07234.JPG|center|thumb|290px|White jade jug.]]

{{gamedata}}
{{gems}}

Stupid dwarf trick

2026-04-29T13:19:44Z

Quietust: /* Dwarven refrigerator */ this one is conditional, and I've personally got a 0.31 fortress where it's impossible

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

{{D for Dwarf}}

A '''stupid dwarf trick''' is any project that requires a large amount of time and/or effort. They may provide a practical benefit, but are frequently done for the sake of doing them; they exist primarily as a [[challenge]] for experienced players.

==Adventure mode fortress==


Build a fortress specifically for exploring in [[adventure mode]]. You can either make a nasty monster-filled challenge, or a smörgåsbord of masterpiece adamantine weapons and armor; possibly both. Breaching the [[caverns]] or [[hidden fun stuff]] should ensure the fortress is occupied.

'''Difficulty:''' The sky's the limit.

'''Usefulness:''' None for fortress mode, but filling it with high-quality equipment can certainly be useful for adventure mode.

==Alarm clock==
Are your soldiers all sound asleep while blood soaks the walls? No need to deconstruct their beds one by one, ''if'' you bought the Dwarf Wakey 3000! Simply a solitary floor tile balanced on a support, one or more can be toppled with the pull of a lever to produce an earth-shaking racket that'll have them leaping for their axes!

'''Difficulty:''' Low.

'''Usefulness:''' Limited. They'll sleep through <s>'''anything'''</s> the noise. Although they have been known to awaken when drenched in water, possibly due to thinking it's alcohol. This means an alarm clock is not impossible if carefully prepared.

==Alphabet cages==
[[Image:Cage.gif|right]]
Use captured monsters in cages to spell messages.

'''Difficulty:''' Medium. Vowels are hard to come by.

'''Usefulness:''' Absolutely none whatsoever. Even less if using sprites. (Easy reminders in case you're too lazy to use notes?)

==Altar of Armok==

Build a large altar made out of adamantine, clear glass, magma, and obsidian. The main altar should be hollow adamantine with clear glass "windows." It should have magma inside. The altar should be adorned with large obsidian spikes, as it pleases Armok.

'''Difficulty:''' Medium, raising with the amount (and respective difficulty) of bonuses you add.

'''Usefulness:''' Low to medium. If the chamber containing the altar is consecrated as a [[temple]], dwarves will go there to pray, and may gain additional happy thoughts for admiring the altar's materials and craftsdwarfship.

*Bonus: Guard the altar with a megabeast.
*Bonus: Cover the altar with blood of a Titan.
**MegaBonus: Cover the altar with blood of a denizen of the HFS.
***ArmokBonus: Build the altar in the HFS.
*MegaBonus: Cover the altar in a temporarily lasting strength inducing extract.
*BerserkBonus: Cover the altar in a nausea-inducing extract.
*BloodBonus: Also cover the altar in an extract inducing slow death.
**SychronizationBonus: Make it so that a dwarf that goes into contact with the altar dies the moment the strength runs out.
*SacrificialBonus: Sacrifice a dwarf to the altar every day.
**MegaSacrificialBonus: Sacrifice an elf to the altar every day.
**HistorySacrificialBonus: Sacrifice a human to the altar every day
***MegaArmokBonus: Sacrifice all three species to the altar every day!
*MonarchBonus: Build the altar in the monarch's throne room! Yes, this stacks with the ArmokBonus up above.

==Anthill==
Build your fortresses hallways and rooms on the same Z-axis. Building rooms with depth is fine, as long as their west/east walls are on the same Z-coordinate. All the walls on the Z-coordinate should be glass. Hollow out the opposite section so that the area beside the glass is empty. Build viewing platforms in the hollowed-out space.
'''Difficulty''' High. The limited space is a huge restraint, and caverns are a huge issue.

'''Usefulness''' Very low, although intruders can be forced to climb the viewing area to enter, letting marksdwarves pick them off easily through fortifications.

*MirrorBonus: Instead of a viewing area, build a perfect replica of the fort.
*SuperDwarfGalaxyBonus: Make it horizontal instead of vertical.
**MegaBonus: Build it into the magma sea.

==Aqueduct power==
If your river's a long way away from your fortress, building a trans-map axle may be less efficient than building an aqueduct and pump stack driven by waterwheels in the river. The pump stack raises it to the height of your fort, where it flows through the long, long aqueduct and drives waterwheels on the other end. Getting the water pressure just right so it powers your waterwheel without flooding the fort can be [[Fun]]. Diagonal channels make good pressure reducers.

'''Difficulty:''' High. Lots of stone, lots of engineering, lots of dangerous outdoor work, lots of trial-and-error for the receiving waterwheels. Aquifers will absorb any amount of water at any rate. Using an aquifer as drain for the reservoir will nullify the risk of flooding the fortress due to the drain not keeping up with the supply.

'''Usefulness:''' High. As much water and power as you want, wherever you want, whenever you want.

==Aquifer power==
Aquifers can be a resource of immense power. If you have two levels of aquifer, you can generate a continuous flow by draining one level of aquifer into another and plant waterwheels above it. One stream can power a lot of wheels.

'''Difficulty:''' High. Anything to do with draining aquifers is very [[Fun]]. It is now very rare to find a powerful enough aquifer.

'''Usefulness:''' High.

==Archaeological excavation==
A Fortress in the caverns, built by the first dwarf tribes. Build the Fortress however you see fit for those prehistoric Dwarves (e.g. only primitive metals, elaborate tombs for the chieftains with burial objects, cave art, etc.) and abandon it. Then, embark with modern Dwarves, and excavate the ancient Fortress. Sort of like the Adventure Fortress above, only for Reclaim Mode

'''Difficulty:''' As High as you want.

'''Usefulness:''' Variable. Carving a premade fort or building controlled access to caverns can potentially be useful for a Reclaim effort, effectively making the first wave dispoable setup so your would-be archologists to dig up and exploit their new home. The more Fun you leave behind, the harder it will be for your second wave to repurpose the place.

*Bonus: A museum detailing the lives of those early dwarves.
*Bonus: Create a save with your First Tribe fort collapsed/flooded/etc, for other users to explore. Leave them some Fun what-does-this-lever-do problems to solve.
*EncinoDwarfBonus: Some of those early dwarves frozen in a block of ice.
*FunBonus: Breach the HFS.
**MegaBonus: Do a cave in to the HFS after fighting it leaving multiple signs of battle in the fortress, to be dug by your modern dwarves.

==Artificial waterfall==
{{main|Waterfall}}
To keep the waterfall going, you need a [[pump]] stack, preferably powered by a [[windmill]] or [[water wheel]]. Alternatively, an [[aquifer]], or other limitless water source, makes for a waterfall entirely underground.

'''Difficulty:''' Moderate (Low if there is an aquifer above pouring down).

'''Usefulness:''' Dwarves love [[waterfall]]s. Putting a waterfall in your [[meeting hall]] will give your dwarves good [[thought]]s, although it can significantly lower frame rate.

*Bonus: Build it in a "Warm" or hotter [[climate]] so it does not freeze.
*DwarfBonus: Build it in a freezing/cold/temperate climate and keep it going entire year!
*MegaDwarfBonus: Use [[magma]]. It does not freeze, even in a freezing climate!
*MegaDwarfBonusEXTREME+: Use magma and water in the same waterfall. The results will enshrine you in dwarf history! Possibly permanently.

==Ballista battery==
{{main|Ballista}}
Overlap a few ballistas to completely cover a narrow corridor. There is an unavoidable risk of your operators wandering into the line of fire.

'''Difficulty:''' Low. If you insist on highly trained operators with high-quality ballistas, it gets harder.

'''Usefulness:''' A complicated and dangerous way to defend a single corridor. Ultimately extremely effective. Sometimes.

==Bastion==
Construct an isolated burrow containing a farmer and some labourers, containing at least an uncontaminated well (an [[aquifer]] is great for this) and some farms. Use whatever elaborate mechanism you wish to seal it off from the rest of the fortress. Congratulations; your bastioned dwarves and their descendants will keep your fortress alive forever until one of them goes nuts.

* Bonus: Build your bastion at least in part in a clay or sand layer, add a little magma, and continue manufacturing useless crap even as the world crumbles around you!
** StonksBonus: Rig a way for your bastion to transfer supplies to the outside world without exposing themselves to danger, so they can be somewhat useful to the rest of your fort before their inevitable downfall. Doubles as a way to restock the bastion with fresh supplies and/or bodies, or a way to let the apocalypse in a little at a time if your survivors get too comfortable.
* Bonus: Build it on top of a tower outside, and then deconstruct the stairs up.
* Bonus: Fill it exclusively with vampires, to avoid having to worry about food, children, and aging.
* MegaDwarfBonus: Hollow out a shell around your bastion, connecting it to the rest of the cavern by a single 1x1 adamantine support, and flood the shell with magma.

'''Difficulty:''' Low.

'''Usefulness:''' High. If your bastioned dwarves have high enough quality living space and few enough nonbastioned friends, it makes the fortress functionally immortal.

==Bathtub==
Stop dwarves from hauling in tons of exotic, poisonous sludge into your fortress by creating a tub filled with 3/7 water that everyone has to get through to enter the fortress. Include a system to change the water, so that they don't bathe in grime.

'''Difficulty:''' Moderate

'''Usefulness:''' Low in most cases. High in some evil areas.

* DwarfBonus: Make it drain and refill itself with clean water automatically once in a year.
* MegaDwarfBonus: Clean it with magma.
* *MegaDwarfBonus*: Have an alternative bathtub-buffered entrance next to the main one, which opens automatically when sanitizing the main one and closes and sanitizes itself when it is no longer needed, so that no jobs are canceled during cleansing cycle.
* ≡MegaDwarfBonus≡ : Make it clean itself with magma automatically once in a year, but make it wait for the moment when it's unused, so that no dwarves or pets are incinerated.
* ☼MegaDwarfBonus☼: All of the above, plus make it detect when there should be no dwarves or pets around, but invaders are in it, so that the cleansing cycle can be started prematurely.

==Boat==
In intermittently freezing biomes, [[ice]] may be used to create actual floating boats, submarines, or other floating objects/forts; as constructions built on top of ice do not collapse when the ice thaws.

'''Difficulty:''' High. Needs an intermittently freezing biome, construction is limited to frozen periods, and there's a substantial risk of flooding, drowning and being encased in ice.

'''Usefulness:''' Low. Forts within boats are protected from invaders while the water is unfrozen, but they're also trapped within the confines of the boat.

Note: You'll probably want to limit your saves to the colder months.

* DwarfBonus: Have the dwarves live on the boat.
* MegaDwarfBonus: Make miscreants/nobles walk the plank.
* *MegaDwarfBonus*: Bury your treasure on shore.
* ≡MegaDwarfBonus≡ : Have a pet [[kea]] for each of your dwarves.
* ☼MegaDwarfBonus☼: Build it on top of an ice tower.

==Bolt splitting operation==

## Note: no longer works due to climbing mechanics ##

One curious property of Dwarven physics is that a bar of metal makes 25 bolts, but if each of those 25 bolts is melted separately, they will become 2.5 bars, generating metal from nothing. Prior to the update that allowed splitting stacks at the [[trade depot]], the difficult part was separating the stacks of bolts into individual bolts without destroying them. EliDupree originally discovered this trick:
{{diagram|spaces=yes|color=#888|\
∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
∙++++[#05F]☻∙+++++++++
∙+∙∙∙[#0A0]┼∙+++++++++++++[#BBB]╬[#BBB]╬
∙+∙[#F00]g∙[#0A0]┼∙+++++++++++++[#BBB]╬[#FF0]@
∙+∙∙∙[#0A0]┼∙+++++++++++++[#BBB]╬[#BBB]╬
∙+++++∙+++++++++
∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
}}

The yellow @ at the right is a stack of marksdwarves (all in different squads so that they'll stand on the same tile) equipped with [[adamantine]] (or [[Divine metal]] if you don't have it; or [[Steel]] if you have neither) bolts, standing on top of a stairway surrounded by [[fortification]]s. The blue ☻ at the left is a single [[Attributes#Agility|Perfectly Agile]] soldier with orders to patrol up and down the line of green doors, with little delays at the top and bottom. (The doors are free-standing; they were built attached to a wall, then the wall was removed.) The "g" at the left is a goblin standing on a pillar (pitted from the z-level above).

When the dwarf at the left runs up or down the line of doors, it opens all of them, and some of the marksdwarves loose their bolts. By the time the bolts get there, the doors have closed, so they hit the doors and fall into the channel, where they can be collected and melted separately. (That distance is exact, by the way. Any less and they sometimes get shots through the doors, which kills your goblin. Also, with less-skilled marksdwarves, some of the bolts will stray and land on the floors, but that isn't enough to worry about even with mere dabblers.) Naturally, this is also an excellent way to train marksdwarves.

Another design resembles a tower where marksdwarves shoot from the top, with the following setup: (click then press '<' and '>' to go through different z-levels)
<diagram>
<frame type="level" level=0>
[#7:0]
[%201][%205][%203][%203][%205][%187]
[%186]<[%204][%185][#5:1]g[#7:0][%186]
[%200][%205][%202][%202][%205][%188]

< 01
</frame>
<frame type="level" level=1>
[#7:0]
[%201][%205][%203][%203][%205][%187]
[%186]X[%204][%185][#7:1]O[#7:0][%186]
[%200][%205][%202][%202][%205][%188]

< 02 >
</frame>
<frame type="level" level=2>
[#7:0]
[%201][%205][%205][%205][%205][%187]
[%186]X+[#3:1]/[#7:0].[%186]
[%200][%205][%205][%205][%205][%188]

< 03 >
</frame>
<frame type="level" level=3>
[#7:0]
[%201][%205][%203][%205][%187]+
[%186]X[%186].[%186]+
[%200][%205][%202][%205][%188]+

< 04 >
</frame>
<frame type="level" level=4>
[#7:0]
[%201][%205][%203][%205][%187].
[%186]X[%186].[%186].
[%200][%205][%202][%205][%188].

< 05 >
</frame>
<frame type="level" level=5>
[#7:0]
[%201][%205][%205][%205][%187]
[%186]>+[#6:1]@[#7:0][%186]
[%200][%205][%205][%205][%188]

06 >
</frame>
</diagram>
The '@' is any number of marksdwarves standing on a down stair. You may want to use a defend burrow order to restrict them to that tile. The 'g' is a goblin or any other creature your marksdwarves will normally fire at upon encounter (pitted from 2 z-levels above). The 'O' is a well, which is suspected to be preventing dwarves from plunging in and starting brawling with the creature. Marksdwarves will be able to see the goblin or whatever creature below and will loose all bolts in their quivers on them. Curiously, nearly all the bolts will fail to cross the bend in the middle and will fall onto the tile '/' where they can be collected. This disregards crossbow and archery skills and the only difference they make is the speed at which the bolts are split. This design has the advantage of taking less space and being easier to set up, however it is reported that sometimes the dwarves will not miss some of the bolts. If you are only stationing one marksdwarf in the tower, stationing another one may help the first one miss all of his bolts, even after the newly added one is then removed. Sometimes dwarves will spam job cancellation on the bolt collection level, and it is also reported that sometimes some dwarves will start firing when they are on the bolt collection level. In such cases you may want to seal the collection level off and open it once in a while to retrieve the bolts.

'''Difficulty:''' Moderate. The hardest part is keeping the system running reliably.

'''Usefulness:''' Moderate. While there are certainly [[Exploit#Infinite metal|easier ways to generate adamantine]], this is perhaps the most dwarfy.

*Bonus: Build a [[repeater]] to open and close the doors automatically.

==Break the dam (release the river!)==
Dam a river (or brook) using something non-permanent (floodgates, drawbridges) and build your fortress entrance in the now dry river bed, make sure you can seal it off nicely (floodgates anyone?) then wait till the first Goblin siege, let them get to your entrance floodgates, seal them, open the dam and laugh maniacally.

'''Difficulty:''' Low

'''Usefulness:''' Instantaneous death to all sieges

*DwarfBonus: Use magma.

==Bridge-a-pult==
A bridge that raises under its victims' feet, flinging enemies away.

Bridges don't fling creatures in any specific direction, apart from "up". So it's more of a spring-board than a catapult. If there's a lot of open space above the bridge, creatures can get flung very high - ten z-levels and more - and take appropriate falling damage. Most of them will land atop the bridge, and bringing the same bridge down will simply crush them.

'''Difficulty:''' Fairly easy. Getting the timing right promises to be the biggest challenge.

'''Usefulness:''' There are far more effective ways to defend a fortress, but few are as entertaining.

===Cat-a-pult===
Essentially a Bridge-a-pult with specific ammo.

'''Difficulty''': Very easy, given that you have live cats in your fortress.

'''Usefulness''': Can be used as a way to stop a [[catsplosion]] if used with male cats. [[Unfortunate accident|Cats can also be replaced with elite citizens of your fortress.]] 

==Corpse processing facility==
WARNING: The system can freely jam on any body parts, besides hands and heads, without killing undead.
With the help of a necromancer, corpses your dwarves refuse to butcher can be brought back to life and re-killed to yield bones and skulls for your bonecarvers if they are mushed up enough.

1. The simplest way to do this is with the help of height. A 1x1 pit with a minecart stop that dumps corpses down the chute, and several alternating [[floor hatch]]es that close and open (linked to a repeater) with necromancers behind windows overlooking each layer of hatches to revive the bits of corpses. 2 windows with a mechanism controlled door in between, in front of each necromancer group can be used to control vision; but the system can only be stopped by unlinking the minecart dump to the refuse pile in your routes. Note: when I built this I had 3 hatches with 6 necromancers overlooking each (I had plenty of them since I embarked close to 4 towers). Revived corpses drop to their death and explode onto a tile with unright spikes linked (note that some of them will survive, so you need the spikes with a repeater or lever). The corpses that explode from the impact of height (or from other body parts/undead crashing into them) will hopefully yield bones. You make choose to re-haul up the body parts for another round, but only body parts still attached to a grasping part or the head will be revived, and this system isn't very efficient in the first place, so it may not be worth the trouble. Note that whole corpses usually yield 5-8 bones upon death (avg 6), arms only yield 1-4 (avg 2). You may also use this system with or without necromancers and pit live [[goblin]]s into it, they usually yield 6 bones and some body parts.

2. The second way is much more efficient than the first, but requires 1 or more [[artifact]] [[mechanisms]] to make it work. Instead of using height to kill the corpses, a weapon trap with an artifact mechanism and 10 serrated blades of any material can be used instead (since artifact mechanisms never jam). Only 1 necromancer is needed for this method, and is positioned 3 tiles away from the weapon trap, overlooking it behind 2 glass windows with a mechanism [[door]] in between to control its vision. Your 1x1 pit should still be 5 tiles deep at least though, to prevent dwarves being spooked by the revived corpses. When you're ready, link up the route to the minecart and watch body parts revive and slowly get mowed down. It's recommended you have more than 1 of these small pits set up so you can grind more corpses and clear out 1 pit at a time while the others keep grinding.

Note: To clear out pits, turn off all refuse stockpiles that accept anything other than bones and skulls by turning on "accept from links only" so your dwarves only haul out the bones and not the trash.

Note: Try to use raising bridges as the door for each pit, kobold body parts tend to get mixed into the grinders which can lock-pick its way out of doors and result in doors with "door taken by intruder" and a couple hundred zombie body parts overrunning your fortress from the inside (a.k.a fun).

Note: I didn't try this with many building destroyers, but I'm pretty sure the glass windows are safe. Fortifications are not usable since corpses and body parts tend to get tangled up in them and are hard to get out, and spook dwarves trying to clean out the pits.

*Bonus: Use water to clean out the contents of the pits and wash them onto a 1x1 refuse stockpile.

'''Difficulty:''' Hard

'''Usefulness:''' High, and becomes higher the more corpses you have; especially useful for getting something more out of necromancer sieges than just useless corpses. Can also be used to recycle dead stray animals and your own dwarves that your dwarves refuse to butcher (don't forget slabs).

NOTE: necromancer siege's corpses now drop clothes and gear.

==Crocodile farm==
They're a thing in real life, and you can make them a thing in-game too! Use cage traps to capture multiple breeding pairs of [[alligator]]s, [[cave crocodile]]s or [[saltwater crocodile]]s, [[Animal trainer|train]] them, then create an area to store them with [[nest box]]es. Breed them so you have more crocodilians to keep laying eggs, rinse and repeat.

'''Difficulty:''' Medium, somewhat dependent on RNG - you need to find someplace with available crocs, you want said crocs to actually spawn and you want said crocs to actually get caught in the traps. <s>May</s> Will also lead to an explosive and FPS-shattering [[Catsplosion#Crocsplosion|crocsplosion]] sooner or later.

'''Usefulness:''' Very high, you'll never have to worry about food again simply from cooking the eggs, and that's not counting butchering the crocs when they're adults.

*Bonus: Have alligators, cave crocs and saltwater crocs '''all''' present in the farm.
*SwampBonus: Have your croc farm submerged in anywhere between 1/7 to 3/7 [[water]]. You gotta keep your crocs healthy and wet! But make sure not to submerge the nest boxes!
*SavageBonus: Have [[giant alligator]]s or/and [[giant saltwater crocodile]]s as part of your farm.
**Archcrystal bonus: Replace the crocs with [[Hydras]]. Keep them in a usually unseen location, as any Urist McFoolhardy walking by will try to attack them on sight.
*TrainerBonus: Have your dwarves become Expert alligator/cave croc/saltwater croc trainers.
**SteveIrwinBonus: Have your dwarves become Expert trainers of all croc species.
*HungryHungryCrocBonus: Build your farm in such a way that [[siege]]s have to go through it to reach your fortress.
*UltraCrocBonus: Have [[Alligator man|alligator men]] or/and [[Saltwater crocodile man|saltwater crocodile men]] inhabiting your fortress and helping train the croc farm.
**UltraArmokCrocBonus: Have an entire fortress of croc men handling a croc farm. You're dwarves in spirit.

==Dam==
{{main|Dam}}
Build a wall across a riverbed to stop the flow of water. Floodgates optional.

'''Difficulty:''' On a map that freezes in the winter, or an aquifer located below the river, this is easy. Otherwise, very difficult. (See [[dam]], or Moses effect, below. But with the bonuses it gets a bit harder.)

'''Usefulness:''' Depends on how many bonuses you fulfill. The power station is obvious, and with the control room you could build up a nice defense system.

*Bonus: Excavate a reservoir and a lower river valley. 
*Bonus: Build a control center to control the water flow. 
*Bonus: Draw your entire energy from a power station within. 
*MegaDwarfBonus: Use screw pumps and another dam to replace the water with magma.

==Danger room==
{{main|Danger room}}
A room full of upright spear traps linked to a lever or pressure plate. Teach your dwarves to dodge the pointy sticks!

'''Difficulty''': Low to Medium, depending on how you activate the traps.

'''Usefulness''': Low. While this used to be a very effective training method, it's quite deadly now, even for militiadwarves. They also wear down your dwarves' armor and shields quickly, making them harmful for your long-term survival, even if your militiadwarves manage to survive the room itself.

'''Downside''': Civilians and pets that wander into the danger room will inevitably get killed, even if you use low quality training spears.

*MegaDwarfBonus: Menacing spikes greatly increase the danger, and may help train your medical team (and/or your coffin construction crew).
*UltraDwarfBonus: Use [[adamantine]] spikes! On the plus side, you have a thriving coffin industry going now.

==Day care==
A room where you put all your dwarf children so they cannot be kidnapped by snatchers, or get into accidents. Make a room with beds and tables and stuff, turn it into a burrow, then add all your children to it. Remember to include a food chute to [[quantum stockpile]] a huge amount of food and alcohol on a 1x1 stockpile (so it doesn't rot) in the room. High quality food, furniture, toys, clothing, and socializing should keep them happy. Note that the children will no longer be able to perform certain useful tasks like hauling, crop harvesting and deconstruction, and will not level up their skill in miscellaneous professions like an otherwise vulnerable child, but this is a small trade-off if they usually get kidnapped before maturing anyway. This is probably obvious, but make sure this room is guarded, otherwise it will turn into a Dwarf Orphanage (Dorfanage) (with Goblins and Minotaurs welcome!)

'''Difficulty:''' Low. With the invention of burrows, you can designate the Day Care to contain all children, so it is unnecessary to use suicide-booth-micromanagement to contain the children.

'''Usefulness:''' Varies, depending on the bonuses built. With v50, children are a lot easier to mentally scar for life, making them prone to fell moods and tantrums, so having a safe form of daycare allows them to grow up into adults whose stress levels are usually easier to manage

*SchoolBonus: Make the daycare a guild hall, and add a highly skilled dwarf and another adult to the burrow. The two will give demonstrations that the kids will occasionally watch, gaining experience in a profession of your choice
*OlympicBonus: Build a swimming pool of 4/7 between critical parts of the daycare, so the kids have to go through the water for their everyday tasks, gaining swimming skill and associated stats.
*ChildSoldierBonus: Make the daycare a barracks, and have your crack squad of dwarves spar and demonstrate there to train up the military skills of your dwarven children
*HighSchoolBonus: All of the above, and make [[nobles]] and unskilled migrants stay there to learn.

==Doberman bomb==
Whenever a dog or cat gives birth, stuff all the kittens and puppies in one cage in your entryway. Link this cage to a pressure plate beside it. Should your last lines of defense be breached, goblins will step on it and in the next instant be torn apart by dozens of goblin-seeking hostiles and distracted by dozens of surplus targets. The trap actually going off will probably be very bad for your frame rate.

'''Difficulty:''' Low to high, depending on the animal you use

'''Usefulness:''' Medium to very high, potentially fortress-saving

*Bonus: Train the dogs inside as war dogs
**DwarfBonus: Use [[giant badger]]s, [[tiger]]s, [[alligator]]s, bears, or anything big and aggressive when tamed
***MegaDwarfBonus: Use [[giant cave spider]]s, [[cave dragon]]s, [[blind cave ogre]]s, [[jabberer]]s or something really dangerous and rare.
****UltraMagmaArmokBonus: Use one (or more!) of the following list: [[dragon]]s, [[bronze colossus]]es, [[forgotten beast]]s (bonus points for flesh-melting secretions), an [[undead]] [[giant sponge]], or [[Hidden Fun Stuff|Clowns of Hidden Funland]].

==Drophole==
Imagine an execution tower, for rocks and pants. It's nothing but a very deep 1x1 up-down staircase for express service to the depths. Designate a garbage dump beside the top and dwarves will pitch anything marked for [[Dumping]] into it.

'''Difficulty:''' Harder than it sounds, there's always snags along the way. Surprise caverns can cost you miners and tools. Hitting water can be vexing. Dumping and reclaiming things can be a chore. It may serve as an unintended highway for Fun of any liquid or airborne variety

'''Usefulness:''' It's '''far''' easier to drop ore 100 z-levels to the magma sea than carry it. You can use this to transfer items between burrows.

*Bonus: Minecarts can make this semi-automatic, fed from a stockpile.

==Drowning chamber==
{{main|Drowning chamber}}
'''Difficulty:''' Moderate.

'''Usefulness:''' You can kill prisoners, useless peasants, irate nobles, hammerers, untamable animals, or anything else. Just be ready for something that knows how to swim. Also useful for catching fishies.

*Bonus: Utilize lava.
*Bonus: Utilize trained fish.
*MegaDwarfBonus: Edit the raws and do both.

==Dwarfputer complex==
{{main|Computing}}
A big mess of [[fluid logic|fluid]], [[machine logic|machine]], and/or [[creature logic|creature]] logic full of hatches, floodgates, gears, pumps, etc. and powered by waterwheels, windmills, or useless idle dwarves. Hook it up to doors, bridges, and traps.

'''Difficulty:''' Medium to high, depending on what you want to build. You'll want to build for very high water flow if you have more than a few fluid gates.

'''Usefulness:''' Your mechanics will level up very fast. Manual pumps give something for your haulers to do. Try and make a clock to trigger different mechanisms in different seasons. See if enemies actually blunder into your intricate traps. Watch all hell break loose as water freezes and building destroyers (''bugs, perhaps?'') enter your computer.
*Bonus: Use lava.
**Doombonus: Use lava ''and'' build it so that building destroyers that enter the complex get killed by the mechanisms they destroy.
***SelfRepairingbonus: Use both lava and water and implement the building destroyer killing system, but modify it so it's self-repairing, filling up broken spaces with obsidian.

==Dwarven apartment complex==
Essentially, one of the many possible [[megaprojects]] dedicated to providing dwarves with rooms so high above the ground they get vertigo. Every floor must have plenty of rooms of at least 2x3 squares, with walls and a door surrounding this. Oh, and it has to go up as many Z-levels as possible. For extra credit, decide on what the top story will be (i.e. as many levels up as you deem possible, minus one so you can build a roof) and turn this into a Royal bedroom for a [[noble]], complete with gem windows, artifact/masterwork components, and untold numbers of armour stands and weapon racks. And then build some shorter but wider apartment buildings nearby to turn your fortress into essentially a giant fist with extended middle finger. Extra points for adding extra useless things for luxury, such as a magma-based heating system, fireplaces in rooms, and a lock-down lever in case of goblin attack. (or a self-destruct lever connected to the main supports, in case your dwarfish tenants are unsatisfied with your ☼5-star service☼).

'''Difficulty:''' Low, although the walls around the rooms can be a bit fiddly due to the impossibility of building walls on constructed floors (yes, an extra credit challenge is to do this without using Remove Construction).

'''Usefulness:''' Limited, because you could just dig the things underground and save yourself the hassle. However it is much harder to flood a tower than a cave, in case you're prone to [[Losing|fun]] by water. Additionally, if you have the time and resources to train a sizable force of marksdwarves, placing a few "security rooms" (with barracks, ammunition store, ration cache, armory, etc.) at appropriate floors, complete with fortified balconies, will allow you to take advantage of the higher vantage point.

*MegaDwarfBonus: Extend the tower to have levels below ground as well as above.
*MegaOrwellBonus: Make the whole construction out of clear glass. (privacy? Whatever for?)

==Dwarven courtyards==
Dig large shafts [first dig the staircase to the desired depth, digging out the size you want the shaft to be on all layers. Channel the outer later, then install supports on the base floor. Link the support to a trigger, clear everyone out, destroy the remaining staircase and pull the trigger] then cover them in glass, creating an indoor but light area that will keep dwarves from being irritated and nauseated by the sun, also improving general happiness and allowing close proximity to caverns and magma.

'''Difficulty:''' Medium, make sure not to mess up or you will lose your miners

'''Usefulness:''' Medium. creates vertical circulation and brings light to lower levels.

*Bonus: Punch a large shaft through a multi-level aquifer (hint: punch through the aquifer from below).
*MegaDwarfBonus: Create a network of self-sufficient communities per shaft, allowing them to be sectioned off in case of disaster. (I plan on colonizing HFS eventually on this paradigm, creating a mining team of soldiers to extract, manufacture and ultimately use adamantine products without being connected to the main colony in order to take on the [[Demon|clowns]] while keeping the rest of the burrow safe.)

==Dwarven disco ball==
Why waste all those cut gems on things that only some selfish noble will enjoy? Create as large a wall-less sphere as you can, then cover it in Gem Windows of 3 different-colored gems to make it shine! The bigger, and more valuable gems involved (e.g., [[ruby|rubies]], [[sapphire]]s, and [[emerald]]s, or colored diamonds if you're really masochistic), the dwarfier.

'''Difficulty:''' Constructing a sphere is very hard, especially the larger you make one. Gathering enough differently colored gems can also be very hard, depending on stone layers. Trading helps a lot.

'''Usefulness:''' Negative. More value can be created by encrusting furniture, and Gem Windows lack quality.

*Bonus: Alternating [[alunite]] and [[obsidian]] tiles to make a 'dance floor'.
*MegaDwarfBonus: Use lava contained in glass for illumination.
*UltraDwarfBonus: Caged "[[Elf|dancers]]".

==Dwarven labor camp (aka Dwalag)==
Create an aboveground walled fortress in a freezing climate with guard towers, barracks, housing, and armories. Dig a long ramp downward and add a large mining network below the surface. Make some small military squads to guard the camp. Designate the lower levels as workshops, and when migrants arrive, assign them to the mines. Give the workers minimal food and only water (no booze, booze is for the hypocritical decadence of Dwarkuta's leaders). Have them haul the stone and metal they mine back to the surface and ship the raw materials off to the Motherland. Import only food, booze, weapons, fuel, and other necessities.

*Bonus: Build the giant digging machines. They don't actually have to dig anything.
*Bonus: Go into the raws and rename the beverage of your choice to "Dwarven Vodka", and drink to the glory of the Motherland!
*MegaBonus: Escape. Wait for a goblin siege, then get everyone underground and block the entrance. Let the goblins in. Wait a few months. The goblins are now the guards you must kill.

Step 1. Secure the keys: Make improvised weapons. If you have obsidian at your disposal, make rock short swords.

Step 2. Ascend from darkness: Get your dwarves out of the mines and into the camp.

Step 3. Rain fire: Use your imagination. Try using magma, if possible.

Step 4. Unleash the horde: Attack!

Step 5. Skewer the winged beast: If the goblins brought a giant bat or other flying creature, kill it.

*Bonus: Use a ballista.

Step 6. Wield a fist of iron: Break open the armory and equip your rebels with armor and weapons.

Step 7. Raise hell: Exactly what it says on the tin.

Step 8. Freedom!

*MegaDwarfBonus: In Adventure mode, try (and probably fail) to lead the prisoners to freedom.

==Dwarven refrigerator==
Dig down to the 3rd cavern layer and harvest as many [[nether-cap]]s as you can. Make them all into barrels! Nether caps have the unique property of being 10000° Urist, which is 32°F or 0°C. Now your dwarves can enjoy their favorite alcohol, cheese, and plump helmets chilled to perfection! If you've set your population cap very low in the INIT files, caverns aren't extremely dangerous, but you should still be on the lookout for nasties down there. Remember to wall off your entrance to the cavern once you're finished.

'''Difficulty:''' Low to Medium. Only possible if your 3rd cavern layer actually ''has'' nether-caps growing in it.

'''Usefulness:''' Low. Booze stored inside will not perish due to heat if say, [[magma]] is dumped on it.

Bonus: Also use nether-cap wood to build the walls, floor, ceiling, and door.

Bonus: While we are at it make all your coffins out of it. 'Cryogenically' freeze those corpses!

==Dwarven machine gun==
Build a high fire rate, minecart firing machine gun. Must be fully automatic, capable of reloading itself, and should not jam due to minecarts being disrupted by collisions or derailments.

'''Difficulty:''' Medium to high, depending on fire rate, reload downtime, and whether or not minecarts are filled with [[magma]].

'''Usefulness:''' High. A sophisticated minecart trap can keep out even the most persistent invaders.

*Bonus: Automatically reload minecarts with [[magma]].
*MegaDwarfBonus: Integrate the trap with a dwarfputer so that it can automatically send minecarts to where they are needed most.

==Elephant man armor factory==
[[Elephant man]] are incredibly strong in combat — both in [[Dwarf fortress mode|Fortress]] and [[Adventurer mode|Adventurer]] modes. However, they can't put on normal-sized [[Armor]] — and therefore, walk around in crappy starting armor at best, naked at worst. We'll put [[Elephant man]] to make [[Armor]] — and another [[Elephant man]] for [[Clothes]].

'''Difficulty:''' Easy. Depends on amount of [[Elephant man]] spawning in the world.

'''Usefulness:''' Your [[Elephant man]] [[Military|super-soldiers]] are now properly armored. Considering their size, strength, and possibly training, they are now borderline-invulnerable. Also, you have enough armor complects for your [[Elephant man]] [[Adventurer mode|Adventurers]].

==Emergency destruct stairs==
A tall column of stairs plunging all the way down into the underdark, with a one-tile wide area of thin destructible floor all around it. In case of subterranean invasion, a thrown switch drops a stone O straight down, ringing the staircase and neatly severing all inter-level connections at a blow. Does with one lever and one support what would take dozens of bridges or hundreds of retracting grates.

'''Difficulty:''' Harder than it sounds.

'''Usefulness:''' Sometimes... sometimes they fly.

==Execution tower==
Just a tall tower to chuck your captives to their deaths.

'''Difficulty:''' Easy.

'''Usefulness:''' Lets you dispose of prisoners, and claim expensive silk, meltable iron, and (eventually) useful bones. Also highly amusing.

*MegaDwarfBonus: Send prisoners straight to the [[HFS]]. If some mod makes them survive, the [[Clown]]s will have their way with them. May make retrieving items difficult, however.

==Flak==
If flying enemies circumventing your walls and causing mayhem inside your fortress is a problem, don't use marksdwarves, just make some flak! Simply cover a series of drawbridges in rocks, and when fliers come by pull the lever.

'''Difficulty:''' Easy

'''Usefulness:''' Low. Contrary to the description, marksdwarves are more accurate, versatile, and just better. However, if you manage to hit something with this, there's a large chance of it getting stunned and crashing to the ground. Remember, what goes up must come down, wear your helmet Urist!

*Bonus: Use minecarts and pressure plates to make it fully automatic.
*SuperBonus: Make it closer to real world flak by using burning lignite bins.
*EfficiencyBonus: Use goblins as ammo
*AlternateBonus: Instead of drawbridges and stone, use jets of water to stun flyers, and then release the dogs. Alternatively, burn them in midair with lava.
*FunBonus: Use the above method with lava, except use the lava as a propellent to throw the circus at the local crow population.
*ArmokBonus: Use all of the above to emulate what happens when you drift into American airspace.

==Flamethrower bunker==
If your fortress happens to be visited by a [[dragon]], capture it in a [[cage trap]], then release it into a sealed bunker with [[fortification]]s around the edge. When invaders arrive, watch them get roasted.

'''Difficulty:''' Low, but requires a fair bit of luck - a dragon (or fire-breathing forgotten beast) needs to survive worldgen, then it needs to attack your fortress (instead of a giant/minotaur/ettin/cyclops or other megabeast), and finally it needs to make it to your cage trap without being killed by something else.

'''Usefulness:''' Medium. [[Dragonfire]] can kill almost anything, but will be blocked by a [[shield]] greater than 99% of the time. Adding a combustible floor (such as a paved [[lignite]] [[road]]) will significantly increase lethality for shield-toting targets. Also, any protective bridges in front of the fortifications may melt under sustained fire, leaving you with a bunker that ''nobody'' can safely approach; ensuring the bridge center tile isn't near the fire, or building the bridges (and mechanisms) from [[divine metal]] (or [[slade]]) will make them immune to the fire. Additionally, a skilled enemy archer can easily kill your dragon with a lucky shot, if line-of-sight access is available.

*Bonus: Capture a fire-breathing [[titan]] or [[forgotten beast]] and use it.
*MegaDwarfBonus: Release the denizens of the hidden fun stuff and use them.

==Flood the world==
'''Difficulty:''' High danger. Will kill your frame rate unless you sink the world below water level (river or ocean).

'''Usefulness:''' Will prevent any sieges, at least. Or anything else, save for the occasional invasion of sociopathic [[giant sponge]].

*Bonus: Use magma, just like [[Main:Boatmurdered|Boatmurdered]].
*MegaDwarfBonus: Use trained fish to kill off all creatures not of your colony.
*MegaArmokBonus: Mod the game and do both.

==Gladiator arena==
{{main|Live training}}
Station some soldiers at the bottom of a shallow [[Activity_zone#Pit/Pond|pit]] and dump your captives in. You can also use dangerous animals instead of soldiers. For extra points, put the prisoners in cages connected to ramps underneath the arena floor. One lever will open both the cage and a hatch above the ramp. Variant: build prisoner cages inside the arena, link to a lever outside the arena, lock the soldiers in, and then open the cages. Keep in mind that you can't actually make your dwarves "watch" the battles like an actual gladiator arena, as civilians will flee in fear at the sight of non-restrained hostile creatures, even if they're in a pit and not actively attacking them.

'''Difficulty:''' Low, but time consuming. Some danger depending on the relative skill of your soldiers and the danger of the captive. (If the prisoners have weapons, you can remove them by using {{k|d}}-{{k|b}}-{{k|d}} to dump the cage and its contents, then looking at and undumping the cages themselves with {{k|k}}-{{k|d}}).

'''Usefulness:''' Low to High, depending on how long your soldiers can draw out the execution. Equipping your soldiers with wooden training weapons can greatly increase the fun (and/or [[Fun]] if their armor isn't as good as you thought).

*Bonus: Losers get incinerated by Magma.
*DwarfBonus: Winners also get incinerated by Magma.
*MegaDwarfBonus: Use your arena as a "trial by fire" for migrants.

==Grazer reanimation facility==
Just as stables, but without grass, and on a reanimating biome. Pasture every grazer in a separate box, and build [[cage trap]]s to recapture the animal after it joins [[undead|the Dark Side]]. Make sure to forbid the area after you finish setting things up, because you don't want your dwarves getting <s>killed</s> caught instead.

'''Difficulty:''' Low. You always get some grazing animals to start with.

'''Usefulness:''' You get a decent supply of zombies to use in your [[trap design|cunning traps]]. Depending on your style of play, this may prove to be worth the effort.

* DwarfBonus: Use war [[elephant]]s, or any other giant {{catlink|Grazer|grazing animal}} you <s>bought</s> seized from elves.
** MegaDwarfBonus: Use [[giant elephant]]s.
*** BoatMurderedBonus: Release them all simultaneously to challenge your militia/play out a [[fun|!fun!]] scenario for your fort.
* MenagerieBonus: Create a zoo using only undead grazers.
** DwarvenMenagerieBonus: Combine this with the [[#Zombie_thunderdome|Zombie Thunderdome]] and have a rotation of undead cows fighting in the arena only to be re-caged when they try to leave.
*** ChampionBonus: Give each grazer rooming in the zoo according to their kills, with the champion having the most luxurious room.
**** AltarBonus: Turn the champion's room into an [[#Altar_of_Armok|Altar of Armok]].
**** FreedomBonus: Let the champion and higher-ranking zombies roam freely in their rooms, having to be re-captured for each battle.
***** !FreedomBonus!: Release the champion into your fort.
* HolyGrailBonus: Use white [[bunny|bunnies]].

==Greenhouse==
A [[farming|greenhouse]] is just a farm with the ceiling channeled out from above. This lets you grow outdoor plants without venturing above ground. For maximum style, build the greenhouse above ground and cover it with a glass roof to keep your farmers safe.

'''Difficulty:''' Low.

'''Usefulness:''' Medium. Surface plants can be grown at any time of the year, and some are more useful than those available underground - for example, [[sun berry|sun berries]] can be brewed into valuable [[Sunshine]], and [[whip vine]]s can be milled into superior quality flour. Having greater food and booze diversity can also keep your dwarves happier.

*Bonus: Give it a glass floor to allow surface plants even lower down.
**DwarfBonus: Utilize [[obsidian|volcanic glass]].

==Hammer of [[main:armok|Armok]]==
A gigantic hammer made out of pure steel and/or valuables looming over your fortress entrance ready to smite those foolish enough to lay a siege on you. Also gives you a psychological advantage over the traders who unload their goods under it. Attach to a lever-linked support for quick-smiting.

'''Difficulty:''' Low. Depends on size and materials, though. Make it a gold hammer menacing with adamantine spikes, if you're going for high quality.

'''Usefulness:''' Low-medium. 10x10 size is minimum for practical effectiveness. 30x30 attached to a handle extending from your entrance actually works against sieges.

* Bonus: Cover it with blood.
* MegaDwarfBonus: Make it hollow and fill it with Magma
* ArmoksMachineHammerBonus: Set up an automated system that allows you to reset it quickly. Obsidianizers and the magma sea will be your friends here.

==Human Fortress==
Instead of digging a fortress, build above-ground houses. Create walls to keep the nasties out. The only thing you may have underground are mines and stockpiles. Create a huge stone fort for your nobles.

'''Difficulty:''' High. Building stuff will cost you resources instead of gaining them and flyers can be a real pain. Keep several Marksdwarfs handy!

'''Usefulness:''' N/A. (No cave adaptation)

*Bonus: Pave the roads between houses.
*HumanBonus: Dig a moat around your castle.
*MegaHumanBonus: Fill the moat with lava.
*MegaHumanBonusPlus: Designate multiple dumping spots into the lava moat.
*SurfaceDwellerBonus: Get the stone for your constructions entirely from open-pit quarries, i.e. by c[h]annelling instead of [d]igging.
*MegaSurfaceDwellerBonus: Never use picks at all, all stone and metal must come from caravans or embark.
*WhereTheBeardedLadiesAtBonus: Enforce as many <s>pointless</s> quaint human quirks as feasible, for instance: nominating officials per wealth/popularity/relationships instead of merit and suitedness, coddling Nobles, burrowing farmers, miners, brewers, craftsdwarves and other backbones of society into the most tattered ridings, enforcing a specific religion upon the populace, and so forth.

==Ice tower==

Building a huge tower is easy. To make things more [[fun]], make one out of some exotic material, like [[glass]], [[ice]], or [[gold]].

'''Difficulty:''' Low. You need to be on a freezing map to pull off an ice tower.

'''Usefulness:''' Depends entirely on you.

* BabelBonus: Use [[DFHack]]'s <code>infiniteSky</code> and build to the heavens themselves.

==Journey to the Center of the Earth==

Construct a sturdy vessel hanging over the top of a magma pipe or volcano, outfitted with everything your intrepid crew might need for their journey of exploration - food, booze, sleeping quarters and a bridge are a must, but depending on the amount of effort it can include other items such as a recreation deck, water reservoir and trade depot for dealing with the natives. When all is ready, lock the explorers inside and send them on their way. Bonus points if you can detach it from inside so you can use it in Adventure mode later.

'''Difficulty:''' Moderate to High, depending on the size of the ship. For bonus points, carve the entire thing out of existing rock overhanging a magma pipe and engrave it with messages. Burrows help to get the whole crew inside at the same time.

'''Usefulness:''' [[Cave-in|Negative]]. For some reason, no explorers have returned. Of course, if you select only the [[Nobles|Best and Brightest]] for the ship's crew...

*Bonus: Drop the vessel into a deep cavern
*SuperBonus: Make the outer walls, roof and ground floor completely out of glass, so that the explorers can watch everything around them.
*VampireBonus: Send a vampire with the crew!
*MegaDwarfBonus: Drop the vessel into a halfway-empty adamantine vein
*YouHorribleEvilDwarfBonus: Drop the vessel into the [[Hidden Fun Stuff]]!
*YouHorribleInsaneDwarfBonus: Drop the vessel into a glowing chasm.
*OhMyArmokBonus: When you arrive to the bottom of the magma sea, excavate and then create a new community under it!
**OhMyF****ingArmokBonus: Send supplies every year!
**IsThatEvenPossibleBonus: Send a piece of an aquifer down there to provide water! (Mine around a water-producing tile, build the ship around it, then send it!)
**≡MegaDwarfBonus≡: create a high enough tower and drop it into the magma sea to connect the surface and the undersea community!
***☼MegaDwarfBonus☼: create ''two'' towers and use one to send water down there!

==Single-lever emergency lockdown (LEL)==

The only real requirement is that you need a fort based around a central stairwell. All you need to do is leave space for and eventually build the same number of bridges (that raise!) as your stairway is tall on each side of your stairwell on every level, and then link them all to the same lever. Friends get through all your best traps and champions? Simply pull the lever, and they're trapped in the central stairwell forever! Remember to roof off the entrance if your fort is situated on flat land otherwise the bonuses become much less useful. Also important is to ensure that you either wall off access or include sealable bridges or doors (linked to the same lever of course) for any inter-level paths that bypass the main stairwell, like vertical axles running out of centralised power generators.

3*3 stairwell setup:

{{diagram|1=
O[#6ff]╞[#6ff]═[#6ff]╡O
[#6ff]╥XXX[#6ff]╥
[#6ff]║XXX[#6ff]║
[#6ff]╨XXX[#6ff]╨
O[#6ff]╞[#6ff]═[#6ff]╡O
}}

'''Difficulty:''' Medium to High, depending on whether you use the MegaDwarfBonus below or not and how much you spread your fortress over the layers - although more spread means more usefulness. Extremely time-consuming, and requires architects, masons, and mechanics, as well as a lot of mechanisms (2 per bridge, ~4 bridges per level)

'''Usefulness:''' Medium to High, also depending on whether you use the Bonuses. With all bonuses applied it becomes a guaranteed last resort way of destroying the toughest enemies with minimal dwarven casualties; without the bonuses it's still a damn sight better than letting temporarily victorious enemies run freely about your fortress.

*DwarfBonus: Connect your cistern to the stairwell (remember to put a floodgate in too). Once the impossible-to-defeat enemies are safely trapped inside, Pull lever number 2 and watch them slowly, slowly, drown (VERY IMPORTANT: have the level of the cistern input at at least the same height as the level of the stairwell, else there won't be enough pressure to properly flood the stairwell, meaning nasties WILL survive).
*MegaDwarfBonus: Connect your MAGMA cistern to the stairwell. Laugh maniacally. (Remember to build your bridges and floodgates out of magma-safe material or a lot of !!FUN!! will be had)
*MegaArmokEntombmentBonus: Do both and cast your enemies in obsidian and boil the survivors in steam as a semi-permanent testament to their foolhardiness. This also means that you will have stairs cut out of lovely obsidian once your miners are finished making your stairwell usable again.
*MegaArmokEntombmentEXTREME+Bonus: "Forget" to pull the lockdown lever before you pull lever number 2.
*MegaArmokEntombment<s>'''Bait&Switch'''</s>Diplomatic+Bonus: Set the highest level up on another switch, with a particularly <s>'''demanding and annoying noble'''</s> skilled diplomatic representative is waiting at the very bottom to <s>'''lure'''</s> invite them all down for a nice meal on <s>'''his flesh'''</s> the stockpile of food and booze that's keep him ever so happy. Then you can wait for the entire army to flow into the stairwell before flipping the switches. Don't forget to carve a statue out of the block of the noble! What noble doesn't want their grand <s>'''sacrificial defense'''</s> diplomatic skills to be immortalized in volcanic glass?
**UltraArmokBonus: Defeat all your invasions this way, and build a temple to Armok full of the once noble, now obsidian statues, as well as only the highest of quality (and value) memorial slabs.

==Magma Lock System==
This system is a little more complicated than the LEL system described above, and requires that you space out all of your floors so that there's a 'plumbing floor' between each level. From there you set up tons and tons of magma proof floodgates and hatches. Each 'area' you wish to be self-contained from one another needs at least a 3x2 hallway separating it from the other areas. 4 of these will contain flood gates, and the other two must remain bare. Above one of the two bare points you need to have a hollowed out space, and connecting into it from one side you need to have a hatch leading to your water plumbing system, to the other, a hatch to your lava plumbing system. You need two levers for controlling this, one lever is connected to all of the lower floodgates, the other to the upper floodgates. Pull the first hatch to lock in the flood gates just in case, the second to the upper flood gates to begin pouring in water and magma and have them make obsidian filling the entire hallway, sterilizing it of literally anything that could have contaminated it. You do this instead of hatches so they'll drop in properly and mix with no risk of only one side or the other of the hallway turning to obsidian and resulting in a dangerous leak. Throw the first switch again to open up the floodgates and begin mining to access the old chambers again. Whatever was invading your fortress, whether plague, necromancer, clowns, or forgotten beast, will be safely locked away, and unable to break back out whether or not it possesses building destroyer or not. Then you just have to wait for your miners to dig their way out. You can simply avoid the chambers that still have FUN inside, and any the purity of magma and obsidian will have utterly obliterated any traces of contaminants between containment zones.

'''Difficulty''': Medium to High. While not dealing with anything overtly hostile, this process more or less demands that you plan your fortress from the start for this specific system and deal with lots and lots of moving parts, mechanisms, and similar, plus the power necessary to pump magma and water into this network in a timely manner.. If you screw up part of it then it's very easy to end up with your entire fortress flooded with water or magma. Build it on small and give it a test run then expand it once you've gotten the process working for a single chamber, such as the chamber leading to your cavern layer.

'''Usefulness''': High. Depending on how you prepare things (See the bonuses below) the necessary set up for all of this will result in a network of magma and water pipes in every single level of your fortress, powering forges, wells, baths, showers, and defenses of all sorts. Then when things are at their worst, throw a switch and barring one or two (or many depending on how many dwarves are transitioning between containment areas) horribly swift deaths, your entire fortress is safe from any possible threats. You can also prepare chambers ahead of time for other activities and use this to trap enemies in them for later usage.

*DwarfBonus: Put a stockpile of food, drink, and pickaxes in each containment area.
*MegaDwarfBonus: Put a lever in every zone connected just to their own, so your dwarves can heroically seal off an entire section by themselves if necessary.
*UltraDwarfBonus: Extend the hallways, and make the water half of them use grates and constant water falls to give good thoughts while traversing between zones. Change up your levers to shut off the water for when digging begins again.

==Maze==

A maze of twisty little passages, all alike. [[Trap]]s and dangerous animals are essential. You can have a retracting bridge drop invaders in, or just have a labyrinth as a back door.

'''Difficulty:''' It's a lot of mining. Having a bridge drop invaders inside is more difficult, but more useful. You can also use the free maze-generating program Daedalus, available [http://www.astrolog.org/labyrnth/daedalus.htm here] if you're too lazy to come up with your own.

'''Usefulness:''' It makes a nice element of fortress defense, and you can dump your prisoners inside it. Also makes a great place to explore in [[adventure mode]].

*Bonus: Generate a world with large mountain [[cave]]s. Instead of using the labyrinth as your backdoor, use it as your fortress.
*Filodorima: Release a live caged [[minotaur]] into the maze.
*MegaBonus: Make it three-dimensional and [http://gwydir.demon.co.uk/jo/maze/design/index.htm#uni unicursal].
*MemorialBonus: Capture the Goblin King and make him fight the Minotaur.

==Magma chamber==
'''Difficulty:''' Dangerous as any magma project.

'''Usefulness:''' It's like a drowning chamber, but any non-iron items carried by the victim will be destroyed. Depending on your style of play, this may be a good thing.

==Magma cannon==
[http://www.bay12forums.com/smf/index.php?topic=33837 It can be done!] It uses a row of pumps to pressurize the magma in a chamber with only one exit. When the floodgate opens, the magma flies out a short distance.

'''Difficulty:''' Very high. You need [[metal]] (or [[glass]]) [[screw pump]]s to make it work, [[magma-safe]] floodgates and mechanisms, plus a big above-ground construction.

'''Usefulness:''' Marginal. But very cool.

==Magma access early==
ASAP from embark, dig down to the magma. 
Make 2 magma proof pumps, 
make a small (5x5?) room that you can pump magma into and out of and 
make a stockpile for only iron & steel minecarts in the room. 
Be sure to make enough minecarts to fill the room. 
Once the room is full of minecarts, seal room and pump it full of magma. 
Then pump the magma out. 
Delete the stockpile. 
Make a new stockpile near your forge/smelt/glass/kiln area. 
Haul minecarts by hand (or magma proof wheelbarrow). 
Use tracks and stops to dump 4 deep magma into shallow pits. 
2 minecart loads per pit. 

'''Difficulty:''' Low. 
'''Usefulness:''' Very High. 
*Bonus: !!Magma Economy By Autumn!!
*ObsidianBonus: Instead of pumping the magma out, drain water from a nearby lake or aquifer cistern onto it to turn it into obsidian. Carve out the minecarts, magma safely still inside, and enjoy the extra obsidian you have. Watch out not to flood the fortress!

==Magma highway==
Magma moves across the map annoyingly slowly, due to its thickness and lack of pressure. But a tunnel several Z-levels high, with magma entering at the top, will flow much faster because the magma's '''falling''' in, not flowing in, and can expand on either Z-level before falling down.

'''Difficulty:''' Medium. Not hard to make, but cutting open a multi-Z magmafall is [[fun]].

'''Usefulness:''' Medium.

==Magma mausoleum==
This trick involves dripping water on to the middle of a magma pool until you have a column of obsidian, then channeling down into the obsidian ''more than'' one Z level, and putting a burial receptacle there. This probably won't work in magma tubes or Volcanos since the created obsidian would fall into the bottomless pit. The trick is getting the water to fall onto the magma in a controlled manner.

'''Difficulty:''' High. Requires certain resources from the start, plus lots of setup. And your dwarves tend to erupt into dwarf steam occasionally.

'''Usefulness:''' None, since an obsidian lined room with exactly the same furniture somewhere else will please your nobles just as much.

*Bonus: Put the coffin at least 20 floors down.
*MegaBonus: Build it in a volcano if possible, and put the coffin at the very bottom of the map

==Magma sea colony==

If you cast obsidian around the edges of the magma sea, it is possible to pump out the magma and build a colony in the empty space. Once the colony is built, you can destroy the obsidian walls and refill the magma sea. Note: you cannot cast obsidian on the bottom layer of the magma sea, so building a colony on this layer is nearly, but not quite, impossible (see below).

'''Difficulty:''' High. You need to get water down to each edge of the magma sea, and you need a pump stack to get rid of the magma.

'''Usefulness:''' None.

*☼MegaDwarfBonus☼: Build your colony on the floor of the magma sea. This will require draining the sea to the next-to-bottom layer as described above, then dumping enormous amounts of water into the bottom layer to crowd out the magma while simultaneously draining the magma from holes poked in the magma sea floor. Constructions can be built at the border between the water and the magma. See [http://www.bay12forums.com/smf/index.php?topic=128226.0 This forum post] for full, detailed instructions.
* Bonus: Obsidianize the entire magma sea, leaving a single spot to use as a source for pumps. Then proceed to carve your new fortress subsection out of this bounty.

'''Difficulty:''' Insane. The project will take at least ten years of dwarf time and claim many lives.

'''Usefulness:''' Low. You can finally get the last bit of adamantine when you drain the magma sea, and the magma sea floor has a cool twinkly effect.

==<s>Magma</s> Lava sprinkler==
Build a twisting <s>magma</s> lava aqueduct above the entrance to your fortress. Leave a few thin (diagonal) holes in it, so that lava can seep out of it. When invaders arrive, pump magma into the sprinkler. Diagonal holes will limit the rate at which the fluid flows out of them, ensuring a nice steady lava rain rather than a big wave.

'''Difficulty:''' High. Similar to magma canon, except with a bit more engineering, but less pumps and smaller reservoir needed (due to less magma being required for the same effect).

'''Usefulness:''' Medium. Like magma cannon it can obliterate a siege, but this time you can have a bit more control over how it happens. Lava rain doesn't depend on ground structure (your entrance doesn't need to be in a valley for it to work well) and leaves less magma to evaporate.

*Bonus: Cover the holes with floodgates or hatches and keep the lavaduct filled with lava rather than filling it only when using it.
*Bonus+1: Build the lavaduct in such a way that it starts raining on the outermost part of the area first, then goes inwards, to ensure that invaders who start burning can't escape.

==Mass cage recycling system==
{{main|Mass pitting}}
Build a [[mass pitting]] system to recycle your cage trap cages quickly.

'''Difficulty:''' Very easy. Requires basic digging and very little time.

'''Usefulness:''' Very. Keeps you from having to build cages before releasing monsters from them. With six hatches you can safely empty out 48 cages very quickly. You can build lots of cage traps without having to worry about emptying each cage individually.

*Bonus: Cover the floor of your pit with cage traps, creating a neverending cycle and giving your dwarves something to do during the long harsh summer when going outside is overly taxing on their stomachs.
*ConcentrationCampBonus: Combine with Pit of Doom below.

==Mega/Water drowning trap-thing==
{{main|Drowning chamber}}
This is basically a channel above some pressurized water with a short tunnel leading to a door. The door needs to be connected to a lever somewhere in a safe part of the fortress. Position the door facing the main stairs into your fortress (for multiple stairs use multiple traps). When enemies come down the stairs, pull the lever and make them drown. (It helps to seal off the rooms).

'''Difficulty:''' Medium. Needs flowing water under pressure and levers.

'''Usefulness:''' Medium. Depends on the size of your fortress/defences/amount of attackers. Works well with fire creatures to create a sauna.

==Minecart spiral==
Build a giant spiral [[Minecart#Impulse ramps|minecart impulse ramp]] all the way from the [[magma sea]] to the surface. You can use it to transport ores to the [[magma smelter|magma smelters]] at the bottom from [[sedimentary layer|sedimentary layers]] near the surface. You can build [[statues]] in it to prevent dwarves from walking in and [[fun|dying]].

'''Difficulty:''' Medium-High. You will most likely have to use [[macros]]. Additionally, when crossing caverns you will have to [[construct]] minecart ramps which can be tedious.

'''Usefulness:''' Medium. It depends on how tall your map is and how much ores you consume.

*TrapBonus: Use [[bridge|drawbridge]] to guide invaders to the spiral, then [[screw pump|pump]] water into it and drown them.
**BetterTrapBonus: Make it [[magma]] instead.
*SuperBonus: Make the tower go all the way to the highest [[Z-axis|Z level]].
**ArmokBonus: Make it go through the magma sea, and [[HFS|further below]].
*Bonus: At the top, set up a system where dwarves can guide minecarts to different vertical shafts where the will fall to different Z levels, for loading. Then, the minecarts fall further down to the smelters, where the empty minecarts are sent back up for loading.
**MegaBonus: Divide your dwarves into two separate [[burrows]] connected only by the minecart spiral and the shaft. The higher burrow is in charge of mining, growing food, and operating the minecart system, and the lower burrow is in charge of smelting ores and making crafts.
***HyperMegaBonus: Close off all stairs and add a minecart loading and unloading station at every inhabited z level. All vertical transport of goods should be done via minecarts only. Also, dwarves are not allowed in minecarts.
****UltraSuperBonus: Build a minecart loading and unloading station at every Z level, even the uninhabited ones you never use.

==Mist generator==

Using whatever screw-pump-statue contraption your dwarves can muster up, create an endless mist-generating machine which will hopefully not obliterate your [[Frames_per_second|FPS]].

'''Difficulty:''' Extremely easy. You will only need a basic understanding of screwpumps and gear assemblies. However, you can scale it to any size or level of complexity. The [[Mist|mist page]] has a handy guide.

'''Usefulness:''' Borderline cheating. Keeps your dwarves in a state of constant euphoria. Mist does funny things to a dwarf's mind. Also a one-up from artificial waterfalls as they only need to travel a single Z level, (hopefully) reducing the FPS strain.
*Bonus: Build an absolutely horrible fortress with as much [[miasma]] and [[hateable]] vermin that you can fit in one bunker. Keep your dwarves sane with the power of Mist™ alone.
**FUNbonus: Build it in a semi-freezing climate instead. Watch as winter rolls by and your dwarves are deprived of their only source of joy. [[Fun]] will surely ensue.

==Monumental statue==
'''Difficulty:''' Depends on how big you want the statue to be. If you are feeling really masochistic, cast it out of obsidian using magma and water.

'''Usefulness:''' None.

*Bonus: Make the statue hollow and have dwarves live inside it.
*BestWayToGetRidOfStoneBonus: Make one for every dead dwarf.
**UberTombBonus: Use the statue as a tomb and put their coffins in it.
*Dwarfbonus: Give the statue magma eyes.
**HellNo,DwarfsYesBonus: Combine the magma eyes idea with the magma cannon idea above and place the statue just behind (and above) the entrance to your fortress.

==Moses effect==
With enough pumps, you can pull water out of a square faster than it flows in. This can create a reverse waterfall, or a dry spot in the middle of a flowing river. The effect is like Moses parting the Red Sea.

'''Difficulty:''' Surprisingly easy.

'''Usefulness:''' You can use this trick to create a waterfall or drowning chamber. It is also important if you want to pass through an [[Aquifer]], although that is far more difficult. The same trick can be used in lieu of a drawbridge, although its practicality as compared to the drawbridge is highly questionable.

*Bonus: Use the Moses effect to make doors from water, which are opened/closed using a lever.
*TechBonus: Automatize the doors so that they open (only!) when a dwarf is near.

==Never-ending shower==
{{main|Waterfall}}
Don't you get angry when your dwarves carry enough grime on them to dirty the entire fortress? And how they get infected because of that griminess? Suffer no more! With the Never Ending Shower (NES for short), dwarves will be able to stay (relatively) clean without having to take the time to run for a bath or dirtying your drinking water!

It is easy to understand: use the same instructions as in the Artificial Waterfall, but make it so that the waterfall is somewhere where the dwarves will be going through almost daily--a central stairway works well. It cleans them and gives them happy [[thought]]s for the same price!

'''Difficulty:''' Moderate to high. You do have to make sure that dwarves don't try anything funny, and create a drain to draw the dirty water out.

'''Usefulness:''' Incredibly high. Reduces risk of infection and keeps your dwarves happy.

*Bonus: Use an aquifer to get clean water AND drain dirty water.
*Bonus: Use levers to control the NES.
*SuperBonus: Make it work as a trap!
*SuperDuperBonus: Make it work as a trap AND as a recovery system!
*ArmokBonus: Make it so that magma can be poured down, too!

==Nuclear Fallout Bunker==
Build a mini fortress with everything your dwarves could need deep underground. Stock it with enough food, drinks, and materials to last your small band of survivors for years or alternatively make it self-sufficient with its own food production. Lastly, add a bridge that allows you to seal off the bunker from the rest of the world.

'''Difficulty:''' Easy-Medium depending on the relative luxury of the bunker and how many dwarves you intend to shelter from the apocalypse.

'''Usefulness:''' High. If your fort is threatened by some particularly nasty disaster (be it zombie goblin horde or Bronze Colossus) simply rush your best and brightest dwarves down to the Nuclear Fallout Bunker and raise the bridge, sealing it off from the rest of the world.
*MutallyAssuredDestructionBonus: Have a self-destruct lever in the bunker that is pulled once everyone is safely inside.

==Obsidian factory==
{{main|Obsidian farming}}
You need one reservoir of water, and one of magma. Mix, cool, mine, and repeat as necessary.

'''Difficulty:''' Medium.

'''Usefulness:''' Obsidian is 50% more valuable than [[flux]] and 3 times as valuable as ordinary stone, making it ideal for your [[mason]]s and [[stone crafter]]s. Done properly, it can also serve as a magma chamber, a drowning chamber and even an obsidianizing chamber that can kill any creature that gets in (except [[ghost]]s and possibly [[vermin]]).

* MegaDwarfBonus: Make the system fully automated using [[computing]] principles.

==Pit o' doom==
Combine with an Execution Tower for maximum z-level executions! Traps which menace with spikes are a must.

'''Difficulty:''' Low. You want it nice and deep though.

'''Usefulness:''' Dispose of prisoners, execute nobles, gruesome fatal injuries, laugh maniacally. If high enough, you may be able to recover [[bone]]s from creatures your dwarves refuse to [[butcher]].

* Bonus: Link the spikes to a lever so you can proceed to make swiss cheese of whatever didn't die from the fall.

==Pixel art stockpiles==
Arrange several stockpiles of similar items of different colors (gems work well for this) so the different colors make some sort of picture. Don't forget to set "max bins" to 0 on all the stockpiles so you can actually see the items!

It's probably also a good idea to forbid the items once they're in place, to prevent them from being moved later (and allow you to remove the stockpiles if you want.)

'''Difficulty:''' Medium; only tricky parts are (potentially) finding enough items of different colors, and keeping track of which colors are where before the hauling is done.

'''Usefulness:''' Negative

==Pressure washer==
A huge tower with floodgates at the bottom on one side. When opened, the pressurized water fires out and instantly submerges anything in the way of the flow. Depending on size, can be surprisingly powerful. You can see an example tower [http://mkv25.net/dfma/map-7485-griffonwind here].

'''Difficulty:''' Medium, construction technique takes some consideration.

'''Usefulness:''' Medium-High. Tested in version 0.28.181.40d with 50 recruits standing in front of it when the floodgates opened, killed 46 of them, including ones not pushed into the pit.

* Bonus: Fill it with Magma instead (though it won't flow out nearly as quickly).

==Quantum Blizzard Cannon==

Do you need to kill something? Is atom-smashing no longer a viable option? Do you wish to bring glory to Armok? Do not fear, the QBC is here! By creating individual stops to fill minecarts with projectiles of your choosing, then loading up to 12 filled minecarts into a final “Launcher” minecart (using a stop designated to fill the "launcher" with minecarts), you can effectively fire as many items as you would like at your foe using a standard minecart shotgun. It is also possible to fill this with fluids, to great effect (and risk of crashing the game). This can often have interesting effects because hitting a goblin with 996 bars of lead at extreme speeds is not good for the squishy bits. The cannon gains its name from its creator.

''' Difficulty:''' excessive, lots of time in menus and loading per shot, but really ((Fun))

''' Usefulness:''' medium to low. The same trick can be used to move large amounts of items via minecart, but ultimately the QBC is excessive for even the HFS.

==Redesign the fortress==
And when we say "redesign", we mean completely replanning and rebuilding the entire fortress, from scratch. Ever thought about a cool thing that you could add to your fortress, but can't because a critical area(such as the dining room, general-purpose stockpile, central workshop area etc.) are in the way? Did you start the fortress by building the most critical areas in the first available spot? Well, now is a good time to get rid of that! For added effects, put the sleeping areas especially close to the booze stockpile so that dwarves are always happy!

'''Difficulty:''' Varies depending on the size of the fortress.

'''Usefulness:''' Varies depending on how you carry it out, a.k.a. the efficiency of the new organization.

* Bonus: use [[obsidian]] casting to carve the new fortress entirely out of obsidian.
** DwarfBonus: but keep valuable walls such as [[native gold]].
*** PurpleDwarfBonus: using controlled [[cave-in]]s, arrange for your king's new room to be entirely bordered by native gold/platinum/aluminium walls.

==Rehabilitation centre==
Had any problems with dwarves charging brainlessly towards the enemy, getting slaughtered, and then starting a tantrum spiral that will destroy your fortress? Turn your prison into a luxurious room full of things that make dwarves happy. Add artifact furniture, beds, a booze stockpile, chains made of gold (or anything valuable,) a waterfall, creatures in cages, etc. Hopefully they will return to society as a happy, productive dwarf.

'''Difficulty:''' Low-Medium. Acquiring valuable items and setting up the waterfall can be annoying sometimes. Also you need guards to actually put them in jail. And it can be a real pain when those ungrateful sobs destroy the nice furniture you give them.

'''Usefulness:''' High. A tantrum spiral can quickly turn a productive fort of 200+ dwarves into a rioting fortress inhabited by a bunch of insane, miserable dwarves who spend their time punching people and breaking furniture. Don't let it happen to you.

* MegaDwarfBonus: Points for making every other dwarf drink water and sleep on cheap beds.

==Road of the damned==
Create a giant channel filled with spike traps, 10 tiles wide and going all the way from your fort to the map edge. Pave it over with crystal glass so traders can get that foreboding feeling that'll make them seal the deal without bargaining too hard!

'''Difficulty:''' Low-mid, depending on the rarity of crystal glass.

'''Usefulness:'''Low. The same as a normal road.

* Bonus: Spike a goblin on every trap!
* Megabonus: Spike traders who annoy you on the traps!

==Roof of the world==
Sick of having your dwarves vomit all the time when they go out to retrieve loot or lumber? Despair no more! Build an almost-infinitely tall tower, and then put a floor on the highest level, spanning the entire map. For extra kicks, make a mechanism that will crash the entire thing upon the heads of the one goblin horde that manages to get through all your other deathtraps.

'''Difficulty:''' Medium. Very grueling.

'''Usefulness:''' Low, but potentially fortress-saving. (see above)

==Sectorized world==
Divide the world edges into multiple sectors and then gate access to each one separately. This allows you to protect your fortress from sieges whilst keeping access to most of the outside world and allowing most traders into and out of the fortress (those unfortunate enough to enter the world from the same direction as the siegers may be screwed, of course). For bonus points, build separate gateable access routes for each sector. For further bonus points, design your fortress so that you can simultaneously allow access to traders ''at the same time'' as siegers are exposed to your defensive mechanisms.

'''Difficulty:''' Low, unless you allow separate access routes for each sector in which case high.

'''Usefulness:''' Moderate, increasing with each bonus you fill. Mostly for those who want to build the best possible defenses. Can also double as a means of easily trapping wild animals.

==Self-contained vampire-based factory==
Take advantage of the independence of vampires by building a self-contained factory. The best industries are those that require no special raw materials-- a factory containing both a magma glass furnace and a sand tile, for instance, would work well, as would a clay industry, but if you're feeling ambitious, consider building a vampire into your [[giant cave spider|GCS]] [[silk farm]]-- if you happen to have scored an [[undead]] GCS, your vampire won't even spook! You can treat your factory as a piggy bank to be broken into as needed, or for perfect fire-and-forget action, build a dropping [[User:Vasiln/Undump|undump]] into the factory, and the vampire will deliver the output to your front door.

'''Difficulty:''' The only hard part is getting yourself a [[vampire]].

'''Usefulness:''' Depends on how many green glass blocks you plan on using.

==Sapient zoo==
Start by creating a [[zoo]] containing at least one of every [INTELLIGENT] and [CAN_SPEAK] creature
including [[humans]], [[elves]], [[goblin]]s and [[kobold]]s.

*Bonus: include a berserk dwarf in cage

'''Difficulty:''' Easy for some, Hard for others

'''Usefulness:''' None, really, a place for dwarves to throw a [[party]].

==Self-destruct lever==
A mechanism that, for example, could flood your fort with magma, or release a trapped megabeast. For bonus points, build the whole fort on a single [[support]].

'''Difficulty:''' Very high. Extremely fun.

'''Usefulness:''' Could serve as kind of a last revenge on a goblin siege, but also highly amusing. If done properly it can make reclaim easier.

* DorfBonus: Make it have a timer before your fortress self-destructs. You can do this with a water channel, or if you're particularly technical, make a [[Computing|seven segment display]].
** For bonus Dwarfy-ness, make the timer be the depth number of the magma or water that will actually trigger your fortress' destruction.
* Bonus: Build your fortress high above ground, connect the fortress to a roof through just one support and have the system, when activated, drop the whole construction into the magma sea, destroying the whole thing permanently.
* FunBonus: use the lever to drop the fortress off a pillar while simultaneously opening the [[hidden fun stuff]], preferably in a whole lot of places.
*ExtraFunBonus: do as many of these bonuses as you please (as long as they still function together) AND unleash a whole lot of dwarves throwing tantrums near the lever when you wish to set the fun things off.

==Shark catcher==
Capture of [[Bull shark|sharks]] or [[Carp|other]], [[Sturgeon|dangerous fish]] achieved by making an artificial bay, filling it with [[Cage trap|cage traps]], opening the floodgate to the sea or river and some sort of drainage system, likely pumps and/or floodgates.

'''Difficulty''': Low to Medium as drowning while setting up is very possible with bad planning.

'''Usefulness''': Low, purely aesthetic, but very cool to have a shark infested moat (Potentially kills invaders).

==Silk farming==
{{main|Silk farming}}
Capture a web-slinger (generally a [[giant cave spider]]) and build a farm to efficiently harvest its [[silk]].

'''Difficulty''': Low to Medium; the hardest part is generally catching the web-spinner.

'''Usefulness''': Medium to High. Provides an endless supply of potentially-valuable [[silk]] cloth and rapidly [[cross-training|cross-trains]] [[weaver]]s.

==Steamed vegetables==
Make a pot and drop <s>elves</s> vegetables in from about three levels up. This makes it so the vegetables do not <s>run</s> get overcooked. Proceed to bask the vegetables in [[steam]].

'''Difficulty''': Medium. Can be annoying to boil some water.

'''Usefulness''': Great way to make friends with the merchants.

*MegaDwarfBonus: Add <s>goblins</s> seasoning.
*ArmokDoubleBonus: Use [[magma mist]].
*DwarfBonus: feed any vegetables you did not steam to your dear friends, the [[Demon|clowns]].

==Swimming pool==
{{main|Swimming#Learning/Teaching swimming|l1=Swimming § Learning/Teaching swimming}}
It's a reservoir that fills to 4/7 exactly. Station soldiers inside, lock them in, and fill. This way they gain [[swimming]] skill.

'''Difficulty:''' Low. It's just a pair of reservoirs.

'''Usefulness:''' The swimming skill is only slightly useful. This is most useful if the entrance to your fort has narrow walkways/moats surrounded by water, and you station your soldiers there. It does help gain attributes though. Though if you utilize a '''H'''ydraulic '''E'''levation and '''L'''owering '''P'''latform, this is a priceless necessity.

==Swimming track==
{{main|Swimming#Minecart_training|l1=Swimming § Minecart_training}}

[[Image:Swim track 0.png|thumb|right|250px|A large swimming track]]

A [[minecart]] ride that trains [[swimming]] safely and automatically.

'''Difficulty:''' Medium. Minecart tracks can be fiddly, and adding a non-traversable depth of water makes any mistakes more difficult to fix.

'''Usefulness:''' Medium. The swimming skill is only slightly useful, but it does provide [[cross-training]] for attribute gains.

==Tower of Death-Struction==

Have you ever wondered, "What would it take to make my [[Siege|friends]] all [[Gravity|fall]] at once into a pit of [[Trap|fun times]] while also not risking failure?" Elementary, my aspiring architect -- [[Fun|THE TOWER OF DEATH-STRUCTION]]!

Step 1: Build a tower with a [[bridge]], to allow for non-lethal access to the fortress. Build the tower roughly 25-30 blocks high, though higher towers tend to result in roughly equivalent amounts of [[Fun]]. The access bridge should be linked to a lever, to close it like a standard gate.

Step 2: Build a thinner tower 20 blocks away, for maximum bridge length. Any number of middle towers can be constructed, though one is recommended.

Step 3: Build another tower, one that can be ascended by [[Goblin|curious friends]]. Fill it with cage traps, to thin out the number of [[Troll|friends]] to take up space on the bridge.

Step 4: Build two bridges on either side of the skybridge, to trap attackers on the skybridge.

Step 5: Hook up the skybridges to one lever, and the trap bridge to another.

Once this is done, just wait for a [[Siege|surprise party]] to be thrown for you. Close the access bridge, forcing the [[Goblin|visitors]] to path onto it. Trap them, and when the time looks right...

'''Pull the lever, Kronk!'''

'''Difficulty:''' Moderate to hard. If all of your dwarves have cave adaptation, the construction might take a lot longer to complete. As well, the cost of floors and traps alone will mean that just acquiring the materials will need its own stupid dwarf trick.

'''Usefulness:''' Low to high, depending on how well you use it. If you forget to open the access gate, you might find your dwarves trapped inside the tower, or even worse, they may run up to the bridge to fight and meet a [[Gravity|bad time]]. Also, the goblin corpses piling up in the spike pit might cause extra [[Miasma|fun]] depending on how regularly you take care of it. If done correctly, this tower might become the most efficient and effective defence against all problems that one could possibly ask for.

*Bonus: Build enough middle towers to build a bridge path long enough to trap an entire siege and drop them onto spikes below.
*SuperBonus: Build the towers above a river.
*MegaDwarfBonus: Build the towers above a lava pit.
*SuperMegaDwarfBonus: Build the towers above a ticket straight to [[HFS|the circus]].
*ArmokBonus: Build the towers out of [[Slade]] (Note: This should be impossible, so if you do it...))
*HardcoreDwarvenMasterpieceArtifactBonus: Build the fortress at the top of the tower that the goblins have to try to get to.

== Traveling Circus ==
Travel across the world, building megaprojects like pyramids or bridges.

'''Difficulty''': The larger the world, the higher.

'''Usefulness''': ''None at all''.
* Bonus: travel around and actually release [[HFS|the circus]] on every embark. Needless to say, this is the most [[fun]] option. You may consider making sure the clowns get their share of fun, if you want your circus to happen more than once...

==Underground forest==
{{main|Tree farming}}
Break into an underground cavern, make some muddy floors over a big area and wait.

'''Difficulty:''' Medium - need to dig out a suitably large area, then find a way of introducing water to the area and subsequently draining or evaporating it.

'''Usefulness:''' Depends on size (bigger is better) as well as proximity to wood stockpiles. A tree farm outside the caverns can grow trees from all 3 layers, and you'll never have to worry about hostile creatures threatening your wood cutters.

==Underground perpetual motion power plant==
Combine with a use for the power and you either have an awesome setup, or a ticking time bomb.

'''Difficulty:''' High. Maintaining the correct water level is annoying difficult at times. Note: Incredibly easy with an aquifer.

'''Usefulness:''' Depends on size of plant and what it's connected to. Also useful as a puzzle for adventurers.

==Underwater statue room==
A simple room filled with statues that just also happens to be flooded. Simply dig a room near to a water source smooth and engrave the walls and floors then fill with statues. Dig a tunnel to the water source and a separate escape route. seal both off with floodgates pull the levers in the right order and bam! underwater statue room. For added effect make the meeting room a room directly above with a glass floor.

'''Difficulty:''' Low.

'''Usefulness:''' Absolutely positively none.

*Bonus: Build it on area with trees and shrubs; make walls from ice or use windows; fill it with fish and merfolk; now you'll get a big aquarium
*Note: It doesn't count if you accidentally flood your fortress and wind up with one of these. It does count if one of your nobles has an unfortunate accident in their sculpture garden.

==U.R.I.S.T. artificial intelligence==
Basically, a dwarf in a bunker that controls your fortress. Being that there are no supercomputers in DF at the moment, we'll have to use the closest substitute, a dwarf. Seal your dwarf in a room full of levers that activate various floodgates, bridges, doors, hatch covers, traps, etc. Make sure this room has no exits or entrances, but it needs a luxurious bedroom and dining area, and you must include a chute for dropping in <s>food</s> biomass and <s>alcohol</s> coolant fluid. Profile the levers so that they can only be used by the A.I. dwarf.

It would be a good idea to make the system into two rooms. The food/drink/bed room and the lever room. Should you need to add more levers, you can lock the A.I. dwarf outside the lever room and have your mechanics set up more levers without interacting with or releasing the A.I.

You can make the lodging room suited for the particular dwarf by adding furniture made from their favorite materials, and smoothing and engraving everything. Use quantum stockpiling to give them 10+ years of food and drink. Make sure the A.I. is unable to communicate with other dwarves. His/her mood must not be affected by the deaths of the walking meat-bags who tried to befriend him/her.

In order to ensure that your A.I. doesn't find sleep interfering with crucial lever pulling, you might consider incorporating an alarm clock. If a goblin siege turns up on your doorstep, a single external lever to dump 7/7 of water on the sleeping A.I. might well save your fortress (and is so much cooler than having backup levers in your meeting hall).

You must also make a snazzy/lame acronym name for your AI, here are some examples:
*A.R.M.O.K. - '''A'''ll-'''R'''eaching '''M'''achine '''O'''f '''K'''illing
*A.S.S. - '''A'''lmost-autonomous '''S'''ystems '''S'''elector
*C.A.T. - '''C'''reepy '''A'''utonomous '''T'''echnology
*D.E.E.P.E.R. - '''D'''warf of '''E'''ngineering the '''E'''ldritch and '''P'''ractical '''E'''xploitation of '''R'''esources''
*D.I.E.D. - '''D'''edicated '''I'''rrigation and '''E'''verything else '''D'''warf(s)
*D.O.M.E.S. - '''D'''warf '''O'''perated '''M'''echanics and '''E'''ngineering '''S'''ystem
*D.O.R.F. - '''D'''oes '''O'''rders '''R'''ather '''F'''ast
*D.O.S. - '''D'''warf '''O'''perating '''S'''ystem
*D.W.A.R.F. - '''D'''rains '''W'''ater '''A'''nd '''R'''ecruits '''F'''armers
*G.L.A.D.O.S. - '''G'''enetic '''L'''ifeform '''A'''nd '''D'''warf '''O'''perating '''S'''ystem
*H.A.L. - '''H'''airy '''A'''lternate '''L'''ifeform
*M.A.G.M.A. - '''M'''assively '''A'''lcoholic '''G'''ear-'''M'''achine '''A'''ssembly
*N.O.B.L.E. - '''N'''arcissistic '''O'''bnoxious '''B'''oastful '''L'''aughable '''E'''xcrement
*P.O.T.A.T.O. - '''P'''ossibly '''O'''rganic '''T'''echnically '''A'''live '''T'''rash '''O'''mitted
*U.R.I.S.T. - '''U'''nderground '''R'''easonably '''I'''ntelligent '''S'''ettlement '''T'''echnologist
*V.A.C.A.T.E.D. - '''V'''ampire '''A'''ssisted '''C'''omputerized '''A'''ssembly '''T'''errorizes '''E'''xtra-'''D'''warves
*V.O.D.A.P.H.O.N.E. - '''V'''ampire '''O'''perated '''D'''efence '''A'''pparatus, '''P'''erpetrating '''H'''arm '''O'''f '''N'''efarious '''E'''ntities (See Bonus for more information)


'''Difficulty:''' Medium. Setting up all the levers and lodgings can be a micromanagement hassle. Further research is required as to how well the A.I. will fit into a dwarven economy.

'''Usefulness:''' High. Having a dwarf dedicated to pulling levers will ensure that they are pulled on time. Additionally, you will have a constantly-ecstatic dwarf who is virtually invulnerable to all threats. Should your fortress be slaughtered by invaders or drowned by flooding or tantrum spiraled, your fortress will be preserved until more migrants arrive, or the AI runs out of food.

Bonus: Make the A.I. dwarf a vampire. Vampires don't need food, alcohol, or sleep and cannot age, which makes them perfect for the job. As an added bonus, keeping a vampire in this way will make your fortress completely indestructible, as sealing him in will prevent the possibility of the vampire of being killed in combat or from a syndrome, while keeping the vampire from making friends he will inevitably outlive will prevent him from going insane. (It also ensures that the bloodsucker won't use any of your dwarves as a midnight snack.) NOTE: Vampires may still go insane without any blood. Might be worth considering adding on a 3rd "feeding chamber" where you assign an unfortunate victim to sleep whenever the vampire gets hungry.

===D.O.S.T.N.G.O.S.P.===

Dwarven Organic Switch Toggle, Neutered Gastrectomied Overpersistent Sober Prisoner. Goblins have several advantages over dwarves in the lever pulling department: they live forever, do not breed or tantrum, and need not eat, drink, or sleep. Seal one or more goblins in your supercomputer complex, and use their predictable pathing in combination with instantly lockable doors and pressure plates to make dwarven lever pulling a thing of an older, less advanced era.

Also known by several product names:
*G.O.B.L.I.N.A.T.O.R. - '''G'''oblin '''O'''perated '''B'''astion of '''L'''ogic to '''I'''nfalliably '''N'''eutralize '''A'''ntiquated '''T'''ypes of '''O'''perational '''R'''egimes
*N.G.O.K.A.N.G. - '''N'''efarious '''G'''oblin '''O'''f '''K'''illing '''A'''nd '''N'''eedless '''G'''riping
*S.T.O.Z.U. - '''S'''ecret '''T'''echnological '''O'''perative who '''Z'''aps '''U'''nruly Nobles

'''Difficulty:''' Medium. While goblin pressure plate runners require more space than dwarven lever pullers, once their room is set up, it's done, and easily copied for the next one. With only one goblin, you'll need a pressure plate for every possible combination of lever states, but it's easy to add more goblins instead.

'''Usefulness:''' High. Instant response time (<50 ticks is possible) can make lever worries a thing of the past. The D.O.S.T.N.G.O.S.P. requires absolutely no maintenance once set up. Unlike with the U.R.I.S.Ts of the previous generation, modern POW-based computing is never held hostage to eating, drinking, or breaks. Stay tuned for the next-generation C.A.C.A.M.E.!

==Vomitorium==
[[Image:Vomit_Trail.png‎|thumb|right|Vomitoria: preventing cave adaptation since [[23a:Vomit|23a]].]]

Prevents [[cave adaptation]]. It's like the greenhouse, only instead of a farm, it's a [[meeting hall]] or [[barracks]]. Since you can't build [[table]]s or [[bed]]s outside, build the room and [[channel]] down to it. Variant: above-ground statue garden or zoo.

'''Difficulty:''' Low.

'''Usefulness:''' Low. Make sure to wall the pit in, or it will become very [[fun]] once [[goblin]] archers become involved.

Bonus: Make an ACTUAL Vomitorium for this - Build a [[meeting hall]] with a [[grate]]d floor. Let [[cave adaptation]] set in, then open the place up for the most extravagant and lavish of parties every 3~4 years! Those will be some Armok grade hangovers though....

==Water tower==
This functions much like real life: Lifting water above ground level creates pressure, allowing buried pipes to deliver water to any elevation below the top of the tower. This is smarter, faster, and cheaper than a map-spanning raised aqueduct. A pump stack at the river, raising water into a sealed, pressurized U-bend, can deliver large volumes of water to whatever level you want, very quickly.

'''Difficulty:''' Medium. No harder than any other pump stack to design, but high pressure can amplify minor errors into abandon-worthy disasters. You could conceivably divert the river into your fort. Be sure to make an off-switch.

'''Usefulness:''' Medium. Once the pump stack is operating, you no longer need to be anywhere near your water source.

==Watervator==
By creating a vertical "'''H'''ydraulic '''E'''levation and '''L'''owering '''P'''latform" chamber, or HELP (so named for the cries of the passenger dwarf) with lever controlled water levels, you can move a dwarf up several z-levels without any stairs. All it takes is the dwarf's ability to swim up to the surface of the water to breathe.

'''Difficulty:''' Medium. Moderate possibility of Fun by way of flooding your fortress. Any dwarves that can't swim will instead experience Fun when using the Watervator. The actual construction time and resource usage is very low. Using the Watervator often leads to unhappy thoughts about drowning

'''Usefulness:''' Low to Medium. The Watervator requires manual micromanaging, while stairs do not. On the other hand, it can be used to create a pathway that most <s>Dwarves</s> enemies will simply be unable to use. Those that can would still be doing so at great risk of drowning or falling to their death. It is recommend that with the exception of the entrance you use stairs.

*Bonus: Utilize vampires (who can't drown).
*MegaDwarfBonus: Utilize trained fish.
*MegaDwarfBonus: Engineer it so that it performs a full cycle on one activation of a pressure plate and include that pressure plate as a part of the patrol route, then create a reverse Watervator and also include it as a part of same patrol route, so that your militia automatically uses it to get in and out the fortress.

==Werewolf clock==
The changing of the werewolf is the most reliable indicator of the passing of seasons. For precisely one day per full moon, he will go berserk and trigger standard pressure plates.

'''Difficulty:''' You will get a were sooner or later. Getting him pitted in the right spot without havoc is the hard part.

'''Usefulness:''' Low/None. As of Premium, the lunar phase is permanently affixed to the user interface, making a werewolf clock frankly redundant.

*Bonus: Make the werewolf do most of the work himself.

==Zombie thunderdome==
Embark in a [[surroundings#Evil|reanimating]] biome in the current version (preferably savage as well), find or dig a deep pit, and dump any unused (non-dorf) corpses and butchery products into it. They will animate and begin to walk around, providing you with the endless entertainment afforded by watching horse hair walk. Make sure the pit is deep enough not to scare your dwarves!

'''Difficulty:''' Low.

'''Usefulness:''' Medium. Keeping your fort safe from the threat of animated beak dog beaks is worth any price. However, [[Defense guide|there may be better things]] [[Mega construction|to do with your time]].

*Bonus: Set up a series of [[bridge|defenses]] that drop invaders into the pit.
*DwarfBonus: Set up a series of bridges and walls that flings invaders into the pit.
*MegaDwarfBonus: Drop a Megabeast into the pit and watch it do battle with multiple layers of undead.
*CavernFunBonus: Channel the bottom into a cavern and let your zombies hunt [[forgotten beast|the wonderful creatures there]].
**BonusFunBonus: Let them hunt [[Demon|Clowns]] as well.
*ZombieDwarfBonus: Ignore the suggestion above and dump dwarven corpses in anyway.

==Zombie shooting gallery==

In a reanimating biome, build a holding room for your undead, wall it off with fortifications. In the adjacent (accessible) area, build an archery range and order your archery squads to train there. Your marksdwarves will go to their scheduled archery training and whenever a zombie is raised, they'll switch focus from the boring old archery target and instead shoot down the undead. Once the zombies are dead, they'll return to regular shooting practice until the corpses rise again. The raised corpses cannot attack through fortifications and thus cause no unhappy thoughts from seeing them, but will spook haulers trying to collect errant socks from the shooting range.

A viable (if finicky) alternative to a reanimating biome could be a [[necromancer]]. This has the benefit of being more controllable, but comes with the threat of [[intelligent undead]] and their abilities. Most would be relatively harmless or a minor inconvenience, but some are potentially lethal to your dwarves. Whether or not this is a downside depends on how many corpses you have available to restock the gallery.

'''Difficulty:''' Low. The difficulty lies in finding a source of permanent undead, the actual construction is trivial.

'''Usefulness:''' Medium. This setup significantly increases the skill gain from bolts used by training dwarves, since every bolt shot at a zombie counts as combat action, giving much more experience. The scheme works without any supervision once set up.

{{Category|Design}}
[[ru:Stupid dwarf trick]]

Ambush

2026-04-25T04:07:17Z

Quietust: Undo revision 315848 by 121.121.177.59 (talk) - you didn't actually fix it - the problem was the "s" at the end

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

[[File:ambush_olm_preview.png|thumb|238px|right|An ambush with [[Cave fish man|cave fish men]] in a cavern.]]
An '''ambush''' is a type of attack in [[fortress mode]] where a small force of enemy {{Catlink|humanoids}} attempts a sneak attack on your [[fortress]]. Smaller in scope than a full [[siege]], ambushes are not related to the number of [[dwarf|dwarves]] in your fortress. Enemies arrive in one or more separate "squads" of maybe 6-10 individuals that (try to) work and move as a team, similar to a dwarf military [[squad]].

Unlike [[siege]]s, ambushes are not [[announcement|announced]] immediately, and the attacking units are only revealed when your fortress becomes aware of the attackers in a way that does trigger an announcement, either when they set off a [[cage trap]] or come sufficiently close to a dwarf, [[caravan]] member, or [[pet]] (they ignore non-hostile wildlife). Ambushes can also be discovered manually if the player happens upon on an invader [[corpse]] and some [[goblinite]] in one of your weapon [[trap]]s (which do not cause announcements when they are triggered). Once an ambush squad is detected visually by a dwarf or pet, an ambush will generate a [[Announcement#Major announcement|major announcement]], the wording of which depends on the invader. There may be more than one enemy squad on the map, and each must be detected separately.

Ambushes, just like [[siege]]s, nearly always happen at the beginning of a season, generally in the first 15 days of the first month, often arriving with [[caravan]]s, but can happen at any time. Note that elves will usually ambush with more than one squad (up to 50+), each of which has to be detected separately and triggers a separate announcement. If ambushers are caught in cage traps, they will be marked as Caged Prisoner in the unit screen. These prisoners can be dragged around between cages (or tossed over tall towers), although there may be a risk of jailbreak. If you abandon your fortress while an ambush is active, you will receive the message "Your strength has been broken." Finally, when the leader of an ambush is killed (or captured), but not the other units, they will stand around and "wait" for their leader; this is probably a [[bug]].

== Types of ambushes ==
=== Elves ===
{{dftext|An ambush! Curse all friends of nature!|4:1}}

[[Elven]] ambushes may occur if your [[civilization]] is at war with a neighboring elven civilization. These ambushes have the same structure as the elven sieges, where their numbers and the nature of an ambush may very well catch an unprepared fortress off-guard. They might also bring exotic beasts as they may do during sieges, as well as [[animal people]] that can fight alongside the elves.

As soon as an ambush is detected, a group of a dozen elves will appear at the map. Be aware that an ambush does not only have one wave of enemies, but detection of several scores of elves is highly possible. But as with elven sieges, the elves themselves are very poorly equipped and carry only [[wood]]en armor and weaponry. [[Clothing]] is also known to be dropped by slain <s>hippies</s> elves.

=== Kobolds ===
{{dftext|An ambush! Skulking vermin!|4:1}}

[[Kobold]] ambushes are triggered by a long enough string of successful kobold thievery. This usually only happens when kobold thieves manage to steal from an outdoor cache of some sort that your dwarves cannot access for some reason, possibly fallen [[goblinite]] from or during an ongoing siege. Kobold ambushes are mostly notable for being much more annoying than kobold thieves, and should not be allowed to occur.

It should be noted that the first ambushes from kobolds are full of recruits who have never seen a dwarf in their life, and will almost always scatter and run away instead of fighting.

=== Necromancers ===
{{dftext|An ambush! Drive them out!|4:1}}

[[Necromancer]]s will also occasionally ambush your fortress, if you are in range of their [[Tower (necromancy)|tower]] and they opt out of a full-on [[siege]]. Necromancer ambushes consist of several necromancers, each one being detected individually; an early warning sign for a necromancer ambush is the presence of [[undead]] in non-evil [[biome|biomes]]. The necromancers themselves are harmless, being regular old unarmed humanoids; however, very bad things will happen if they manage to find their way within sight of any left-over goblin sieges, [[corpse]] or [[refuse]] [[stockpile]]s, or (Armok forbid) last month's [[dragon]] invader. For this reason it is highly recommended that fortresses within sounding range of a tower internalize or [[atom smasher|atom smash]] all of their meat byproducts, and set [[standing orders]] to "gather refuse from outside" and clean up any meaty outdoor bits.

=== Cavern Dwellers ===
{{dftext|Cavern dwellers! Send them back to the darkness!|4:1}}
[[File:Olm_People_Invaders.png|thumb|right|125px|They just keep coming!]]
[[File:Don't be next Bomrek.png|200px|thumb|left|Urist didn't make it out. Don't be next, Bomrek.]]

Upon breaching the [[caverns]], your fortress may occasionally be attacked by a large swarm of underground [[animal people]], such as [[Olm man|olm men]]. As with most ambushes, they often remain hidden until they get close enough to attack, but unlike other ambushes, their numbers can be well into the dozens or more, resulting in alert and notification spam as a new wave of them is discovered, so while these appear to use the mechanics of an ambush, they are somewhere between an ambush and a siege.

Cavern dwellers are typically armed with [[shields]] and [[spears]] made of random military-grade metals, up to and including [[steel]], but no [[armor]]. As such, they are easily dispatched by well-equipped dwarven veterans, but their numbers can quickly overwhelm even your mightiest warriors if one of them is caught alone during a patrol. They can be especially deadly versus your civilians, as well as any inexperienced fighters or [[monster slayer]]s.

They may also bring pets or mounts, at the worst gigantic war [[jabberer|jabberers]] or [[rutherer|rutherers]], which can pose their own set of problems, as either of those is too large to be crushed by a bridge.

They may attempt to relocate to a safer location in the caverns if they begin to lose, but they sometimes don't fully leave the map - amphibians may dive underwater and lie in wait to lick their wounds, which can have [[Fun]] consequences if your ☼Steel-clad☼ dwarves dive in chasing a kill, only to drown when they can't get back out, leaving all of their equipment at the bottom of an infinitely-replenishing lake, potentially forever lost. If this becomes a problem, creating a [[swimming pool]] or other means of teaching your dwarves to swim en masse should become a priority, as should engraved [[slabs]] to prevent [[ghosts]].

As caverns are always "indoors," massive clouds of [[miasma]] from the rotting corpses can also quickly become an issue for anyone doing work down there, as there are typically far too many to dispose of in a timely fashion.

=== Other ===
[[Quester]]s seeking an artifact may attempt to sneak in and steal their target from your fortress. If discovered, they may run away or attack, depending on their temperament.

[[Werebeast]]s from the wilds may also attempt to ambush your fortress during a full moon. If discovered, they trigger a message similar to the one that is shown when a Megabeast attacks ("The Were(creature) (name) has come! ... Now you will know why you fear the night."). At the conclusion of the full moon, they return to their normal form and attempt to leave the site. If discovered in this state, they will still be announced as above, but with the details of their current form ("The Human (name) has come! A medium size creature prone to great ambition.")

== Notes ==

* Hidden ambushers do not display combat reports, but their combat actions may be included in other units' combat reports.
* Upon discovery of an unconscious or otherwise incapacitated ambusher, the game will announce "There is a (creature) hidden away here." instead of the usual ambush announcement.{{cite forum|35009/581009}}
* Hidden ambushers are revealed upon death, without any announcement.

== Adventure Mode ==

Ambushes also occur from Fast Travel in [[Adventurer mode]]. When traveling, [[Army|armies]] and other traveling figures are shown as shields/asterisks, and if hostile, then approaching the region tile they occupy will trigger an ambush. Depending on the savagery of the land, you may also be randomly ambushed by the dominant predator(s) of the biome. Traveling alone at night in certain [[evil]] biomes may result in a [[bogeyman]] ambush.

When ambushed, the fast travel map will close and you will appear on the local map with your ambusher(s). If they're in view, they will be identified in a major announcement, but if obscured by terrain, distance, or lighting, then the announcement will inform you "You feel uneasy." As long as your ambushers can detect you or a party member, you will be unable to fast travel, as "You don't feel safe enough to travel."

Typical ambushes come from roving large predators (including [[giant]]s, giant [[Undead|zombies]], [[night troll]]s, etc) and [[Army|patrols]] from a hostile settlement nearby (such as from enemy civs or [[Bandit|raider]] [[camp]]s.) Muggers harassing towns also trigger ambushes; though they don't appear hostile at first, they intend to commit crimes against persons and property, including yours. And angered settlements or raider groups may take revenge by sending assassins who will strike even in the safe confines of a city.

If you're unprepared for the ambush, you can evade it successfully by escaping your pursuer's view, using terrain, speed, and stealth, until you're able to fast travel safely. This is easiest against random predators who can't detect you at the time of ambush. When evading [[historical figure]]s, fast traveling to another region tile adjacent to it will trigger another ambush, so you must get sufficient distance from them in order to successfully elude them.

== See also ==
* [[Security design]]
* [[Siege]]
* [[Wealth]]

{{Military}}
{{category|Fortress mode}}
[[ru:Ambush]]

Goblin

2026-04-22T00:46:32Z

Quietust: Reverted edits by 71.204.37.122 (talk) to last revision by Cali

{{Quality|Exceptional}}

{{Creaturelookup/0
|image=Goblin_sprite.png
|portrait=goblin_portrait_anim.gif
|wiki=yes
}}
{{av}}
{{creaturedesc}}

[[File:Goblin riding beak dog crayon.jpg|thumb|200px|A goblin riding a beak dog, drawn in crayon by [[Main:Bay 12 Games|Bay 12 Games]].]]

'''Goblins''' are intelligent, evil, aggressive humanoid [[creature]]s that live in [[dark pit]]s, and are the main opponent in [[fortress mode]]. They often establish settlements in [[dark fortress]]es within regions touched by evil, though it may be hard for some to imagine that goblins are capable of building those obsidian monoliths. They quickly become a threat to the great majority of fortresses - except some [[island]] or [[mountain]] forts.

Goblins will start harassing a fortress early in its life, first with [[Thief#Goblin snatchers|babysnatchers]], and later with [[siege]]s. Goblin babysnatchers carry a bag for their purpose. Their soldiers are commonly armored with [[copper]] and [[iron]] [[armor]], and armed with copper, iron and [[silver]] [[weapon]]s, generally with no quality levels unless on weaponmasters, and also typically accompanied by other creatures, such as other humanoids they have successfully kidnapped, [[troll]]s and [[beak dog]] [[mount]]s. Their items can be a valuable source of metals for fortresses that embarked in metal-scarce areas (leading some players to refer to the plunder from a defeated goblin attack as [[goblinite]]). Defeating a majority of an attacking force usually sends the rest of them running.

Goblins are [[Immortality|immortal]] beings, dying only to violence and disease. For [[Demon|spoiler]] reasons, they never need to eat or drink, despite being carnivorous. Graphically, goblins can appear with different shades of green skin.

Goblins speak the [[goblin language]].

Some <s>traitors</s> [[dwarves]] [[Preferences|''like'']] goblins for their ''terrifying features''.

==Ethics and values==
{{Minorspoiler}}
Goblins show the least concern for [[ethics]] out of any race in the game, with the sole exception being that treason is punishable by death (which currently has no effect on successful attempts to bump off a leader). It appears that goblins do not enforce punishment, but instead simply ignore crimes and leave any punishment to be determined by the parties involved. It is because of their acceptance of controversial acts that goblins become enemies with nearly every other race. For example, goblins find the torture of animals, the butchering and consuming of sapient beings, oath-breaking, and general malice acceptable or consider it a personal matter.

Goblin civilizations are created when a particularly powerful [[demon]] escapes the [[Underworld]]. Such demons remain in charge until they're killed or otherwise defeated, in which case normal goblins will take their place. This could imply the reason behind their particular (lack of) ethics. Goblin civilizations in fact require these demons to appear in worldgen - should you use [[advanced world generation]] to forbid demons in your world, the goblins will be locked away in the Underworld in their place, and will remain there until they are freed by a civilization digging too deep and too greedily.

Goblins consider power to be of the utmost importance, also valuing cunning, independence and martial prowess. Goblin society dislikes peace, perseverance, hard work, tranquillity, cooperation, tradition, decorum and friendship, while not valuing loyalty, introspection, eloquence, harmony or nature at all. Goblins abhor law, truth, self-control, fairness and sacrifice. All of this means that individual goblins tend to be cruel, hateful, easily angered and immodest, while having a low capacity for altruism and being swayed by emotional appeals. Despite their evil nature, however, they tend to be very tolerant creatures, and indeed, babies taken by goblin-snatchers are raised into fully-fledged citizens who are given the same rights and treatments as the goblins themselves, suffering from no particular kind of prejudice.

==Behavior==
While aggressive, goblins are notably cowardly. Although they're brutal and sadistic, they will not hold the line against a superior force and are more than willing to sacrifice their wounded comrades in a badly organized retreat. Their strength generally comes from pure numbers, as they're usually weaker than a dwarf one-on-one (a notable exception is their weapon lords and masters, who can be VERY talented in warfare.)

==Community outlook==
[[File:goblin_preview.jpg|thumb|160px|left|Green and heartless.]]
Out of the non-player races, the goblins are the ones the player interacts with the most, given the fact they're the ones that are always hostile and eager to attack you. Compared to [[Elf|elves]], goblins can actually be a threat to a fortress, and an unprepared player can easily lose all their dwarves by being overwhelmed by the greenskin tide. However, their tendency to run off when outmatched as well as a general feeling of dwarven superiority has led to the goblins gaining a reputation of being cowardly little bastards who rely on sheer numbers to match the might of a dwarven warrior. As the main enemies of the dwarves, goblins make for perfect target-practice in [[fun]] projects.

The community plays most of their evil acts for laughs (such as implying baby-snatchers are trying to ''save'' dwarven children from their [[Stupid dwarf trick|unhinged]] parents), and generally treats them as being equivalent to ineffectual cartoon villains who can't ''quite'' get anything done properly. A goblin will generally be treated more favorably than an elf, though; despite goblins wanting dwarves dead out of pure malice, the antipathy the community has with the elves comes from their awful, stuck-up attitude, which goblins actually lack entirely. They're evil, but they don't pretend to be good.

{{D for Dwarf}}
Despite their bloodthirsty, selfish, unsympathetic and cruel nature, goblins are also recognized as a benevolent and merciful race in some aspects. Goblin Baby-Snatchers claim moral superiority by rescuing innocent lives from the slavery of making [[finished goods|rock trumpets]] until they are eaten by a [[giant cave spider]]. Atrocities such as the so-called [http://www.bay12forums.com/smf/index.php?topic=91093.0 dwarven day care] institution also spur snatchers to rescue the children from constant abuse. Goblin [[siege]]s are considered to be a form of mass mercy-killings, as a fort can die in the most horrific of ways, such as [[tantrum spiral|social disagreement]]s, an infestation of [[Cat|parasitic organisms]] (some [[Noble|masquerading as dwarve]]s) or worst of all: a visit from the [[Underworld|circus]]. And goblins who are friendly towards dwarves have been observed after de-transforming from a werebeast.

In addition, dwarven science[Citation needed] has proven that the violence between goblins and dwarves does, in fact, start on a purely instinctual level. Leaving a goblin and dwarven child locked in a room together will result in them kicking, punching, and biting each other to death the moment they notice each other. Whether this natural animosity stems from uncounted centuries of war, or opposing viewpoints on the treatment of children has yet to be determined.

Despite being mortal enemies of the dwarves, goblins are still infinitely better than the despicable [[Elf|tree-hugging hippies]].

== Playing as goblins ==

Goblins are normally not playable in [[adventurer mode]], as the player isn't able to make adventurers from their civilizations. However, you may be able to play as one if populations of goblins have been absorbed into dwarven, human or elven civilizations during worldgen, though as noted, they will not actually ''belong'' to the actual goblin civilizations, meaning your goblin and the others will be hostile to one another. "Goblin" settlements will sometimes be completely goblin-free, having been displaced by the descendants of enslaved children that were captured in ages past. In this respect, whilst they're a goblin ''[[faction]]'', they're populated purely by unfortunate prisoners and other brainwashed humanoids.

By [[modding]], however, goblins can also be played in fortress mode as well. As mentioned above, goblins can also appear as visitors (and then become normal citizens) of a fortress without needing any change to the game.

== See also ==
* [[Siege]]

{{gamedata}}
{{gamedata|title=Entity ([[civilization]]) Raws|{{raw|v50:entity_default.txt|ENTITY|EVIL}}}}
{{Creatures}}
{{Category|Races}}
{{Category|Humanoids}}

Cacame Awemedinade

2026-04-22T00:46:26Z

Quietust: Reverted edits by 71.204.37.122 (talk) to last revision by Cali

{{D for Dwarf}}
{{Translation
| english = Pelt Apebalded, the Immortal Onslaught
| dwarven = Rodem Izegroder Kudarmothdast
| goblin = Uxo Ozsebor Ostsnotutu
| human = Therset Tunemrostfen Athrigencesh
}}
[[File:Cacame Fault elfking.jpg|200px|thumb|right|"The Glorious Elf King" by Fault]]
The [[Elf]] King of the [[Dwarves]], '''Cacame Awemedinade Monípalóthi''' ([[wikipedia:english|English]]: ''Cacame Apebalded, the Immortal Onslaught'') is the world's <s>most</s> only badass elf.

In one particular slice of the Dwarf Fortress multiverse (generated by Holy Mittens), Cacame ascended to the rank of Elf King of the Dwarves. The story of his rise to glory has been chronicled in an [http://www.bay12forums.com/smf/index.php?topic=39897.0 epic 70+ page thread] on the Bay 12 Games forum that includes original artwork, economic discussions, raw edits, world gen randomness, Chuck Norris jokes, Battletech references, and a Cacame-themed [[Mega construction|megaproject]].

==Brief history==

[[File:Cacame-sarasti.jpg|300px|thumb|right|Artist's rendering of Cacame by Mechlin ([http://www.bay12forums.com/smf/index.php?topic=169691.msg7701761#msg7701761 post])]]

===Relatives===
Cacame Awemedinade was born in 83 from Fewetha Spokenthundered (a warrior with five kills) and Osime (an adventurer), both of whom were eventually killed and eaten by Gibberlings (modded grotesque creatures that exist to kill, eat, and reproduce) on separate occasions; his maternal great-grandfather had been a King of the Field of Kindling, notorious for killing a megabeast and fighting another one. This both makes him of royal blood even before ascending to the position of King of the Dwarves, and determines his ancestry as worthy warriors.

As for the rest of Cacame's family, they are all living unimportant lives. Most tragically, they are still living in the elf civilization.

===Early life and rise to Sovereignty===
[[File:Cacame history.jpg|400px|thumb|center|Cacame's early history (by Fault)]]
[[File:Vester Cacame.png|200px|thumb|left|RIIIIDE CACAME RIIIIIDE! (by Vester)]]
The Creation of Ferns dwarven civilization and Cacame's former Field of Kindling elven civilization were at war for many years, with the dwarves systematically defeating the elves for decades. In 90, the dwarves conquered his home city of Oily Typhoon and placed a new dwarven governor in charge. Cacame was 7 at the time, and 5 years later, at the ripe old age of 12, he became a [[Guard]].
Two years later, an elven attack from the Field of Kindling's city of Fish of Magic injured him in the lower body and killed his wife Nemo Ruyavaiyici (who was then eaten by Amoya Themarifa, the elf who killed her). Maddened with grief, Cacame set off to the nearest front as soon as he healed enough to fight.

During his first combat he took up his fallen commander's legendary warhammer[name?] and slew many elves with it, being noted as [[Cacame_Awemedinade#Cacame_joins_the_Army|the battle's fiercest and deadliest warrior]]; for his deeds, the dwarves' second-in-command acknowledged that Cacame would best put the warhammer to use and should keep it.

Two years after that, in 99, the Battle of Both Kings was fought. In this battle Cacame struck down King Nithe of Field of Kindling (who was finished off by another dwarf called Sibrek Handpages, though); however the other king slain was the dwarven king himself. The dwarves decided that Cacame, by now dubbed "The Immortal Onslaught", should take over as their king.

Once made King, Cacame left in a brief quest to resurrect his wife. He returned riding a [[zombie]] wyvern, but without achieving his goal.
In 111, at the age of 28, he moved his capital to the Gamildodók (Trustclasps) Fortress.

===Colossus of Cacame===
[[File:Cacame colossus.jpg|200px|thumb|right|Colossus of Cacame (by Holy Mittens)]]Due to a courtier's inadvertent slight to his zombie wyvern, King Cacame would go on to defeat a red [[dragon]] called Sokröx Glimmerfair (the Duty of Coloring) with [[Cacame_Awemedinade#King_Cacame_vs._The_Dragon|nothing more than Competent Hammer skill]]. This deed inspired the admiring dwarves to build a [[megaproject|monument]] to their king, the [[Cacame_Awemedinade#King_Cacame_and_the_Colossus|Colossus of Cacame]]. It is told by the bards that there was a large [[goblin]] attack during the inauguration party, and that King Cacame himself stood alone before the Colossus and glared at the goblins until they panicked and routed. Some naysayers[Who?], however, claim that a battle was actually fought and won before King Cacame's arrival.

''His cape is made of solid [[gold]]. It took 949 bars of gold to forge. The vast majority of that gold was home-smelted. The head of his hammer is made of mithril with an [[iron]] band around it, spike at the top, and handle. That's 132 bars of mithril and 37 bars of iron.''

''His armor and helmet are made of [[obsidian]]. I'm not even going to attempt to calculate or count how many stones it took. It was a lot of them. The horns on his helmet are [[cinnabar]]. His flesh is forged of [[platinum]]. 33 bars in total. His eyes are [[clear glass]] [[blocks]]. Behind his eyes are pools of [[magma]] that were pumped from the pipe a fair distance away. Sadly, Visual Fortress doesn't display this as two huge glowing orbs of elf-hating malice.
The construction took the lives of five workers, who were properly honored and entombed.''

===Questing for revenge===
[[File:Cacame_vs_Engnun.png|200px|thumb|left|Cacame vs. Egngun (by Vester)]]In time, King Cacame's Royal Guard expanded to other races, coming to include like-minded elves and even a couple of awe-thralled goblins, all fanatically loyal and immensely skilled.
Hearing of King Cacame's might and the splendor of his kingdom, the Elven King Iwo Lolamaficemi (Barricaded Sever of Flaying), who fought against and ate Amoya Themarifa, found that it would be advantageous to make a [[Cacame_Awemedinade#King_Cacame_and_the_State_Visit|State Visit]] to Gamildodók. This (predictably) turned out to be a mistake, and he left in a hurry with his entourage after a very brief private meeting. While the precise words exchanged are unknown, it isn't hard to guess what happened.

The elven king's visit had, however, the effect of stirring the desire to take direct revenge on his wife's killer, and drove Cacame to leave the fortress incognito. While the king returned more bitter than ever (if that's even possible) and never spoke about what happened, some inquisitive bards managed to [[Cacame_Awemedinade#King_Cacame.27s_quest|find clues to his doings elsewhere]].

===Dissatisfaction and Ennui===
[[File:Cacame by Fault.jpg|200px|thumb|right|Cacame merrymaking (by Fault)]]Having his deepest desires denied, Cacame started to fall into an apathy-driven lassitude. However, when the [[humans]] decided to besiege his fortress, he recovered some of his spirit, lowered the drawbridge and waited them out alone between the legs of his Colossus [[Cacame_Awemedinade#King_Cacame_merrymaking_with_the_Human_besiegers|to greet and entertain them]].

On this occasion, he taught them to play hammer tag, dodgearrow, head cricket, foegolf, and other contact sports; he also showed them a few parlor tricks such as "punt away the horse from under its rider". To his great chagrin, the surviving humans quickly decided the party was running late and retired...

After that, he started leaving in short [[Cacame_Awemedinade#King_Cacame_relieving_stress|stress-relieving incognito trips]], and appeared to have regained his old fire.

=== Goblin reaction ===
[[File:Fault Cacame watercolor.png|200px|thumb|left|Watercolor by Fault]] [[File:Badasselfkingofdwarves.jpg|200px|thumb|right|Pencil by Lord Dakoth]] 
'''Goblin1:''' ''Man, I heard about these Dwarves. They have an ''Elf'', for their King!'' 
'''Goblin2:''' ''You kidding me?'' 
'''Goblin1:''' ''I am totally serious, this Elf is so badass the Dwarves accept him as their King!'' 
'''Goblin2:''' ''Forget that, lets go raid the Orcs.'' 
'''Goblin1:''' ''Probably be safer.'' 

==Add him to your game!==

===Engraving and decorations===

'''Shima''': ''Add this to descriptor_shape_standard.txt in the raws, and he will show up in other worlds. He might also appear in the likes of Dwarves, possibly ... will appear in engravings and decorations for all races, that much I can tell you for sure. There may be some odd syntax "Engraving of an ale-chugging Elf King etcetc" and such, but that's the nature. Rarely, in a Dwarf's likes, it might show "Elf King Cacame Lastnamey" as a like as well.''

<pre>
[SHAPE:ELFKING]
[NAME:Elf King Cacame Awemedinade:Elf King Cacame Awemedinade]
[ADJ:awe-inspiring]
[ADJ:grand]
[ADJ:marvelous]
[ADJ:kickass]
[ADJ:Elf-hating]
[ADJ:ale-chugging]
[ADJ:great]
[ADJ:excellent]
[ADJ:fantastic]
[ADJ:majestic]
[ADJ:extraordinary]
[ADJ:tall]
[ADJ:magma-loving]
[ADJ:hammering]
[ADJ:fighting]
[ADJ:warring]
[ADJ:zombie wyvern-riding]
[ADJ:dragon-slaying]
[ADJ:hardballing]
[ADJ:demon-slaying]
[ADJ:siege-breaking]
[ADJ:adventuring]
[TILE:69]
</pre>

===Awemedinite===
'''Shima:''' ''I bring you... Awemedinite!''

====Version 0.31 and later====
''(Update for version 0.40.24 by Ruludos)''

This goes into <tt>raw\objects\inorganic_metal.txt</tt>:
<pre>
[INORGANIC:AWEMEDINITE]
[USE_MATERIAL_TEMPLATE:METAL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:awemedinite]
[STATE_NAME_ADJ:LIQUID:molten awemedinite]
[STATE_NAME_ADJ:GAS:boiling awemedinite]
[DISPLAY_COLOR:5:0:0]
[BUILD_COLOR:5:5:0]
[MATERIAL_VALUE:1000]
[SPEC_HEAT:7500]
[MELTING_POINT:50000]
[BOILING_POINT:75000]
[ITEMS_WEAPON][ITEMS_WEAPON_RANGED][ITEMS_AMMO][ITEMS_DIGGER][ITEMS_ARMOR][ITEMS_HARD][ITEMS_METAL][ITEMS_BARRED][ITEMS_SCALED]
[SOLID_DENSITY:8500]
[LIQUID_DENSITY:8500]
[MOLAR_MASS:60000]
[IMPACT_YIELD:700000]
[IMPACT_FRACTURE:1500000]
[IMPACT_STRAIN_AT_YIELD:500]
[COMPRESSIVE_YIELD:800000]
[COMPRESSIVE_FRACTURE:1500000]
[COMPRESSIVE_STRAIN_AT_YIELD:450]
[TENSILE_YIELD:180000]
[TENSILE_FRACTURE:500000]
[TENSILE_STRAIN_AT_YIELD:100]
[TORSION_YIELD:200000]
[TORSION_FRACTURE:500000]
[TORSION_STRAIN_AT_YIELD:400]
[SHEAR_YIELD:300000]
[SHEAR_FRACTURE:600000]
[SHEAR_STRAIN_AT_YIELD:220]
[BENDING_YIELD:800000]
[BENDING_FRACTURE:800000]
[BENDING_STRAIN_AT_YIELD:150]
[MAX_EDGE:1000000]
[STATE_COLOR:ALL_SOLID:PURPLE]
</pre>

And this goes into <tt>raw\objects\reaction_smelter.txt</tt>:
<pre>
[REACTION:AWEMEDINITE]
[NAME:craft Awemedinite bars]
[BUILDING:SMELTER:NONE]
[REAGENT:A:2250:BAR:NONE:INORGANIC:IRON]
[REAGENT:B:1500:BAR:NONE:INORGANIC:STEEL]
[REAGENT:C:750:BAR:NONE:INORGANIC:GOLD]
[REAGENT:D:750:BAR:NONE:INORGANIC:SILVER]
[REAGENT:E:50:BOULDER:NONE:INORGANIC:MICROCLINE]
[REAGENT:F:450:BAR:NONE:INORGANIC:ADAMANTINE]
[PRODUCT:100:6:BAR:NONE:INORGANIC:AWEMEDINITE][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:SMELT]
</pre>

====Version 0.28.181.40d====
This goes into <tt>raw\objects\matgloss_metal.txt</tt>:
<pre>
[MATGLOSS_METAL:AWEMEDINITE]
[NAME:Awemedinite]
[ADJ:Awesome]
[COLOR:5:5:0]
[VALUE:1000]
[SPEC_HEAT:7500]
[MELTING_POINT:50000]
[BOILING_POINT:60000]
[WEAPON]
[WEAPON_RANGED]
[ARMOR]
[DAMAGE_PERC:800]
[BLOCK_PERC:800]
[SOLID_DENSITY:200]
[DEEP]
</pre>

And this goes into <tt>raw\objects\reaction_standard.txt<tt>:
<pre>
[REACTION:AWEMEDINITE]
[NAME:make Awemedinite bars]
[SMELTER]
[REAGENT:15:BAR:NO_SUBTYPE:METAL:IRON]
[REAGENT:10:BAR:NO_SUBTYPE:METAL:STEEL]
[REAGENT:5:BAR:NO_SUBTYPE:METAL:GOLD]
[REAGENT:5:BAR:NO_SUBTYPE:METAL:SILVER]
[REAGENT:50:STONE:NO_SUBTYPE:STONE:MICROCLINE]
[REAGENT:3:BAR:NO_SUBTYPE:METAL:ADAMANTINE]
[PRODUCT:100:6:BAR:NO_SUBTYPE:METAL:AWEMEDINITE]
[FUEL]
</pre>

==External links==

* [http://www.bay12forums.com/smf/index.php?topic=39897.0 Epic DF forum topic]
===Cacame joins the Army===
* [http://www.bay12forums.com/smf/index.php?topic=39897.msg798038#msg798038 Scribe's account on how Cacame earned his warhammer]
===King Cacame vs. The Dragon===
* [http://mkv25.net/dfma/movie-1611-cacamevsthedragon "Cacame vs. The Dragon" movie]
* [http://bay12forums.com/smf/index.php?topic=40632.0 "Cacame vs. the Dragon" short story]

===King Cacame and the Colossus===
* [http://bay12forums.com/smf/index.php?topic=41101.0 "King Cacame and the Colossus" short story]

===King Cacame and the State Visit===
* [http://www.bay12forums.com/smf/index.php?topic=39897.msg734323#msg734323 Bard's account of the meeting between King Cacame and King Iwo]
===King Cacame's quest===
* [http://www.bay12forums.com/smf/index.php?topic=41404.msg744116#msg744116 Fragmentary retelling of King Cacame's doings while incognito]
===King Cacame merrymaking with the Human besiegers===
* [http://mkv25.net/dfma/movie-1651-cacamevsthehumanspt1 Part 1][http://mkv25.net/dfma/movie-1652-cacamevsthehumanspt2 Part 2][http://mkv25.net/dfma/movie-1653-cacamevsthehumanspt3 Part 3]
===King Cacame relieving stress===
* [http://www.bay12forums.com/smf/index.php?topic=49381.0 "We Would Be Legends", short story]

[[Category:Humor and stories]]
[[ru:Cacame Awemedinade]]
{{unversioned}}

Save version

2026-04-20T13:22:09Z

Quietust:

Every world in ''Dwarf Fortress'' contains an internal '''save version''' ID number to denote the version in which it was last saved, as well as the version in which it was originally generated. When a world is loaded, the game uses this value to determine how to process all of the data it reads - data which didn't exist at the time is generated from scratch (e.g. [[v0.34:minecart|hauling routes]], added in version 0.34.08), and data which is no longer used (e.g. [[DF2014:thought|basic thoughts]], replaced with emotions in version 0.42.01) gets skipped.

Not all ''Dwarf Fortress'' releases actually incremented the save version number (especially those which only fixed bugs), and some releases incremented it multiple times (once for each piece of new data stored).

This number normally isn't visible during gameplay, but various tools (such as [[DFHack]]) can be used to query it.

{| class=wikitable
!Version number
!Save version code
|-
| [[Release information/53.12|53.12]]
| 3544
|-
| [[Release information/53.11|53.11]]
| 3543
|-
| [[Release information/53.10|53.10]]
| 3543
|-
| [[Release information/53.09|53.09]]
| 3543
|-
| [[Release information/53.08|53.08]]
| 3543
|-
| [[Release information/53.07|53.07]]
| 3543
|-
| [[Release information/53.06|53.06]]
| 3537
|-
| [[Release information/53.05|53.05]]
| 3535
|-
| [[Release information/53.04|53.04]]
| 3535
|-
| [[Release information/53.03|53.03]]
| 3535
|-
| [[Release information/53.02|53.02]]
| 3534
|-
| [[Release information/53.01|53.01]]
| 3534
|-
| [[Release information/52.05|52.05]]
| 3021
|-
| [[Release information/52.04|52.04]]
| 3021
|-
| [[Release information/52.03|52.03]]
| 3021
|-
| [[Release information/52.02|52.02]]
| 3015
|-
| [[Release information/52.01|52.01]]
| 3015
|-
| [[Release information/51.13|51.13]]
| 3015
|-
| [[Release information/51.12|51.12]]
| 3015
|-
| [[Release information/51.11|51.11]]
| 3014
|-
| [[Release information/51.10|51.10]]
| 3013
|-
| [[Release information/51.09|51.09]]
| 3013
|-
| [[Release information/51.08|51.08]]
| 3013
|-
| [[Release information/51.07|51.07]]
| 3013
|-
| [[Release information/51.06|51.06]]
| 3013
|-
| [[Release information/51.05|51.05]]
| 3013
|-
| [[Release information/51.04|51.04]]
| 3013
|-
| [[Release information/51.03|51.03]]
| 3013
|-
| [[Release information/51.02|51.02]]
| 3013
|-
| [[Release information/51.01|51.01]]
| Various (beta)
|-
| [[Release information/50.15|50.15]]
| 2082
|-
| [[Release information/50.14|50.14]]
| 2082
|-
| [[Release information/50.13|50.13]]
| 2082
|-
| [[Release information/50.12|50.12]]
| 2081
|-
| [[Release information/50.11|50.11]]
| 2081
|-
| [[Release information/50.10|50.10]]
| 2081
|-
| [[Release information/50.09|50.09]]
| 2081
|-
| [[Release information/50.08|50.08]]
| 2081
|-
| [[Release information/50.07|50.07]]
| 2081
|-
| [[Release information/50.06|50.06]]
| 2081
|-
| [[Release information/50.05|50.05]]
| 2081
|-
| [[Release information/50.04|50.04]]
| 2080
|-
| [[Release information/50.03|50.03]]
| 2080
|-
| [[Release information/50.02|50.02]]
| 2079
|-
| [[Release information/50.01|50.01]]
| 2078
|-
| [[DF2014:Release information/0.47.05|0.47.05]]
| 1716
|-
| [[DF2014:Release information/0.47.04|0.47.04]]
| 1715
|-
| [[DF2014:Release information/0.47.03|0.47.03]]
| 1712
|-
| [[DF2014:Release information/0.47.02|0.47.02]]
| 1711
|-
| [[DF2014:Release information/0.47.01|0.47.01]]
| 1710
|-
| [[DF2014:Release information/0.44.12|0.44.12]]
| 1625
|-
| [[DF2014:Release information/0.44.11|0.44.11]]
| 1623
|-
| [[DF2014:Release information/0.44.10|0.44.10]]
| 1620
|-
| [[DF2014:Release information/0.44.09|0.44.09]]
| 1614
|-
| [[DF2014:Release information/0.44.08|0.44.08]]
| 1613
|-
| [[DF2014:Release information/0.44.07|0.44.07]]
| 1612
|-
| [[DF2014:Release information/0.44.06|0.44.06]]
| 1611
|-
| [[DF2014:Release information/0.44.05|0.44.05]]
| 1604
|-
| [[DF2014:Release information/0.44.04|0.44.04]]
| 1603
|-
| [[DF2014:Release information/0.44.03|0.44.03]]
| 1600
|-
| [[DF2014:Release information/0.44.02|0.44.02]]
| 1597
|-
| [[DF2014:Release information/0.44.01|0.44.01]]
| 1596
|-
| [[DF2014:Release information/0.43.05|0.43.05]]
| 1556
|-
| [[DF2014:Release information/0.43.04|0.43.04]]
| 1555
|-
| [[DF2014:Release information/0.43.03|0.43.03]]
| 1553
|-
| [[DF2014:Release information/0.43.02|0.43.02]]
| 1552
|-
| [[DF2014:Release information/0.43.01|0.43.01]]
| 1551
|-
| [[DF2014:Release information/0.42.06|0.42.06]]
| 1542
|-
| [[DF2014:Release information/0.42.05|0.42.05]]
| 1537
|-
| [[DF2014:Release information/0.42.04|0.42.04]]
| 1534
|-
| [[DF2014:Release information/0.42.03|0.42.03]]
| 1533
|-
| [[DF2014:Release information/0.42.02|0.42.02]]
| 1532
|-
| [[DF2014:Release information/0.42.01|0.42.01]]
| 1531
|-
| [[DF2014:Release information/0.40.24|0.40.24]]
| 1481
|-
| [[DF2014:Release information/0.40.23|0.40.23]]
| 1480
|-
| [[DF2014:Release information/0.40.22|0.40.22]]
| 1479
|-
| [[DF2014:Release information/0.40.21|0.40.21]]
| 1478
|-
| [[DF2014:Release information/0.40.20|0.40.20]]
| 1477
|-
| [[DF2014:Release information/0.40.19|0.40.19]]
| 1474
|-
| [[DF2014:Release information/0.40.18|0.40.18]]
| 1473
|-
| [[DF2014:Release information/0.40.17|0.40.17]]
| 1472
|-
| [[DF2014:Release information/0.40.16|0.40.16]]
| 1471
|-
| [[DF2014:Release information/0.40.15|0.40.15]]
| 1470
|-
| [[DF2014:Release information/0.40.14|0.40.14]]
| 1469
|-
| [[DF2014:Release information/0.40.13|0.40.13]]
| 1462
|-
| [[DF2014:Release information/0.40.12|0.40.12]]
| 1459
|-
| [[DF2014:Release information/0.40.11|0.40.11]]
| 1456
|-
| [[DF2014:Release information/0.40.10|0.40.10]]
| 1452
|-
| [[DF2014:Release information/0.40.09|0.40.09]]
| 1451
|-
| [[DF2014:Release information/0.40.08|0.40.08]]
| 1449
|-
| [[DF2014:Release information/0.40.07|0.40.07]]
| 1448
|-
| [[DF2014:Release information/0.40.06|0.40.06]]
| 1446
|-
| [[DF2014:Release information/0.40.05|0.40.05]]
| 1445
|-
| [[DF2014:Release information/0.40.04|0.40.04]]
| 1444
|-
| [[DF2014:Release information/0.40.03|0.40.03]]
| 1443
|-
| [[DF2014:Release information/0.40.02|0.40.02]]
| 1442
|-
| [[DF2014:Release information/0.40.01|0.40.01]]
| 1441
|-
| [[v0.34:Release information/0.34.11|0.34.11]]
| 1404
|-
| [[v0.34:Release information/0.34.10|0.34.10]]
| 1403
|-
| [[v0.34:Release information/0.34.09|0.34.09]]
| 1402
|-
| [[v0.34:Release information/0.34.08|0.34.08]]
| 1400
|-
| [[v0.34:Release information/0.34.07|0.34.07]]
| 1383
|-
| [[v0.34:Release information/0.34.06|0.34.06]]
| 1382
|-
| [[v0.34:Release information/0.34.05|0.34.05]]
| 1378
|-
| [[v0.34:Release information/0.34.04|0.34.04]]
| 1377
|-
| [[v0.34:Release information/0.34.03|0.34.03]]
| 1376
|-
| [[v0.34:Release information/0.34.02|0.34.02]]
| 1374
|-
| [[v0.34:Release information/0.34.01|0.34.01]]
| 1372
|-
| [[v0.31:Release information/0.31.25|0.31.25]]
| 1362
|-
| [[v0.31:Release information/0.31.24|0.31.24]]
| 1361
|-
| [[v0.31:Release information/0.31.23|0.31.23]]
| 1360
|-
| [[v0.31:Release information/0.31.22|0.31.22]]
| 1359
|-
| [[v0.31:Release information/0.31.21|0.31.21]]
| 1354
|-
| [[v0.31:Release information/0.31.20|0.31.20]]
| 1353
|-
| [[v0.31:Release information/0.31.19|0.31.19]]
| 1351
|-
| [[v0.31:Release information/0.31.18|0.31.18]]
| 1341
|-
| [[v0.31:Release information/0.31.17|0.31.17]]
| 1340
|-
| [[v0.31:Release information/0.31.16|0.31.16]]
| 1327
|-
| [[v0.31:Release information/0.31.15|0.31.15]]
| 1326
|-
| [[v0.31:Release information/0.31.14|0.31.14]]
| 1325
|-
| [[v0.31:Release information/0.31.13|0.31.13]]
| 1323
|-
| [[v0.31:Release information/0.31.12|0.31.12]]
| 1311
|-
| [[v0.31:Release information/0.31.11|0.31.11]]
| 1310
|-
| [[v0.31:Release information/0.31.10|0.31.10]]
| 1305
|-
| [[v0.31:Release information/0.31.09|0.31.09]]
| 1304
|-
| [[v0.31:Release information/0.31.08|0.31.08]]
| 1300
|-
| [[v0.31:Release information/0.31.07|0.31.07]]
| Unknown
|-
| [[v0.31:Release information/0.31.06|0.31.06]]
| 1297
|-
| [[v0.31:Release information/0.31.05|0.31.05]]
| 1295
|-
| [[v0.31:Release information/0.31.04|0.31.04]]
| 1292
|-
| [[v0.31:Release information/0.31.03|0.31.03]]
| 1289
|-
| [[v0.31:Release information/0.31.02|0.31.02]]
| 1288
|-
| [[v0.31:Release information/0.31.01|0.31.01]]
| 1287
|-
| [[40d:Release information/0.28.181.40d|0.28.181.40d]]
| 1268
|-
| [[40d:Release information/0.28.181.40c|0.28.181.40c]]
| 1267
|-
| [[40d:Release information/0.28.181.40b|0.28.181.40b]]
| 1266
|-
| [[40d:Release information/0.28.181.40a|0.28.181.40a]]
| 1265
|-
| [[40d:Release information/0.28.181.39f|0.28.181.39f]]
| 1261
|-
| [[40d:Release information/0.28.181.39e|0.28.181.39e]]
| 1260
|-
| [[40d:Release information/0.28.181.39d|0.28.181.39d]]
| 1259
|-
| [[40d:Release information/0.28.181.39c|0.28.181.39c]]
| 1256
|-
| [[40d:Release information/0.28.181.39b|0.28.181.39b]]
| 1255
|-
| [[40d:Release information/0.28.181.39a|0.28.181.39a]]
| 1254
|-
| [[40d:Release information/0.27.176.38c|0.27.176.38c]]
| 1235
|-
| [[40d:Release information/0.27.176.38b|0.27.176.38b]]
| 1234
|-
| [[40d:Release information/0.27.176.38a|0.27.176.38a]]
| 1231
|-
| [[40d:Release information/0.27.173.38a|0.27.173.38a]]
| 1223
|-
| [[40d:Release information/0.27.169.33g|0.27.169.33g]]
| 1216
|-
| [[40d:Release information/0.27.169.33f|0.27.169.33f]]
| 1215
|-
| [[40d:Release information/0.27.169.33e|0.27.169.33e]]
| 1213
|-
| [[40d:Release information/0.27.169.33d|0.27.169.33d]]
| 1212
|-
| [[40d:Release information/0.27.169.33c|0.27.169.33c]]
| 1211
|-
| [[40d:Release information/0.27.169.33b|0.27.169.33b]]
| 1209
|-
| [[40d:Release information/0.27.169.33a|0.27.169.33a]]
| 1206
|-
| [[40d:Release information/0.27.169.32a|0.27.169.32a]]
| 1205
|-
| [[23a:Release information/0.23.130.23a|0.23.130.23a]]
| 1169
|-
| [[23a:Release information/0.23.125.23b|0.23.125.23b]]
| 1168
|-
| [[23a:Release information/0.23.125.23a|0.23.125.23a]]
| 1167
|-
| [[23a:Release information/0.22.123.23a|0.22.123.23a]]
| 1165
|-
| [[23a:Release information/0.22.121.23b|0.22.121.23b]]
| 1161
|-
| [[23a:Release information/0.22.121.23a|0.22.121.23a]]
| 1160
|-
| [[23a:Release information/0.22.120.23b|0.22.120.23b]]
| 1159
|-
| [[23a:Release information/0.22.120.23a|0.22.120.23a]]
| 1151
|-
| [[23a:Release information/0.22.110.23c|0.22.110.23c]]
| 1148
|-
| [[23a:Release information/0.22.110.23b|0.22.110.23b]]
| 1148
|-
| [[23a:Release information/0.22.110.23a|0.22.110.23a]]
| 1148
|-
| [[23a:Release information/0.22.110.22f|0.22.110.22f]]
| 1137
|-
| [[23a:Release information/0.22.110.22e|0.22.110.22e]]
| 1134
|-
| [[23a:Release information/0.22.110.22d|0.22.110.22d]]
| 1133
|-
| [[23a:Release information/0.22.110.22c|0.22.110.22c]]
| 1133
|-
| [[23a:Release information/0.22.110.22b|0.22.110.22b]]
| 1131
|-
| [[23a:Release information/0.22.110.22a|0.22.110.22a]]
| 1131
|-
| [[23a:Release information/0.22.107.21a|0.22.107.21a]]
| 1128
|-
| [[23a:Release information/0.21.105.21a|0.21.105.21a]]
| 1128
|-
| [[23a:Release information/0.21.104.21c|0.21.104.21c]]
| 1128
|-
| [[23a:Release information/0.21.104.21b|0.21.104.21b]]
| 1125
|-
| [[23a:Release information/0.21.104.21a|0.21.104.21a]]
| 1123
|-
| [[23a:Release information/0.21.104.19d|0.21.104.19d]]
| 1121
|-
| [[23a:Release information/0.21.104.19c|0.21.104.19c]]
| 1121
|-
| [[23a:Release information/0.21.104.19b|0.21.104.19b]]
| 1119
|-
| [[23a:Release information/0.21.104.19a|0.21.104.19a]]
| 1119
|-
| [[23a:Release information/0.21.102.19a|0.21.102.19a]]
| 1117
|-
| [[23a:Release information/0.21.101.19d|0.21.101.19d]]
| 1114
|-
| [[23a:Release information/0.21.101.19c|0.21.101.19c]]
| 1114
|-
| [[23a:Release information/0.21.101.19b|0.21.101.19b]]
| 1114
|-
| [[23a:Release information/0.21.101.19a|0.21.101.19a]]
| 1113
|-
| [[23a:Release information/0.21.100.19a|0.21.100.19a]]
| 1110
|-
| [[23a:Release information/0.21.95.19c|0.21.95.19c]]
| 1110
|-
| [[23a:Release information/0.21.95.19b|0.21.95.19b]]
| 1108
|-
| [[23a:Release information/0.21.95.19a|0.21.95.19a]]
| 1108
|-
| [[23a:Release information/0.21.93.19c|0.21.93.19c]]
| 1108
|-
| [[23a:Release information/0.21.93.19b|0.21.93.19b]]
| 1108
|-
| [[23a:Release information/0.21.93.19a|0.21.93.19a]]
| 1107
|}
[[Category:Game development]]
[[Category:Release information]]

Intro movie

2026-04-16T03:13:41Z

Quietust: /* Fun */

The '''intro movie''' to ''Dwarf Fortress'' played with old versions when the game was opened, unless it was [[DF2014:Technical_tricks#Intro_Movie|disabled]].

==Opening credits==
First, the [[Bay 12 Games]] logo is displayed. Second, the Bay 12 Games motto (''Beyond Quality'') appears.
In the next scene ''A [[Toady One]] The Great Production'' is pulled across the screen on a wheeled platform by a dwarf.
[[File:intro_movie_1.gif|frame|center]]
{{-}}

==Title==
The camera pans down from a blue sky to the entrance to a dwarven mountainhome. The title ''Slaves to Armok: God of Blood Chapter II: Dwarf Fortress'' appears above the entrance. Dwarves can be seen on the ground, and one enters the mountainhome.
[[File:intro_movie_2.gif|frame|center]]
{{-}}

==Blacksmith==
The camera enters the mountainhome and finds its way to a blacksmith using an anvil and hammer to form a glowing-hot piece of metal.
[[File:intro_movie_3.gif|frame|center]]
{{-}}

==Cave River==
The camera then pans to the left and enters a door leading to a bridge that crosses the [[23a:cave river|cave river]].
[[File:intro_movie_4.gif|frame|center]]
{{-}}

==Sparring dwarves==
The camera enters a door at the end of that bridge and focuses on two dwarves [[sparring]] with adamantine weapons.
[[File:intro_movie_5.gif|frame|center]]
{{-}}

==Chasm==
The camera then goes into the door on the left and goes down several tunnels, including a bridge over the [[23a:chasm|chasm]] until it comes to a dwarf mining. The miner strikes the wall of the cavern, makes a hole, and loses his pickaxe down said hole.
[[File:intro_movie_6.gif|frame|center]]
{{-}}

==Fun==
The miner looks into the hole and [[23a:magma flow#Initial Flood|bursts into flame]].
[[File:intro_movie_7.gif|frame|center]]
{{-}}

[[Category:Game]]
[[ru:Intro movie]]

Intro movie

2026-04-16T03:12:37Z

Quietust: the cavern lake is the 2D Cave River, there's a bridge over the Chasm (with bats flying by), and the miner at the end just breached the Magma Flow and triggered a flood

The '''intro movie''' to ''Dwarf Fortress'' played with old versions when the game was opened, unless it was [[DF2014:Technical_tricks#Intro_Movie|disabled]].

==Opening credits==
First, the [[Bay 12 Games]] logo is displayed. Second, the Bay 12 Games motto (''Beyond Quality'') appears.
In the next scene ''A [[Toady One]] The Great Production'' is pulled across the screen on a wheeled platform by a dwarf.
[[File:intro_movie_1.gif|frame|center]]
{{-}}

==Title==
The camera pans down from a blue sky to the entrance to a dwarven mountainhome. The title ''Slaves to Armok: God of Blood Chapter II: Dwarf Fortress'' appears above the entrance. Dwarves can be seen on the ground, and one enters the mountainhome.
[[File:intro_movie_2.gif|frame|center]]
{{-}}

==Blacksmith==
The camera enters the mountainhome and finds its way to a blacksmith using an anvil and hammer to form a glowing-hot piece of metal.
[[File:intro_movie_3.gif|frame|center]]
{{-}}

==Cave River==
The camera then pans to the left and enters a door leading to a bridge that crosses the [[23a:cave river|cave river]].
[[File:intro_movie_4.gif|frame|center]]
{{-}}

==Sparring dwarves==
The camera enters a door at the end of that bridge and focuses on two dwarves [[sparring]] with adamantine weapons.
[[File:intro_movie_5.gif|frame|center]]
{{-}}

==Chasm==
The camera then goes into the door on the left and goes down several tunnels, including a bridge over the [[23a:chasm|chasm]] until it comes to a dwarf mining. The miner strikes the wall of the cavern, makes a hole, and loses his pickaxe down said hole.
[[File:intro_movie_6.gif|frame|center]]
{{-}}

==Fun==
The miner looks into the hole and [[23a:magma flow|bursts into flame]].
[[File:intro_movie_7.gif|frame|center]]
{{-}}

[[Category:Game]]
[[ru:Intro movie]]

Template:Current/version

2026-04-14T22:01:38Z

Quietust:

53.12<noinclude>

This template is the most recent version (hopefully).
Include it in places that you want to refer to the most recent version.

If this template isn't up to date, feel free to correct it.

== See also ==
{{tl|current/version/ns}}

[[Category:Version {{current/version}}]][[category:wiki]][[Category:Version templates]]</noinclude>

Fire

2026-04-12T18:02:24Z

Quietust:

{{Quality|Exceptional}}
{{av}}
[[File:fire_sprite_anim.gif|right]]'''Fire''', like its real-life counterpart, is an immensely [[fun|destructive]] force. Fires can spread and burn dwarves and furniture, generating [[smoke]]. Fire spreads over flammable surfaces, items and creatures. Dwarves caught in the blaze might end up dying, and items will slowly get [[wear|damaged]] until they get destroyed. In-game, entities which are on fire flash red and yellow. In item lists, anything which is on fire will also be surrounded by double exclamation marks, similarly to ‼THIS‼.

== Cause ==
[[File:megabeast_fire_v50_anim.gif|thumb|303px|right|A [[megabeast]] burning to death.]][[File:Running around on fire.gif|thumb|'''‼'''Dwarves'''‼''' on fire (flashing red/yellow), and trailing [[smoke]].]]A fire can stem from several sources, for example:
*[[Dragon]]s breathe [[dragonfire]], which can set most organic things on fire and melt fire-safe stone, at anything hostile they see. The dragonfire spreads out in a conical shape and ignites anything it touches. It is not the same as regular fire.
*[[File:fireball_sprite_anim.gif|thumb|32px|right|Imp fireball.]][[Fire imp]]s can throw fireballs, which may set things alight, while [[magma crab]]s can spit globs of liquid [[basalt]], which may set the [[grass]] or [[cave moss]] alight, causing fires.
*[[Magma]] will burn anything flammable it touches - however, any item set alight by this method will likely just be doused in magma until it is completely destroyed.
**[[Magma mist]] burns stuff just as well as magma.
*Some [[titan]]s, [[forgotten beast]]s, and [[demon]]s can breathe fire/throw fireballs, too.
*[[Fire man|Fire men]] and [[magma man|magma men]], as well as other procedurally-generated beasts composed of flame (''including some instances of the above''), have high fixed body temperatures, causing them to spread fires (and [[fun]]) in their path.

Note that it is currently difficult to safely start (and then, control) a fire. Fire is most easily started by either [[magma]] or a fire-breathing attack. An area enclosed by [[water]], metal, stone or Z-level difference can be used to start a fire, which can be used as a way of increasing [[FPS]] by removing objects, or as part of a complex trap, though this may lead to [[fun]] when something comes out burning which then sets the rest of the fort on fire.

== Spread & Effect ==
[[File:magma_spill_anim.gif|thumb|185px|right|Magma spilling in, setting workshops ablaze.]]Fire will spread to adjacent tiles containing flammable materials, including [[grass]], [[shrub]]s, [[log]]s, [[clothes]], [[dwarves]] (and generally all creatures that are not composed of [[fire-safe]] materials), multi-tile trees, wooden [[furniture]], [[building]]s, and [[road]]s, [[lignite]] and [[bituminous coal]] rocks, and bars of [[charcoal]], or [[coke]]. Except for dragonfire, fire won't burn rock or metal. Constructions (wall, floor, etc.) will currently never burn, no matter what.

Fire will not spread across z-levels by itself. Walls with trapped passages block the fire, too. Both shrubs and trees can catch fire, and burning branches can potentially spread fires uphill. When aboveground, spreading fire can cause trees to collapse, and if it spreads too much, this can cause spam as the game repeatedly announces "Something outside has collapsed!" and pauses. Note that these collapses can cause holes in the ceiling of your fortress if it is directly below. Therefore, some forest fires are sadly best left controlled, or not started.

Fires burning in the environment (e.g. burning [[grass]]) start at a temperature of {{ct|10508}} and quickly heat up to {{ct|10708}}, while burning items rapidly heat up to 200 degrees above their ignition point (but stay slightly below that, because the surrounding air cools them a bit). Items experience rapid [[wear]]-based damage while burning, and continue to degrade until entirely destroyed. [[Fire-safe]]ty for any material is defined as being stable at a [[temperature]] of {{ct|11000}}.

=== Artifacts ===
[[Artifact|Artifacts]] constructed from a flammable base material can burn, but will not experience any [[wear]], potentially leaving them burning forever, including artifacts used as part of a building. If an artifact is not stored in a bin, water will extinguish it. Artifacts with a melting or boiling point can still be destroyed if the items exceed those temperatures (as a result of combustion, [[magma]], or [[dragonfire|other sources]]).

Interestingly, because [[books]] are considered artifacts, they too will burn indefinitely, but because their copies aren't, such copies ''will'' burn up.

=== Ghosts ===
One thing to note is that dwarves that burn to death do not leave remains, and will produce [[ghost]]s even if buried in a coffin. Be sure to engrave a memorial to all dwarves that burn to ashes, unless, of course, you ''want'' a ghost infestation.

== Dragonfire ==
{{main|Dragonfire}}

Dragonfire is a very powerful form of fire that is capable of igniting or melting many fire-safe materials. Specifically, organic materials ignite (including [[nether-cap]]), and non-flammable stones and metals melt and boil away. Objects ignited by dragonfire burn at their standard combustion temperature - only the initial blast of dragonfire is able to destroy [[fire-safe]] materials. Dragonfire can only naturally be emitted by [[dragon]]s.

== Dangers ==
In recent versions of ''Dwarf Fortress'', dwarves (semi-correctly) see fire as a danger to themselves and try to avoid becoming ‼Dwarves‼. However, burning dwarves will carry out typical dwarven activities, despite the fact that the <s>dwarf</s> fire-swathed fool of an Urist is burning to death, and will spread the fiery destruction to their peers. {{verify}} This may not only kill your dwarves, but more importantly, also incinerate a good many useful items. Dwarves will not path through smoke reliably, so if you see a bunch of job cancellations due to pathing issues, a fiery dwarf is probably running around (or other [[fun]] is afoot). Alternatively, sometimes the smoke on the burning dwarf's tile prevents them from pathing anywhere, forcing them to be stationary while they burn. And don't, for Armok's sake, let the flaming dwarves anywhere near the booze. Contrary to popular belief, it doesn't ''explode'' (and never did), but it ''will'' boil away into nothing, which is always [[fun#No_Booze|fun]].

A dwarf catching fire is not an automatic death sentence - dwarves have been observed catching fire, then extinguishing and surviving.

[[File:dwarf_fire_preview.png|thumb|289px|center|‼Punctuation marks have never been so painful‼ ''Art by Locus'']]

{{Translation
| dwarven = ziril
| elvish = inira
| goblin = zedan
| human = usmok
}}

{{Category|Physics}}
[[ru:Fire]]

Soil

2026-04-09T02:52:50Z

Quietust: fix grammar

{{migrated article}}
{{av}}
{{Quality|Fine}}
[[File:soil_preview.png|thumb|270px|right|Probably not enough for 80 dwarves.]]'''Soil''' is the name for the various kinds of ground that can be [[farming|planted]] on (both above and below ground) without [[irrigation]] using [[water]]. In ''Dwarf Fortress'', the category of "Soil" includes all types of sand, [[clay]], ooze and any "non-stone" layer equally, even if you or I generally don't associate that substance with "growing plants".

{{Translation
| dwarven = adur
| elvish = avi
| goblin = snustrok
| human = ocul
}}
{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
! Topsoil
! Tile
|-
|[[Loam]]||{{Raw Tile|░|6:7:0}}{{Raw Tile|.|6:0}} {{Raw Tile|≈|3:1:1}}
|-
|[[Loamy sand]]||{{Raw Tile|▒|6:6:1}}{{Raw Tile|.|6:1}} {{Raw Tile|≈|3:1:1}}
|-
|[[Peat]]||{{Raw Tile|░|0:6:1}}{{Raw Tile|.|0:1}} {{Raw Tile|≈|3:1:1}}
|-
|[[Sandy clay loam]]||{{Raw Tile|░|4:6:0}}{{Raw Tile|.|4:0}} {{Raw Tile|≈|3:1:1}}
|-
|[[Sandy loam]]||{{Raw Tile|░|6:6:1}}{{Raw Tile|.|6:1}} {{Raw Tile|≈|3:1:1}}
|-
|[[Silt]]||{{Raw Tile|▓|6:7:0}}{{Raw Tile|.|6:0}} {{Raw Tile|≈|3:1:1}}
|-
|[[Silty clay loam]]||{{Raw Tile|░|4:7:0}}{{Raw Tile|.|4:0}} {{Raw Tile|≈|3:1:1}}
|-
|[[Silt loam]]||{{Raw Tile|▒|6:7:0}}{{Raw Tile|.|6:0}} {{Raw Tile|≈|3:1:1}}
|-
! Ocean Floor
! Tile
|-
|[[Pelagic clay]]||{{Raw Tile|░|4:6:0}}{{Raw Tile|.|4:0}} {{Raw Tile|≈|3:1:1}}
|-
|[[Siliceous ooze]]||{{Raw Tile|▒|4:7:0}}{{Raw Tile|.|4:0}} {{Raw Tile|≈|3:1:1}}
|-
|[[Calcareous ooze]]||{{Raw Tile|▒|4:7:0}}{{Raw Tile|.|4:0}} {{Raw Tile|≈|3:1:1}}
|-
! [[Sand]]
! Tile
|-
|[[Sand (tan)]]||{{Raw Tile|░|6:4:1}}{{Raw Tile|≈|6:1}} {{Raw Tile|≈|3:1:1}}
|-
|[[Black sand]]||{{Raw Tile|▓|0:6:1}}{{Raw Tile|≈|0:1}} {{Raw Tile|≈|3:1:1}}
|-
|[[Red sand]]||{{Raw Tile|░|4:4:1}}{{Raw Tile|≈|4:1}} {{Raw Tile|≈|3:1:1}}
|-
|[[White sand]]||{{Raw Tile|▓|7:6:1}}{{Raw Tile|≈|7:1}} {{Raw Tile|≈|3:1:1}}
|-
|[[Yellow sand]]||{{Raw Tile|▓|6:6:1}}{{Raw Tile|≈|6:1}} {{Raw Tile|≈|3:1:1}}
|-
! Clay
! Tile
|-
|[[Clay]]||{{Raw Tile|▓|4:6:0}}{{Raw Tile|.|4:0}}
|-
|[[Clay loam]]||{{Raw Tile|▒|4:7:0}}{{Raw Tile|.|4:0}}
|-
|[[Sandy clay]]||{{Raw Tile|▒|4:6:0}}{{Raw Tile|.|4:0}}
|-
|[[Silty clay]]||{{Raw Tile|▓|4:7:0}}{{Raw Tile|.|4:0}}
|-
|[[Fire clay]]||{{Raw Tile|▓|4:6:0}}{{Raw Tile|.|4:0}}
|}
'''Notes:'''
* The "topsoil" types "Loamy sand", "Sandy clay loam", and "Sandy loam" do '''not''' count as [[sand]] for [[glass]]making, even if their names include the word "sand" - only those in the "Sand" section are usable for this purpose.
* The 3 "ocean floor" layers are only found under deep [[ocean]] tiles, usually far out from any embarkable site. Thus, they can rarely, if ever be encountered, in either [[fortress mode]] or [[adventurer mode]].
* Soil layers marked with {{Raw Tile|≈|3:1:1}} are capable of supporting an [[aquifer]].
* The [[clay]] types listed at the bottom can be used for making ceramic items. Fire clay produces [[stoneware]], while the other types produce [[earthenware]].

In previous versions, types and quantities of available soils were listed at the bottom right of the fortress location selection screen; in the current version, however, it will only indicate the presence of soil and whether it can be used as [[clay]].

Digging into soil does not generate any byproduct materials, unlike digging in [[stone|rock]], and also is a much faster process which makes it much easier to create storerooms and other large areas of empty space, and to train [[miner]]s.

Soil cannot be [[Smoothing|smooth]]ed, which makes it more difficult to make high-value rooms or pierce [[aquifer]]s, and impossible to carve [[fortification]]s, [[track]]s, or [[engraving]]s.

Building a [[farm plot]] or [[road]] or removing a [[construction]] on top of soil will cause it to become "furrowed", making it appear with the {{Tile|≈|6:0}} and {{Tile|~|6:0}} tiles. Furrowed soil — including furrowed subterranean soil — will gradually smooth itself out, at which point grass and other vegetation will begin to grow. Sand always appears as {{Tile|≈|6:0}} and {{Tile|~|6:0}} and cannot become furrowed - as such, sand roads do not last as long as those made on ordinary soil.

===Trees and Shrubs===
Once you discover any [[cavern]] layer, all subterranean [[grass]], [[shrub]]s, and [[tree]]s growing within that cavern will begin to grow on any subterranean soil. Any kind of vegetation implicitly has some soil under it, even if it grew on [[mud]]dy stone; clearing the growth (such as by building a [[road]]) will thus create a soil floor, even in a stone [[layer]]. It will typically correspond to the lowest soil layer in the local [[biome]]; if that happens to be useful clay or sand, an enterprising player can use [[irrigation]] and some patience to move their sand/clay collection [[zone]]s closer to the [[magma]].

{{materials}}
{{soil}}

{{Category|Soil Layers|*}}
[[Ru:Soil]]

v0.31:Inorganic material definition token

2026-04-04T01:18:11Z

Quietust:

{{quality|Exceptional|21:09, 30 March 2011 (UTC)}}{{av}}

The following tokens can be used in inorganic material definitions, generally those for stones, gems, and metals. They cannot be used with materials attached to plants or creatures.

{| {{prettytable}}
|- style='background-color:#ddd'
! Token
! Arguments
! Description
|-
| {{text anchor|WAFERS}}|| ||Used on metals, causes the metal to be made into wafers instead of [[bar]]s.
|-
| {{text anchor|DEEP_SPECIAL}}|| || Causes the stone to form hollow tubes leading to the [[Underworld]]. Used for [[raw adamantine]]. When mined, stone has a 100% yield. If no material with this token exists, hollow veins will instead be made of the first available inorganic, usually [[iron]].
|-
| {{text anchor|METAL_ORE}}|| metal:chance || Allows the ore to be [[smelter|smelted]] into metal in the smelter. Multiple tokens allow multiple types of metal to be smelted from a single ore.
|-
| {{text anchor|THREAD_METAL}}|| metal:chance ||Allows strands to be extracted from the metal at a [[craftsdwarf's workshop]].
|-
| {{text anchor|DEEP_SURFACE}}|| ||Causes the stone to line the landscape of the [[Underworld]]. Used for [[slade]]. When mined (if it's mineable), stone has a 100% yield. If no material with this token exists, other materials will be used in place of slade.
|-
| {{text anchor|AQUIFER}}|| ||Allows the stone to support an [[aquifer]].
|-
| {{text anchor|METAMORPHIC}}|| ||Causes the material to form [[metamorphic layer]]s.
|-
| {{text anchor|SEDIMENTARY}}|| ||Causes the material to form [[sedimentary layer]]s.
|-
| {{text anchor|SOIL}}|| ||Causes the material to form [[soil]] layers, allowing it to appear in (almost) any biome. Mining is faster and produces no stones.
|-
| {{text anchor|SOIL_OCEAN}}|| ||Causes the material to form [[soil|pelagic sediment]] layers beneath deep oceans. Mining is faster and produces no stones.
|-
| {{text anchor|SOIL_SAND}}|| ||Causes the material to form [[sand]] layers, allowing it to appear in [[sand desert]]s and shallow [[ocean]]s. Mining is faster and produces no stones. Sand layers can also be used for making [[glass]]. Can be combined with [SOIL].
|-
| {{text anchor|SEDIMENTARY_OCEAN_SHALLOW}}|| ||Permits an already [SEDIMENTARY] stone layer to appear underneath shallow ocean regions.
|-
| {{text anchor|SEDIMENTARY_OCEAN_DEEP}}|| ||Permits an already [SEDIMENTARY] stone layer to appear underneath deep ocean regions.
|-
| {{text anchor|IGNEOUS_INTRUSIVE}}|| || Causes the material to form [[igneous intrusive layer]]s.
|-
| {{text anchor|IGNEOUS_EXTRUSIVE}}|| || Causes the material to form [[igneous extrusive layer]]s.
|-
| {{text anchor|ENVIRONMENT}}|| class:type:freq ||Specifies what types of layers will contain this mineral. Multiple instances of the same token segment will cause the rock type to occur more frequently, but won't increase its abundance in the specified environment. See below.
|-
| {{text anchor|ENVIRONMENT_SPEC}}|| stone:type:freq ||Specifies which specific minerals will contain this mineral. See below.
|-
| {{text anchor|LAVA}}|| ||Specifies that the stone is created when combining [[water]] and [[magma]], also causing it to line the edges of [[magma]] pools and volcanoes. If multiple minerals are marked as lava stones, a different one will be used in each biome or geological region.
|}

==ENVIRONMENT and ENVIRONMENT_SPEC==

Format:
* [ENVIRONMENT:<class>:<inclusion type>:<frequency>]

Possible values for class:
{| {{prettytable}}
|- style='background-color:#ddd'
! Environment class token
! Description
|-
| {{text anchor|ALL_STONE}}||Will appear in every stone.
|-
| {{text anchor|IGNEOUS_ALL}}, {{text anchor|IGNEOUS_INTRUSIVE}}, {{text anchor|IGNEOUS_EXTRUSIVE}}||Will appear in igneous layers, either [[igneous intrusive]], [[igneous extrusive]], or both.
|-
| {{text anchor|SOIL}}, {{text anchor|SOIL_OCEAN}}, {{text anchor|SOIL_SAND}}||Will appear in soil. SOIL_OCEAN is oceans specifically and SOIL_SAND is sand specifically.
|-
| {{text anchor|METAMORPHIC}}||Will appear in [[metamorphic]] layers.
|-
| {{text anchor|SEDIMENTARY}}||Will appear in [[sedimentary]] layers.
|-
| {{text anchor|ALLUVIAL}}||Will appear in [[alluvial]] layers.
|}

Possible values for inclusion type:
{| {{prettytable}}
|- style='background-color:#ddd'
! Inclusion type token
! Description
|-
| {{text anchor|CLUSTER}}||Large ovoids that occupy their entire 48x48 embark tile. [[Microcline]] is an example. When mined, stone has a 25% yield (as with layer stones).
|-
| {{text anchor|CLUSTER_SMALL}}||Blobs of 3-9 tiles. Will always be successfully mined. [[Red pyrope]]s are an example. When mined, stone has a 100% yield.
|-
| {{text anchor|CLUSTER_ONE}}||Single tiles. Will always be successfully mined. [[Clear diamond]]s are an example. When mined, stone has a 100% yield.
|-
| {{text anchor|VEIN}}||Large streaks of stone. [[Native gold]] is an example. When mined, stone has a 33% yield instead of the usual 25%.
|}

An inclusion may be contained within a larger inclusion. For example, diamond small clusters are found within kimberlite veins.

The frequency number varies from 1 to 100 and determines the relative frequency at which the stone will be chosen to appear - if all frequency values are the same, then all stones will be equally likely to appear.

ENVIRONMENT_SPEC follows much the same format, but takes a specific stone material ID where ENVIRONMENT would take a class token. What you can use will depend on what inorganic raws are around.

Due to an error in the raw parsing logic, having multiple ENVIRONMENT_SPEC tokens will cause the inclusion type to be parsed in ''reverse'' order compared to the stone ID and frequency values - in the vanilla raws, this causes [[native platinum]] to appear as veins within [[chromite]] and as small clusters within [[olivine]].{{bug|1429}}

==See Also==
* [[Material definition token]]

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

v0.34:Inorganic material definition token

2026-04-04T01:17:08Z

Quietust:

{{quality|Exceptional|21:09, 30 March 2011 (UTC)}}{{av}}

The following tokens can be used in inorganic material definitions, generally those for stones, gems, and metals. They cannot be used with materials attached to plants or creatures.

{| {{prettytable}}
|- style='background-color:#ddd'
! Token
! Arguments
! Description
|-
| {{text anchor|WAFERS}}|| ||Used on metals, causes the metal to be made into wafers instead of [[bar]]s.
|-
| {{text anchor|DEEP_SPECIAL}}|| || Causes the stone to form hollow tubes leading to the [[Underworld]]. Used for [[raw adamantine]]. When mined, stone has a 100% yield. If no material with this token exists, hollow veins will instead be made of the first available inorganic, usually [[iron]].
|-
| {{text anchor|METAL_ORE}}|| metal:chance || Allows the ore to be [[smelter|smelted]] into metal in the smelter. Multiple tokens allow multiple types of metal to be smelted from a single ore.
|-
| {{text anchor|THREAD_METAL}}|| metal:chance ||Allows strands to be extracted from the metal at a [[craftsdwarf's workshop]].
|-
| {{text anchor|DEEP_SURFACE}}|| ||Causes the stone to line the landscape of the [[Underworld]]. Used for [[slade]]. When mined (if it's mineable), stone has a 100% yield. If no material with this token exists, other materials will be used in place of slade.
|-
| {{text anchor|AQUIFER}}|| ||Allows the stone to support an [[aquifer]].
|-
| {{text anchor|METAMORPHIC}}|| ||Causes the material to form [[metamorphic layer]]s.
|-
| {{text anchor|SEDIMENTARY}}|| ||Causes the material to form [[sedimentary layer]]s.
|-
| {{text anchor|SOIL}}|| ||Causes the material to form [[soil]] layers, allowing it to appear in (almost) any biome. Mining is faster and produces no stones.
|-
| {{text anchor|SOIL_OCEAN}}|| ||Causes the material to form [[soil|pelagic sediment]] layers beneath deep oceans. Mining is faster and produces no stones.
|-
| {{text anchor|SOIL_SAND}}|| ||Causes the material to form [[sand]] layers, allowing it to appear in [[sand desert]]s and shallow [[ocean]]s. Mining is faster and produces no stones. Sand layers can also be used for making [[glass]]. Can be combined with [SOIL].
|-
| {{text anchor|SEDIMENTARY_OCEAN_SHALLOW}}|| ||Permits an already [SEDIMENTARY] stone layer to appear underneath shallow ocean regions.
|-
| {{text anchor|SEDIMENTARY_OCEAN_DEEP}}|| ||Permits an already [SEDIMENTARY] stone layer to appear underneath deep ocean regions.
|-
| {{text anchor|IGNEOUS_INTRUSIVE}}|| || Causes the material to form [[igneous intrusive layer]]s.
|-
| {{text anchor|IGNEOUS_EXTRUSIVE}}|| || Causes the material to form [[igneous extrusive layer]]s.
|-
| {{text anchor|ENVIRONMENT}}|| class:type:freq ||Specifies what types of layers will contain this mineral. Multiple instances of the same token segment will cause the rock type to occur more frequently, but won't increase its abundance in the specified environment. See below.
|-
| {{text anchor|ENVIRONMENT_SPEC}}|| stone:type:freq ||Specifies which specific minerals will contain this mineral. See below.
|-
| {{text anchor|LAVA}}|| ||Specifies that the stone is created when combining [[water]] and [[magma]], also causing it to line the edges of [[magma]] pools and volcanoes. If multiple minerals are marked as lava stones, a different one will be used in each biome or geological region.
|-
| {{text anchor|SPECIAL}}|| ||Prevents the material from showing up in certain places. AI-controlled entities won't use the material to make items and don't bring it in caravans, though the player can use it as normal. Also, inorganic generated creatures (forgotten beasts, titans, demons) will never be composed of this material. Explicitly set by all [[evil weather]] materials and implied by [DEEP_SURFACE] and [DEEP_SPECIAL].
|-
| {{text anchor|GENERATED}}|| ||Indicates that this is a generated material. Cannot be specified in user-defined raws.
|}

==ENVIRONMENT and ENVIRONMENT_SPEC==

Format:
* [ENVIRONMENT:<class>:<inclusion type>:<frequency>]

Possible values for class:
{| {{prettytable}}
|- style='background-color:#ddd'
! Environment class token
! Description
|-
| {{text anchor|ALL_STONE}}||Will appear in every stone.
|-
| {{text anchor|IGNEOUS_ALL}}, {{text anchor|IGNEOUS_INTRUSIVE}}, {{text anchor|IGNEOUS_EXTRUSIVE}}||Will appear in igneous layers, either [[igneous intrusive]], [[igneous extrusive]], or both.
|-
| {{text anchor|SOIL}}, {{text anchor|SOIL_OCEAN}}, {{text anchor|SOIL_SAND}}||Will appear in soil. SOIL_OCEAN is oceans specifically and SOIL_SAND is sand specifically.
|-
| {{text anchor|METAMORPHIC}}||Will appear in [[metamorphic]] layers.
|-
| {{text anchor|SEDIMENTARY}}||Will appear in [[sedimentary]] layers.
|-
| {{text anchor|ALLUVIAL}}||Will appear in [[alluvial]] layers.
|}

Possible values for inclusion type:
{| {{prettytable}}
|- style='background-color:#ddd'
! Inclusion type token
! Description
|-
| {{text anchor|CLUSTER}}||Large ovoids that occupy their entire 48x48 embark tile. [[Microcline]] is an example. When mined, stone has a 25% yield (as with layer stones).
|-
| {{text anchor|CLUSTER_SMALL}}||Blobs of 3-9 tiles. Will always be successfully mined. [[Red pyrope]]s are an example. When mined, stone has a 100% yield.
|-
| {{text anchor|CLUSTER_ONE}}||Single tiles. Will always be successfully mined. [[Clear diamond]]s are an example. When mined, stone has a 100% yield.
|-
| {{text anchor|VEIN}}||Large streaks of stone. [[Native gold]] is an example. When mined, stone has a 33% yield instead of the usual 25%.
|}

An inclusion may be contained within a larger inclusion. For example, diamond small clusters are found within kimberlite veins.

The frequency number varies from 1 to 100 and determines the relative frequency at which the stone will be chosen to appear - if all frequency values are the same, then all stones will be equally likely to appear.

ENVIRONMENT_SPEC follows much the same format, but takes a specific stone material ID where ENVIRONMENT would take a class token. What you can use will depend on what inorganic raws are around.

Due to an error in the raw parsing logic, having multiple ENVIRONMENT_SPEC tokens will cause the inclusion type to be parsed in ''reverse'' order compared to the stone ID and frequency values - in the vanilla raws, this causes [[native platinum]] to appear as veins within [[chromite]] and as small clusters within [[olivine]].{{bug|1429}}

==See Also==
* [[Material definition token]]

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

Material definition token

2026-04-04T01:14:44Z

Quietust: remove inorganic tokens

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

DF2014:Material definition token

2026-04-04T01:14:13Z

Quietust: remove inorganic-specific tokens

{{Quality|Fine|11:11, 18 May 2015 (UTC)}}
{{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 [[material templates]].

__TOC__
{{clear}}

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

|-
| {{text_anchor|USE_MATERIAL_TEMPLATE}}
|
* <template name>
| Imports the properties of the specified preexisting material template.

|-
| {{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. 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 (no default creature has such an attack, but they can be modded in). 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 (no default creature has such an attack, but they can be modded in). 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 (no default creature has such an attack, but they can be modded in). 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. Does not allow an inferior metal to penetrate superior armor. 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 edged weapons to pierce tissue layers{{verify}}. Defaults to NONE.

|-
| {{text_anchor|LIQUID_DENSITY}}
|
*<density>
| Specifies the density of the material when in liquid form. Defaults to NONE.

|-
| {{text_anchor|MOLAR_MASS}}
|
*<value>
| Supposedly not used{{verify}}. Theoretically, should determine density (at given pressure) in gas state, on which in turn would depend (together with weight of vaporized material) on the volume covered by spreading vapors. Defaults to NONE.

|-
| {{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|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]].{{version|0.42.01}}

|-
| {{text_anchor|HARDENS_WITH_WATER}}
|
* <[[material token]]>
| Allows the material to be used to make [[healthcare|casts]].

|-
| {{text_anchor|SOAP_LEVEL}}
|
*<value>
| [[Soap]] has [SOAP_LEVEL:2]. Effects unknown. Defaults to 0.

|-
| {{text_anchor|SYNDROME}}
|
| Begins defining a [[syndrome]] applied by the material. Multiple syndromes can be specified. See [[Syndrome token]].
|}

===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 (which currently does '''not''' include [[elf|Elves]]) 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|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|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}}
|
| Allows the creation of metal furniture 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}}
|
| Random [[finished goods|crafts]] made from this material cannot be made into rings, crowns, scepters or figurines. Given to [[plant fiber]], [[silk]] and [[wool]].

|-
| {{text_anchor|ITEMS_HARD}}
|
| 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.

|-
| {{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.{{verify}}
|}

==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]]

v0.34:Material definition token

2026-04-04T01:13:51Z

Quietust: remove INORGANIC-specific tokens

{{quality|Exceptional|18:11, 28 April 2011 (UTC)}}{{av}}

The following tokens can be used in material definitions (whether for inorganics or those within plants and creatures) as well as in material templates.

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

|-
| {{text_anchor|USE_MATERIAL_TEMPLATE}}
|
* <template name>
| Imports the properties of the specified preexisting material template.

|-
| {{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. 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 (no default creature has such an attack, but they can be modded in). 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 (no default creature has such an attack, but they can be modded in). 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 (no default creature has such an attack, but they can be modded in). 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. Does not allow an inferior metal to penetrate superior armor. 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 edged weapons to pierce tissue layers{{verify}}. Defaults to NONE.

|-
| {{text_anchor|LIQUID_DENSITY}}
|
*<density>
| Specifies the density of the material when in liquid form. Defaults to NONE.

|-
| {{text_anchor|MOLAR_MASS}}
|
*<value>
| Supposedly not used{{verify}}. Theoretically, should determine density (at given pressure) in gas state, on which in turn would depend (together with weight of vaporized material) on the volume covered by spreading vapors. Defaults to NONE.

|-
| {{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|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|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, 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]].

|-
| {{text_anchor|HARDENS_WITH_WATER}}
|
* <[[material token]]>
| Allows the material to be used to make [[healthcare|casts]].

|-
| {{text_anchor|SOAP_LEVEL}}
|
*<value>
| [[Soap]] has [SOAP_LEVEL:2]. Effects unknown. Defaults to 0.

|-
| {{text_anchor|SYNDROME}}
|
| Begins defining a [[syndrome]] applied by the material. Multiple syndromes can be specified. See [[Syndrome token]].
|}

===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 (which currently does '''not''' include [[elf|Elves]]) 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|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|LEAF_MAT}}
|
| Classifies the material as plant leaf, allowing its storage in food stockpiles under "Leaves".

|-
| {{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|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|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|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}}
|
| Allows the creation of metal furniture 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}}
|
| Random [[finished goods|crafts]] made from this material cannot be made into rings, crowns, scepters or figurines. Given to [[plant fiber]], [[silk]] and [[wool]].

|-
| {{text_anchor|ITEMS_HARD}}
|
| 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.

|-
| {{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.{{verify}}
|}

==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_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]]

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

v0.31:Material definition token

2026-04-04T01:13:33Z

Quietust:

{{quality|Exceptional|18:11, 28 April 2011 (UTC)}}{{av}}

The following tokens can be used in material definitions (whether for inorganics or those within plants and creatures) as well as in material templates.

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

|-
| {{text_anchor|USE_MATERIAL_TEMPLATE}}
|
* <template name>
| Imports the properties of the specified preexisting material template.

|-
| {{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. 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 (no default creature has such an attack, but they can be modded in). 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 (no default creature has such an attack, but they can be modded in). 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 (no default creature has such an attack, but they can be modded in). 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. Does not allow an inferior metal to penetrate superior armor. 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 edged weapons to pierce tissue layers{{verify}}. Defaults to NONE.

|-
| {{text_anchor|LIQUID_DENSITY}}
|
*<density>
| Specifies the density of the material when in liquid form. Defaults to NONE.

|-
| {{text_anchor|MOLAR_MASS}}
|
*<value>
| Supposedly not used{{verify}}. Theoretically, should determine density (at given pressure) in gas state, on which in turn would depend (together with weight of vaporized material) on the volume covered by spreading vapors. Defaults to NONE.

|-
| {{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|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|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, 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]].

|-
| {{text_anchor|HARDENS_WITH_WATER}}
|
* <[[material token]]>
| Allows the material to be used to make [[healthcare|casts]].

|-
| {{text_anchor|SOAP_LEVEL}}
|
*<value>
| [[Soap]] has [SOAP_LEVEL:2]. Effects unknown. Defaults to 0.

|-
| {{text_anchor|SYNDROME}}
|
| Begins defining a [[syndrome]] applied by the material. Multiple syndromes can be specified. See [[Syndrome token]].
|}

===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 (which currently does '''not''' include [[elf|Elves]]) 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|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|LEAF_MAT}}
|
| Classifies the material as plant leaf, allowing its storage in food stockpiles under "Leaves".

|-
| {{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|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|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|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}}
|
| Allows the creation of metal furniture 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}}
|
| Random [[finished goods|crafts]] made from this material cannot be made into rings, crowns, scepters or figurines. Given to [[plant fiber]], [[silk]] and [[wool]].

|-
| {{text_anchor|ITEMS_HARD}}
|
| 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.

|-
| {{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.{{verify}}
|}

==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_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]]
* [[Tissue definition token]]
* [[Syndrome]]

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

v0.34:Material definition token

2026-04-04T01:10:22Z

Quietust:

{{quality|Exceptional|18:11, 28 April 2011 (UTC)}}{{av}}

The following tokens can be used in material definitions (whether for inorganics or those within plants and creatures) as well as in material templates.

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

|-
| {{text_anchor|USE_MATERIAL_TEMPLATE}}
|
* <template name>
| Imports the properties of the specified preexisting material template.

|-
| {{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. 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 (no default creature has such an attack, but they can be modded in). 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 (no default creature has such an attack, but they can be modded in). 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 (no default creature has such an attack, but they can be modded in). 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. Does not allow an inferior metal to penetrate superior armor. 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 edged weapons to pierce tissue layers{{verify}}. Defaults to NONE.

|-
| {{text_anchor|LIQUID_DENSITY}}
|
*<density>
| Specifies the density of the material when in liquid form. Defaults to NONE.

|-
| {{text_anchor|MOLAR_MASS}}
|
*<value>
| Supposedly not used{{verify}}. Theoretically, should determine density (at given pressure) in gas state, on which in turn would depend (together with weight of vaporized material) on the volume covered by spreading vapors. Defaults to NONE.

|-
| {{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|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, 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]].

|-
| {{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>
| [[Soap]] has [SOAP_LEVEL:2]. Effects unknown. Defaults to 0.

|-
| {{text_anchor|SYNDROME}}
|
| Begins defining a [[syndrome]] applied by the material. Multiple syndromes can be specified. See [[Syndrome token]].
|}

===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 (which currently does '''not''' include [[elf|Elves]]) 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|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|LEAF_MAT}}
|
| Classifies the material as plant leaf, allowing its storage in food stockpiles under "Leaves".

|-
| {{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|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|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|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}}
|
| Allows the creation of metal furniture 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}}
|
| Random [[finished goods|crafts]] made from this material cannot be made into rings, crowns, scepters or figurines. Given to [[plant fiber]], [[silk]] and [[wool]].

|-
| {{text_anchor|ITEMS_HARD}}
|
| 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.

|-
| {{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.{{verify}}
|}

==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_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]]

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

v0.31:Weapon token

2026-04-04T01:04:01Z

Quietust:

{{quality|Exceptional|19:42, 24 August 2010 (UTC)}}{{av}}

These tokens can only be placed within an ITEM_WEAPON object definition.
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|NAME}}
|
*singular
*plural
| Name of the weapon. Required.

|-
| {{text anchor|ADJECTIVE}}
|
*adjective
| Adjective of the weapon, e.g. the "large" in "large copper dagger".

|-
| {{text anchor|SIZE}} / {{text anchor|WEIGHT}}
|
*size
| Volume of weapon in mL or cubic cm. Defaults to 100.

|-
| {{text anchor|SHOOT_FORCE}}
|
*value
| The amount of force used when firing projectiles - velocity is presumably determined by the projectile's mass. Defaults to 0.

|-
| {{text anchor|SHOOT_MAXVEL}}
|
*value
| The maximum speed a fired projectile can have.

|-
| {{text anchor|SKILL}}
|
*[[Skill token]]
| The skill to determine effectiveness in melee with this weapon. Defaults to MACE. Skill of AXE will allow it to be used to chop down trees.

|-
| {{text anchor|RANGED}}
|
*[[Skill token]]
*Ammo class
| Makes this a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.

|-
| {{text anchor|TWO_HANDED}}
|
*size
| Creatures under this size (in cm^3) must use the weapon two-handed. Defaults to 50000.

|-
| {{text anchor|MINIMUM_SIZE}}
|
*size
| Minimum body size (in cm^3) to use the weapon at all (multigrasp required until TWO_HANDED value). Defaults to 40000.

|-
| {{text anchor|CAN_STONE}}
|
| Allows the weapon to be made at a [[craftsdwarf's workshop]] from a sharp ([MAX_EDGE:10000] or higher) stone (e.g. [[obsidian]]) plus a wood log.

|-
| {{text anchor|TRAINING}}
|
| Restricts this weapon to being made of wood.

|-
| {{text anchor|MATERIAL_SIZE}}
|
*value
| Number of bar units needed for forging. Due to a bug, this does not actually work properly. Required.

|-
| {{text anchor|ATTACK}}
|
*attacktype:BLUNT or EDGE
*contact_area:value
*penetration_size:value
*verb2nd:string
*verb3rd:string
*noun:string
*velocity_multiplier:value
| You can have many ATTACK tags and one will be randomly selected for each attack, with EDGE attacks 100 times more common than BLUNT attacks. Contact area is usually high for slashing and low for bludgeoning, piercing, and poking. Penetration value tends to be low for slashing and high for stabbing. Penetration is ignored if attack is BLUNT. Required.

|}

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

v0.34:Weapon token

2026-04-04T01:02:56Z

Quietust: get rid of this

{{quality|Exceptional|19:42, 24 August 2010 (UTC)}}{{av}}

These tokens can only be placed within an ITEM_WEAPON object definition.
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|NAME}}
|
*singular
*plural
| Name of the weapon. Required.

|-
| {{text anchor|ADJECTIVE}}
|
*adjective
| Adjective of the weapon, e.g. the "large" in "large copper dagger".

|-
| {{text anchor|SIZE}} / {{text anchor|WEIGHT}}
|
*size
| Volume of weapon in mL or cubic cm. Defaults to 100.

|-
| {{text anchor|SHOOT_FORCE}}
|
*value
| The amount of force used when firing projectiles - velocity is presumably determined by the projectile's mass. Defaults to 0.

|-
| {{text anchor|SHOOT_MAXVEL}}
|
*value
| The maximum speed a fired projectile can have.

|-
| {{text anchor|SKILL}}
|
*[[Skill token]]
| The skill to determine effectiveness in melee with this weapon. Defaults to MACE. Skill of AXE will allow it to be used to chop down trees.

|-
| {{text anchor|RANGED}}
|
*[[Skill token]]
*Ammo class
| Makes this a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.

|-
| {{text anchor|TWO_HANDED}}
|
*size
| Creatures under this size (in cm^3) must use the weapon two-handed. Defaults to 50000.

|-
| {{text anchor|MINIMUM_SIZE}}
|
*size
| Minimum body size (in cm^3) to use the weapon at all (multigrasp required until TWO_HANDED value). Defaults to 40000.

|-
| {{text anchor|CAN_STONE}}
|
| Allows the weapon to be made at a [[craftsdwarf's workshop]] from a sharp ([MAX_EDGE:10000] or higher) stone (e.g. [[obsidian]]) plus a wood log.

|-
| {{text anchor|TRAINING}}
|
| Restricts this weapon to being made of wood.

|-
| {{text anchor|MATERIAL_SIZE}}
|
*value
| Number of bar units needed for forging, as well as the amount gained from melting. Required.

|-
| {{text anchor|ATTACK}}
|
*attacktype:BLUNT or EDGE
*contact_area:value
*penetration_size:value
*verb2nd:string
*verb3rd:string
*noun:string
*velocity_multiplier:value
| You can have many ATTACK tags and one will be randomly selected for each attack, with EDGE attacks 100 times more common than BLUNT attacks. Contact area is usually high for slashing and low for bludgeoning, piercing, and poking. Penetration value tends to be low for slashing and high for stabbing. Penetration is ignored if attack is BLUNT. Required.

|}

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

v0.31:Trap component token

2026-04-04T01:02:17Z

Quietust:

{{quality|Exceptional|18:26, 28 April 2011 (UTC)}}{{av}}

For use on trap components.

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

|-
| {{text anchor|NAME}}
| singular:plural
| What this item will be called in-game.

|-
| {{text anchor|ADJECTIVE}}
| adjective
| Appears before the name of the weapon's material. E.g. "menacing steel spike"

|-
| {{text anchor|SIZE}} / {{text anchor|WEIGHT}}
| value
| How large the item is. Defaults to 100.

|-
| {{text anchor|HITS}}
| value
| Number of times it hits. Defaults to 1

|-
| {{text anchor|MATERIAL_SIZE}}
| value
| How much material is needed to make the item. Is most important with bars. The number of bars needed is the value divided by three. Required.

|-
| {{text anchor|IS_SCREW}}
|
| Weapon may be installed in a screw pump.

|-
| {{text anchor|IS_SPIKE}}
|
| Weapon may be installed in a spike trap.

|-
| {{text anchor|WOOD}}
|
| Weapon may be made out of wood.

|-
| {{text anchor|METAL}}
|
| Weapon may be made out of metal.

|-
| {{text anchor|ATTACK}}
|
* attacktype:EDGE (or BLUNT?)
* contact_area:value
* penetration_size:value
* verb2nd:string
* verb3rd:string
* noun:string
* velocity_multiplier:value
| Sets the attack characteristics of the weapon
|}

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

v0.34:Trap component token

2026-04-04T01:02:01Z

Quietust:

v0.31:Tool token

2026-04-04T01:01:25Z

Quietust:

{{quality|Exceptional|21:46, 21 November 2010 (UTC)}}{{av}}

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

|-
| {{text anchor|NAME}}
|
*singular
*plural
| Name of the tool. Required.

|-
| {{text anchor|HARD_MAT}}
|
| Permits the tool to be made from anything with the [ITEMS_HARD] token, such as wood, stone or metal.

|-
| {{text anchor|METAL_MAT}}
|
| Permits the tool to be made from anything with the [IS_METAL] token.

|-
| {{text anchor|METAL_WEAPON_MAT}}
|
| Permits the tool to be made from any metal with the [ITEMS_WEAPON] token.

|-
| {{text anchor|UNIMPROVABLE}}
|
| Prevents the tool from being improved. Used on honeycombs.

|-
| {{text anchor|VALUE}}
|
*num
| Defines the item value of the tool. Required.

|-
| {{text anchor|TILE}}
|
*num
| Defines the tile used to represent the tool. Required.

|-
| {{text anchor|TOOL_USE}}
|
*tool use, see below
| Defines the task performed using the tool.

|-
| {{text anchor|ADJECTIVE}}
|
*adjective
| Adjective preceding the material name (e.g. "large copper dagger")

|-
| {{text anchor|SIZE}} // {{text anchor|WEIGHT}}
|
*size
| Volume of tool in mL or cubic centimeters. Required.

|-
| {{text anchor|CONTAINER_CAPACITY}}
|
*amount
| How much the item can contain. Defaults to 0.

|-
| {{text anchor|SHOOT_FORCE}}
|
*value
| Required for weapons.

|-
| {{text anchor|SHOOT_MAXVEL}}
|
*value
| Required for weapons.

|-
| {{text anchor|SKILL}}
|
*Skill token
| The skill to determine effectiveness in melee with this tool. Required for weapons.

|-
| {{text anchor|RANGED}}
|
*Skill token
*Ammo item token
| Makes this tool a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.

|-
| {{text anchor|TWO_HANDED}}
|
*size
| Creatures under this size (in cm^3) must use the tool two-handed. Required for weapons.

|-
| {{text anchor|MINIMUM_SIZE}}
|
*size
| Minimum body size (in cm^3) to use the tool at all (multigrasp required until TWO_HANDED value) Required for weapons.

|-
| {{text anchor|MATERIAL_SIZE}}
|
*value
| Intended to specify number of bar units needed for forging. Does '''not''' work due to a bug.

|-
| {{text anchor|ATTACK}}
|
*attacktype:BLUNT or EDGE
*contact_area:value
*penetration_size:value
*verb2nd:string
*verb3rd:string
*noun:string
*velocity_multiplier:value
| You can have many ATTACK tags and one will be randomly selected for each attack, with EDGE attacks 100 times more common than BLUNT attacks. Required for weapons.
|}

Valid tool uses (and the default tools used for these tasks) are as follows:
{| class="wikitable sortable"
|- bgcolor="#999999"
! ID
! Token
! Usage
|-
| 0 || LIQUID_COOKING || cauldron || adventure mode decoration / weapon
|-
| 1 || LIQUID_SCOOP || ladle || adventure mode decoration / weapon
|-
| 2 || GRIND_POWDER_RECEPTACLE || mortar || adventure mode decoration / weapon
|-
| 3 || GRIND_POWDER_GRINDER || pestle || adventure mode decoration / weapon
|-
| 4 || MEAT_CARVING || carving knife || adventure mode decoration / weapon
|-
| 5 || MEAT_BONING || boning knife || adventure mode decoration / weapon
|-
| 6 || MEAT_SLICING || slicing knife || adventure mode decoration / weapon
|-
| 7 || MEAT_CLEAVING || meat cleaver || adventure mode decoration / weapon
|-
| 8 || HOLD_MEAT_FOR_CARVING || carving fork || adventure mode decoration / weapon
|-
| 9 || MEAL_CONTAINER || bowl || adventure mode decoration / weapon
|-
| 10 || LIQUID_CONTAINER || [[jug]] || can store honey or oil
|-
| 11 || FOOD_STORAGE || [[large pot]] || can store beer
|-
| 12 || HIVE || [[hive]] || can make honey
|-
| 13 || NEST_BOX || [[nest box]] || for your birds to lay eggs
|}

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

v0.34:Tool token

2026-04-04T00:59:07Z

Quietust:

{{quality|Exceptional|21:46, 21 November 2010 (UTC)}}{{av}}

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

|-
| {{text anchor|NAME}}
|
*singular
*plural
| Name of the tool. Required.

|-
| {{text anchor|HARD_MAT}}
|
| Permits the tool to be made from anything with the [ITEMS_HARD] token, such as wood, stone or metal.

|-
| {{text anchor|METAL_MAT}}
|
| Permits the tool to be made from anything with the [IS_METAL] token.

|-
| {{text anchor|METAL_WEAPON_MAT}}
|
| Permits the tool to be made from any metal with the [ITEMS_WEAPON] token.

|-
| {{text anchor|UNIMPROVABLE}}
|
| Prevents the tool from being improved. Used on honeycombs.

|-
| {{text anchor|VALUE}}
|
*num
| Defines the item value of the tool. Required.

|-
| {{text anchor|TILE}}
|
*num
| Defines the tile used to represent the tool. Required.

|-
| {{text anchor|INVERTED_TILE}}
|
| The background of the tile will be colored, instead of the foreground.

|-
| {{text anchor|TOOL_USE}}
|
*tool use, see below
| Defines the task performed using the tool.

|-
| {{text anchor|FURNITURE}}
|
| Allows item to be stored in a furniture stockpile.

|-
| {{text anchor|ADJECTIVE}}
|
*adjective
| Adjective preceding the material name (e.g. "large copper dagger")

|-
| {{text anchor|SIZE}}
|
*size
| Volume of tool in mL or cubic centimeters. Required.

|-
| {{text anchor|CONTAINER_CAPACITY}}
|
*amount
| How much the item can contain. Defaults to 0.

|-
| {{text anchor|SHOOT_FORCE}}
|
*value
| Required for weapons.

|-
| {{text anchor|SHOOT_MAXVEL}}
|
*value
| Required for weapons.

|-
| {{text anchor|SKILL}}
|
*Skill token
| The skill to determine effectiveness in melee with this tool. Required for weapons.

|-
| {{text anchor|RANGED}}
|
*Skill token
*Ammo item token
| Makes this tool a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.

|-
| {{text anchor|TWO_HANDED}}
|
*size
| Creatures under this size (in cm^3) must use the tool two-handed. Required for weapons.

|-
| {{text anchor|MINIMUM_SIZE}}
|
*size
| Minimum body size (in cm^3) to use the tool at all (multigrasp required until TWO_HANDED value) Required for weapons.

|-
| {{text anchor|MATERIAL_SIZE}}
|
*value
| Number of bar units needed for forging, as well as the amount gained from melting. Required for weapons.

|-
| {{text anchor|ATTACK}}
|
*attacktype:BLUNT or EDGE
*contact_area:value
*penetration_size:value
*verb2nd:string
*verb3rd:string
*noun:string
*velocity_multiplier:value
| You can have many ATTACK tags and one will be randomly selected for each attack, with EDGE attacks 100 times more common than BLUNT attacks. Required for weapons.
|}

Valid tool uses (and the default tools used for these tasks) are as follows:
{| class="wikitable sortable"
|- bgcolor="#999999"
! ID
! Token
! Usage
|-
| 0 || LIQUID_COOKING || cauldron || adventure mode decoration / weapon
|-
| 1 || LIQUID_SCOOP || ladle || adventure mode decoration / weapon
|-
| 2 || GRIND_POWDER_RECEPTACLE || mortar || adventure mode decoration / weapon
|-
| 3 || GRIND_POWDER_GRINDER || pestle || adventure mode decoration / weapon
|-
| 4 || MEAT_CARVING || carving knife || adventure mode decoration / weapon
|-
| 5 || MEAT_BONING || boning knife || adventure mode decoration / weapon
|-
| 6 || MEAT_SLICING || slicing knife || adventure mode decoration / weapon
|-
| 7 || MEAT_CLEAVING || meat cleaver || adventure mode decoration / weapon
|-
| 8 || HOLD_MEAT_FOR_CARVING || carving fork || adventure mode decoration / weapon
|-
| 9 || MEAL_CONTAINER || bowl || adventure mode decoration / weapon
|-
| 10 || LIQUID_CONTAINER || [[jug]] || can store honey or oil
|-
| 11 || FOOD_STORAGE || [[large pot]] || can store beer
|-
| 12 || HIVE || [[hive]] || can make honey
|-
| 13 || NEST_BOX || [[nest box]] || for your birds to lay eggs
|-
| 14 || SMALL_OBJECT_STORAGE || [[pouch]] || adventure mode coin purse
|-
| 15 || TRACK_CART || [[minecart]] || item hauling / weapon
|-
| 16 || HEAVY_OBJECT_HAULING || [[wheelbarrow]] || allows hauling items faster
|}

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

v0.31:Armor token

2026-04-04T00:53:54Z

Quietust:

{{Quality|Exceptional|08:43, 9 June 2010 (UTC)}}{{av}}

The tokens for all types of [[armor]] on all slots, including [[shield]]s. Usage column gives information on what types of '''armor''' the token might be restricted to.

These tokens can only be placed within an ITEM_ARMOR, ITEM_GLOVES, ITEM_SHOES, ITEM_SHIELD, ITEM_HELM, or ITEM_PANTS object definition, most do not function in weapon objects.

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

|-
| {{text anchor|NAME}}
| singular:plural
| {{tc|red|Required}}
| What this item will be called ingame.

|-
| {{text anchor|PREPLURAL}}
| <phrase> of
| ITEM_ARMOR ITEM_PANTS
| Changes the plural form of this item to "<phrase of> item". Primarily pertains to the stock screens. Example, "suits of" platemail, "pairs of" trousers, etc.

|-
| {{text anchor|MATERIAL_PLACEHOLDER}}
| adjective
| ITEM_ARMOR ITEM_PANTS
| If the item has no material associated with it (e.g. stockpile menus and trade negotiations), this will be displayed in its place. Used for leather armor.

|-
| {{text anchor|VALUE}}
|
|
| Unused. Defaults to -1.

|-
| {{text anchor|ARMORLEVEL}}
|
0 - clothing 
1 - leather 
2 - chain 
3 - plate
| All garments and shields
| The garment's general purpose. Defaults to 1 for shields, 0 for everything else. Class 0 items are claimed and used by civilians as ordinary clothing and are subject to [[wear]].

|-
| {{text anchor|UPSTEP}}
| value, MAX
| ITEM_GLOVES ITEM_SHOES ITEM_SHIELD
| Length of gloves or footwear, counted in [LIMB] body parts towards the torso. A value of 1 lets gloves cover the lower arms, a value of 2 stretches a boot all the way over the upper leg and so on. Regardless of the value, none of these items can ever extend to cover the upper or lower body. Shields also have this token, but it only seems to affect weight.

|-
| {{text anchor|UBSTEP}}
| value, MAX
| ITEM_ARMOR
| Length of the sleeves, counted in [LIMB] body parts towards the hands. A value of 0 only protects both halves of the torso, 1 extends over the upper arms and so on. Regardless of the value, body armor can never extend to cover the hands or head.

Currently bugged{{bug|1821}}, high values of UBSTEP will result in the item protecting facial features, fingers, and toes, while leaving those parts that it can not protect unprotected (but still counting them as steps).

|-
| {{text anchor|LBSTEP}}
| value or MAX
| ITEM_ARMOR ITEM_PANTS
| Length of the legs/hem, counted in [LIMB] body parts towards the feet. A value of 0 only covers the lower body, 1 extends over the upper legs and so on. Regardless of the value, body armor or pants can never extend to cover the feet.

|-
| {{text anchor|METAL_ARMOR_LEVELS}}
|
| All garments
| Metal versions of this item count as one ARMORLEVEL higher and thus won't be worn by random peasants.

|-
| {{text anchor|BLOCKCHANCE}}
| value
| ITEM_SHIELD
| Affects the block chance of the shield. Defaults to 10.

|-
| {{text anchor|MATERIAL_SIZE}}
| value
| {{tc|red|Required}}
| How much material is needed to make the item. Most important with bars. The number of bars required to make the item is the value divided by three.

|-
| {{text anchor|SOFT}}
|
| All garments
| Clothiers can make this item from all kinds of cloth. If paired with [LEATHER], the item has an equal chance of being either in randomly generated outfits. Further uses of this tag are unknown.

|-
| {{text anchor|HARD}}
|
| All garments
| Default state in the absence of a [SOFT] token. Actual effects unknown.

|-
| {{text anchor|METAL}}
|
| All garments
| Item can be made from metal. Overrides [SOFT] and [LEATHER] in randomly generated outfits, if the ARMORLEVEL permits. Civilizations with [[Entity_token#WOOD_ARMOR|[WOOD_ARMOR]]] will make this item out of wood instead.

|-
| {{text anchor|BARRED}}
|
| All garments
| Craftsmen can make this item from bones. Randomly generated outfits don't include bone armor.

|-
| {{text anchor|SCALED}}
|
| All garments
| Craftsmen can make this item from shells. Randomly generated outfits don't include shell armor.

|-
| {{text anchor|LEATHER}}
|
| All garments
| Leatherworkers can make this item from leather. If paired with [SOFT], this item has an equal chance of being either in randomly generated outfits.

|-
| {{text anchor|SHAPED}}
|
| All garments
| Only one shaped piece of clothing can be worn on a single body slot at a time.

|-
| {{text anchor|CHAIN_METAL_TEXT}}
|
| All garments
| Metal versions of this item will have "chain" added between the material and item name.

|-
| {{text anchor|STRUCTURAL_ELASTICITY_WOVEN_THREAD}}
|
| All garments
| Reduces the armor material's SHEAR_YIELD to 20000, SHEAR_FRACTURE to 30000 and increases the *_STRAIN_AT_YIELD properties to 50000, but only if the garment is made from cloth. This makes the item very weak against edged attacks, even if the thread material is normally very strong.

|-
| {{text anchor|STRUCTURAL_ELASTICITY_CHAIN_METAL}}
|
| All garments
| Increases the *_STRAIN_AT_YIELD properties of the armor's material to 50000, but only if the garment is made from metal.

|-
| {{text anchor|STRUCTURAL_ELASTICITY_CHAIN_ALL}}
|
| All garments
| Increases the *_STRAIN_AT_YIELD properties of the armor's material to 50000, if lower. This makes the garment flex and give way instead of shattering under force. Strong materials that resist cutting will blunt edged attacks into bone-crushing hits instead.

|-
| {{text anchor|LAYER_SIZE}}
| value
| All garments
| The item's bulkiness when worn. Aside from the layer limitations, it's a big contributor to the thickness and weight (and therefore price) of the garment. See [[Armor]] for more on item sizes and layering. Defaults to 10.

|-
| {{text anchor|LAYER_PERMIT}}
| value
| All garments
| The maximum amount of crap that can fit underneath the garment. See [[Armor]] for more on item sizes and layering. Defaults to 10.

|-
| {{text anchor|LAYER}}
| UNDER OVER ARMOR COVER
| All garments
| Where the item goes in relation to other clothes. Socks cannot be worn on top of boots!
The LAYER_PERMIT of the highest layer is used on a given section of the body - you can fit a lot of shirts and other undergarments underneath a robe, but not if you wear a leather jerkin on top of it, and you can still wear a cloak over the whole ensemble. Defaults to UNDER.

|-
| {{text anchor|COVERAGE}}
| % value
| All garments
| How often the garment gets in the way of a contaminant or an attack. Armor with a 5% coverage value, for example, will be near useless because 95% of attacks will bypass it completely. Temperature effects and armor thickness are also influenced. Defaults to 100.

|}

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

v0.31:Ammo token

2026-04-04T00:49:15Z

Quietust:

{{Quality|Superior|02:31, 18 April 2013 (UTC)}}{{av}}

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

|-
| {{text anchor|NAME}}
| singular:plural
| What this item will be called ingame.

|-
| {{text anchor|CLASS}}
| anything
| This ammo can be fired from a weapon that is set to fire the same ammo type as this. Defaults to BOLT.

|-
| {{text anchor|SIZE}} / {{text anchor|WEIGHT}}
| value
| How large the ammunition is. Required.

|-
| {{text anchor|ATTACK}}
|
*attacktype:BLUNT or EDGE
*contact_area:value
*penetration_size:value
*verb2nd:string
*verb3rd:string
*noun:string
*velocity_multiplier:value
| Specifies the attack characteristics of the ammunition.
|}

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

v0.31:Descriptor pattern token

2026-04-04T00:48:06Z

Quietust: Created page with "{{Quality|Superior|18:45, 10 February 2022 (UTC)}}{{av}} Tokens used to define descriptor patterns, that may be used instead of descriptor colors. As a..."

{{Quality|Superior|18:45, 10 February 2022 (UTC)}}{{av}}

Tokens used to define descriptor patterns, that may be used instead of [[Color#Color_tokens|descriptor colors]]. As an example, the descriptor pattern STRIPES_ORANGE_BLACK is what gives tigers their stripes.
{{clear}}

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

|-
| {{text anchor|PATTERN}}
| SPOTS, STRIPES, MOTTLED, IRIS_EYE or PUPIL_EYE
| {{tc|red|Required}}
| The type of pattern, deciding the description.
* SPOTS: Causes a crash if no CP_COLOR is given{{bug|11806}}, otherwise takes any amount.
* STRIPES: Takes any amount of CP_COLOR tokens.
* IRIS_EYE: Only shows the third CP_COLOR given; technically takes any amount. Causes a crash if no CP_COLOR is given{{bug|11806}}. If only one or two CP_COLORs is given, the tissue is described as being "transparent".
* PUPIL_EYE: Only shows the second CP_COLOR given; technically takes any amount. Causes a crash if no CP_COLOR is given{{bug|11806}}. If only one CP_COLORs is given, the tissue is described as being "transparent".
An undefined pattern type causes the description to simply not show up.

|-
| {{text anchor|CP_COLOR}}
| [[Color#Color_tokens|color token]]
| {{tc|red|Required (mostly)}}
| A color to be used in the pattern. See [[Descriptor_pattern_token#PATTERN|PATTERN]] for how many CP_COLOR tokens are needed, and how they are used. [[descriptor color token|Modded color tokens]] may be used.
|}

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Descriptor pattern token]]

v0.34:Descriptor pattern token

2026-04-04T00:47:59Z

Quietust:

{{Quality|Superior|18:45, 10 February 2022 (UTC)}}{{av}}

Tokens used to define descriptor patterns, that may be used instead of [[Color#Color_tokens|descriptor colors]]. As an example, the descriptor pattern STRIPES_ORANGE_BLACK is what gives tigers their stripes.
{{clear}}

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

|-
| {{text anchor|PATTERN}}
| SPOTS, STRIPES, MOTTLED, IRIS_EYE or PUPIL_EYE
| {{tc|red|Required}}
| The type of pattern, deciding the description.
* SPOTS: Causes a crash if no CP_COLOR is given{{bug|11806}}, otherwise takes any amount.
* STRIPES: Takes any amount of CP_COLOR tokens.
* MOTTLED: Takes any amount of CP_COLOR tokens.
* IRIS_EYE: Only shows the third CP_COLOR given; technically takes any amount. Causes a crash if no CP_COLOR is given{{bug|11806}}. If only one or two CP_COLORs is given, the tissue is described as being "transparent".
* PUPIL_EYE: Only shows the second CP_COLOR given; technically takes any amount. Causes a crash if no CP_COLOR is given{{bug|11806}}. If only one CP_COLORs is given, the tissue is described as being "transparent".
An undefined pattern type causes the description to simply not show up.

|-
| {{text anchor|CP_COLOR}}
| [[Color#Color_tokens|color token]]
| {{tc|red|Required (mostly)}}
| A color to be used in the pattern. See [[Descriptor_pattern_token#PATTERN|PATTERN]] for how many CP_COLOR tokens are needed, and how they are used. [[descriptor color token|Modded color tokens]] may be used.
|}

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Descriptor pattern token]]

v0.34:Descriptor pattern token

2026-04-04T00:47:51Z

Quietust: Created page with "{{Quality|Superior|18:45, 10 February 2022 (UTC)}} {{av}} {{Modding}} Tokens used to define descriptor patterns, that may be used instead of Color#Color_tokens|descriptor co..."

{{Quality|Superior|18:45, 10 February 2022 (UTC)}}
{{av}}
{{Modding}}
Tokens used to define descriptor patterns, that may be used instead of [[Color#Color_tokens|descriptor colors]]. As an example, the descriptor pattern STRIPES_ORANGE_BLACK is what gives tigers their stripes.
{{clear}}

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

|-
| {{text anchor|PATTERN}}
| SPOTS, STRIPES, MOTTLED, IRIS_EYE or PUPIL_EYE
| {{tc|red|Required}}
| The type of pattern, deciding the description.
* SPOTS: Causes a crash if no CP_COLOR is given{{bug|11806}}, otherwise takes any amount.
* STRIPES: Takes any amount of CP_COLOR tokens.
* MOTTLED: Takes any amount of CP_COLOR tokens.
* IRIS_EYE: Only shows the third CP_COLOR given; technically takes any amount. Causes a crash if no CP_COLOR is given{{bug|11806}}. If only one or two CP_COLORs is given, the tissue is described as being "transparent".
* PUPIL_EYE: Only shows the second CP_COLOR given; technically takes any amount. Causes a crash if no CP_COLOR is given{{bug|11806}}. If only one CP_COLORs is given, the tissue is described as being "transparent".
An undefined pattern type causes the description to simply not show up.

|-
| {{text anchor|CP_COLOR}}
| [[Color#Color_tokens|color token]]
| {{tc|red|Required (mostly)}}
| A color to be used in the pattern. See [[Descriptor_pattern_token#PATTERN|PATTERN]] for how many CP_COLOR tokens are needed, and how they are used. [[descriptor color token|Modded color tokens]] may be used.
|}

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Descriptor pattern token]]

v0.31:Creature variation token

2026-04-04T00:46:05Z

Quietust:

{{av}}
Creature variations are used to create creatures which are derived from another already-existing creature without having to duplicate every single token. They are defined as CREATURE_VARIATION objects, and the default variations are defined in c_variation_default.txt

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

|-
| {{text anchor|CV_NEW_TAG}}
|
*token (plus any additional parameters)
| Adds a new token to the creature's variant.

|-
| {{text anchor|CV_ADD_TAG}}
|
*token
| Alias for CV_NEW_TAG

|-
| {{text anchor|CV_REMOVE_TAG}}
|
*token
| Removes a token from the creature's variant.

|-
| {{text anchor|CV_CONVERT_TAG}}
|
| Begins altering tokens within the creature's variant using the CVCT_MASTER, CVCT_TARGET, and CVCT_REPLACEMENT tokens below. If a variation template contains multiple CV_CONVERT_TAG blocks for the same CVCT_MASTER, the replacements will be applied [http://bay12games.com/dwarves/mantisbt/view.php?id=6393#c24231 in reverse order].

|-
| {{text anchor|CVCT_MASTER}}
|
*token
| Specifies the token that will be modified.

|-
| {{text anchor|CVCT_TARGET}}
|
*value
| Locates the specified parameter within the token specified by CVCT_MASTER.

|-
| {{text anchor|CVCT_REPLACEMENT}}
|
*value
| Replaces the parameter specified by CVCT_TARGET within the token specified by CVCT_MASTER. If no replacement is specified, the target will simply be removed.
|}

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

v0.31:Body detail plan token

2026-04-04T00:44:56Z

Quietust:

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

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

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

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

|-
| {{text anchor|BODY_DETAIL_PLAN}}
|
| Begins defining a body detail plan for use in creature raws

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

|-
| {{text anchor|BP_LAYERS_OVER}}
|
| Works like BP_LAYERS, but defines layers over existing layers.

|-
| {{text anchor|BP_LAYERS_UNDER}}
|
| Works like BP_LAYERS, but defines layers under existing layers.

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

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

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

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

v0.34:Body detail plan token

2026-04-04T00:44:21Z

Quietust:

40d:Body token

2026-04-04T00:43:51Z

Quietust: /* Body Parts */

{{quality|Exceptional|21:17, 30 March 2011 (UTC)}}{{av}}
{{Category|Modding}}

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

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

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

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

== Convention ==

The convention in the unmodded raw object data in Dwarf Fortress is to make the centre of mass the core of the creature. All other body parts then attach to this central mass, or to those body parts that attach to this central mass. Creating chains of attachments in this fashion produces limbs. If a part is listed before a part that it is attached to is, this can create strange bugs, such as the creatures instantly suffocating.

While it is possible to use the CON token to connect to a specific body part ID even if it is in another template, it is convention within the default raw object data to use a CONTYPE if the connected part is in another template, for safety. Otherwise, a creature must have both templates within its BODY token to prevent unpredictable behaviour when the creature is used during world generation or simulated during gameplay.

==Basic Syntax==

filename

[OBJECT:BODY]

[BODY:TEMPLATE1]
[BP:CORE][UPPERBODY][...]
[BP:PART1][CONTYPE:UPPERBODY][...]
[BP:PART2][CON:CORE][...]

[BODYGLOSS:FOOBAR:foo:bar]

==Body==

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

|-
| BODY
|
* id
| The name of the body template. Each BP token underneath a given Body Token BODY template is added to a creature when the Creature Token BODY specifies this ID.

|-
| BODYGLOSS
|
* id
* match
* replacement
| Replaces all occurrences of "match" in the creature's body parts with "replacement". E.g., the Body Token [BODYGLOSS:TENTACLE:leg:tentacle], used by the Creature Token [BODYGLOSS:TENTACLE], will cause any "right leg" to appear as "right tentacle". Testing required: would "brain legend" appear as "brain tentacleend"?{{verify}}

|-
|}

==Body Parts==

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

|-
| {{text anchor|BP}}
|
* id
* name
| The internal object ID of the body part. Unlike many other tokens in the game, the id of the BP does not need to be unique throughout all of the raw object files, though it does need to be unique within the BODY it is in, as well as within the set of body templates used by any given creature.

|-
| {{text anchor|UPPERBODY}}
|
| The body part is the "core" of the creature; when the upperbody body part is destroyed, the creature is blown apart.
A creature doesn't die until an UPPERBODY, HEAD, or LOWERBODY is destroyed, so a creature without one or all of these
can't be killed*. UPPERBODYs aren't redundant, once one is destroyed the creature dies. Body parts with [CONTYPE:UPPERBODY] will be connected to these.
*most creatures can also be killed indirectly by suffocation or blood loss. (or brain damage?).

|-
| {{text anchor|LOWERBODY}}
|
| The body part is another part of the "core" of the creature. When the lowerbody body part is destroyed, the creature is bisected. A creature doesn't die until an UPPERBODY, HEAD, or LOWERBODY is destroyed, so a creature without one or all of these can't be killed*. LOWERBODYs aren't redundant, once one is destroyed the creature dies. Body parts with [CONTYPE:LOWERBODY] will be connected to these.
*most creatures can also be killed indirectly by suffocation or blood loss. (or brain damage?).

|-
| {{text anchor|HEAD}}
|
| Vital bodypart. If severed, creature dies. A creature doesn't die until an UPPERBODY, HEAD, or LOWERBODY is destroyed, so a creature without one or all of these can't be killed*. HEADs aren't redundant, once one is destroyed the creature dies. Body parts with [CONTYPE:HEAD] will be connected to these.
*most creatures can also be killed indirectly by suffocation or blood loss. (or brain damage?).

|-
| {{text anchor|CON}}
|
* id
| The specific body part ''object ID'' to which this body part attaches. This tag is optional. Interesting effects can be created by leaving unconnected body parts. If an invalid ID is given, the body part is unconnected. This can lead to interesting bugs.

|-
| {{text anchor|CONTYPE}}
|
* type
| The body part ''token type'' to which this body part attaches - valid values are UPPERBODY, LOWERBODY, HEAD, GRASP, and STANCE. Note that if the creature has more than one body part with that token type each of them will get its own additional body part attached. For example, if a creature has two upper bodies (two torsos) and a lower body, the CONTYPE:UPPERBODY means that the two upper torsos are connected to the lower torso by default. This tag is optional. Interesting effects can be created by leaving unconnected body parts.

|-
| {{text anchor|LIMB}}
|
| The body part is usable for [[wrestling]] (i.e. can grab, lock, choke, etc.).

|-
| {{text anchor|THROAT}}
|
| Can be strangled with [[wrestling]] to cause winding, unconsciousness, and eventual death. Strangely, even creatures with the NOBREATHE token can be rendered unconscious (but not dead) by strangulation.

|-
| {{text anchor|JOINT}}
|
| Can be broken by [[wrestling]].

|-
| {{text anchor|SKELETON}}
|
| Prevents game code from removing this bodypart when the creature is converted to skeletal undead.

|-
| {{text anchor|THOUGHT}}
|
| Necessary for the creature to think. Without a working brain, the creature dies unless it has the NOTHOUGHT Creature Token. Also seems to apply the effects of NERVOUS.

|-
| {{text anchor|NERVOUS}}
|
| Causes pain when destroyed and appears to stop a part from healing over time. However, it will heal normally if creature is NOTHOUGHT. Other effects?

|-
| {{text anchor|GRASP}}
|
| The body part can be used to hold items (if the creature has the EQUIPS token) or [[wrestling|wrestle]]. Body parts with [CONTYPE:GRASP] will be connected to these.

|-
| {{text anchor|FLIER}}
|
| The body part is necessary for the creature to fly, and damage to the body part will ground the creature.

|-
| {{text anchor|STANCE}}
|
| The body part is used to keep the creature standing; injury to the body part will cause the creature to collapse. It also makes the body part act like a foot, and can be problematic as the body part can be armored by a boot. STANCE body parts that are unconnected to the root (have no CON tag) do not count towards keeping the creature standing (NOTE: if '''any''' [STANCE] body parts are unconnected to root, the creature may fall over. Further testing required). Body parts with [CONTYPE:STANCE] will be connected to these.

|-
| {{text anchor|SIGHT}}
|
| Allows creatures to see; creatures without this tag on any part of their bodies cannot see for the purposes of aiming missile weapons (though apparently can find and kill mad adventurers fairly well with melee attacks). May need more testing.

|-
| {{text anchor|HEAR}}
|
| Unknown effect. Presumably allows the creature to listen. Also makes earrings equippable.

|-
| {{text anchor|SMELL}}
|
| Unknown effect. Presumably allows creature to smell.

|-
| {{text anchor|EMBEDDED}}
|
| The body part is embedded into the body -- it is external and can be gouged out. This does not make a part invisible.

|-
| {{text anchor|APERTURE}}
|
| An opening in the body. Cannot be destroyed except by destroying the part is attached to.

|-
| {{text anchor|SMALL}}
|
| Unknown effect. Reduces chance to hit? Also will cloak body parts much like the [INTERNAL] or the [EMBEDDED] tags will. Allows body parts to be pinched. In 40d it appears that body parts are visible unless [SMALL], even if they are [INTERNAL] or [EMBEDDED]. If the root (first BP) of the creature is [SMALL], it will not be targeted until all other parts have been severed or torn off.

|-
| {{text anchor|INTERNAL}}
|
| The body part is an internal organ and is not visible until injured. In 40d, it appears that the [SMALL] tag is what actually makes organs invisible, and that non-SMALL internal organs are visible even before being damaged.

|-
| {{text anchor|BREATHE}}
|
| The body part is necessary to breathe. If the body part is destroyed, the creature can suffocate unless it has the NOBREATHE token. The NOBREATHE token also causes the part to heal normally.

|-
| {{text anchor|CIRCULATION}}
|
| If this body part is destroyed, the creature will bleed to death?

|-
| {{text anchor|GUTS}}
|
| To be thought of like intestines. Can be disemboweled, causing a slow painful death from heavy bleeding.

|-
| {{text anchor|RIGHT}}
|
| The body part is on the right side of the creature and is thus vulnerable to attacks from the right side.

|-
| {{text anchor|LEFT}}
|
| The body part is on the left side of the creature and is thus vulnerable to attacks from the left side.

|-
| {{text anchor|DIGIT}}
|
| Is a finger/toe. Unknown effect. DIGITs '''may''' only be damaged when their connected body part is damaged, they do not appear to be valid targets for damage otherwise.

|-
| {{text anchor|MOUTH}}
|
| Unknown effect. Does not allow creature to eat. Often tied to a creature's attacks, so this may be the primary use of the tag.
|}

==Body Part Types==

Legal token types for use with the Attack Token "BYTYPE" argument:

* APERTURE
* BREATHE
* CIRCULATION
* DIGIT
* FLIER
* GRASP
* GUTS
* HEAD
* HEAR
* JOINT
* LIMB
* LOWERBODY
* MOUTH
* NERVOUS
* SMELL
* STANCE
* THOUGHT
* UPPERBODY

==Example==

An [[elephant]] is composed of a large number of body parts, but only includes a small list of templates. When an elephant asks for the following 15 templates in its CREATURE:ELEPHANT token:
[BODY:QUADRUPED:TAIL:2EYES:2EARS:TRUNK:2LUNGS:HEART:GUTS:ORGANS:THROAT:NECK:SPINE:BRAIN:MOUTH:2TUSKS]

...it gets all of the following 35 body parts:

QUADRUPED:
- upper body
- lower body
- head
- right front leg
- left front leg
- right front foot
- left front foot
- right rear leg
- left rear leg
- right rear foot
- left rear foot
TAIL:
- tail
2EYES:
- right eye
- left eye
2EARS:
- right ear
- left ear
TRUNK:
- trunk
2LUNGS:
- right lung
- left lung
HEART:
- heart
GUTS:
- guts
ORGANS:
- liver
- stomach
- pancreas
- spleen
- right kidney
- left kidney
THROAT:
- throat
NECK:
- neck
SPINE:
- upper spine
- lower spine
BRAIN:
- brain
MOUTH:
- mouth
2TUSKS:
- right tusk
- left tusk

The body part tree of the elephant, after connections are made, is as follows:

+ upper body
- heart
- upper spine
- right lung
- left lung
+ head
- brain
- mouth
- trunk
- right tusk
- left tusk
- right eye
- left eye
- right ear
- left ear
- neck
- throat
+ right front leg
- right front foot
+ left front leg
- left front foot
+ lower body
- lower spine
- guts
- tail
- liver
- stomach
- pancreas
- spleen
- right kidney
- left kidney
+ right rear leg
- right rear foot
+ left rear leg
- left rear foot

To understand how the above connections are determined (for example, why "lower spine" knows that it goes in "lower body", why "heart" knows that it goes in "upper body", etc.) refer to the CONTYPE tag.

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

v0.31:Body token

2026-04-04T00:42:30Z

Quietust:

{{quality|Fine|00:14, 23 November 2010 (UTC)}}{{av}}

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

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

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

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

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

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

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

|-
| {{text anchor|LOWERBODY}}
| None
| Flags the body part as being able to wear lower body clothing like skirts, pants, etc. If a lower body is chopped off, the creature dies. Multiple lowerbody parts aren't redundant.

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

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

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

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

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

|-
| {{text anchor|THROAT}}
|
| Body part can be strangled.

|-
| {{text anchor|JOINT}}
|
| Body part is a joint that may be broken by wrestling.

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

|-
| {{text anchor|THOUGHT}}
| None
| Most creatures die if all bodyparts with this tag have sustained damage to a FUNCTIONAL tissue or been outright destroyed (chopped off). Creatures will not die if they have NO_THOUGHT_CENTER_FOR_MOVEMENT (and/or NOTHOUGHT?)

|-
| {{text anchor|NERVOUS}}
|
| Body part is necessary for motor function. Damage will impair movement and also disallow creature from sparring in Fortress mode.

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

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

|-
| {{text anchor|UNDER_PRESSURE}}
| None
| Makes the body part pop out of edge attack wounds. Used on guts. Body part shows up as "~" when spilled/popped out.

|-
| {{text anchor|TOTEMABLE}}
| None
| Makes the body part makeable into totems at a craftsdwarf's workshop.

|-
| {{text anchor|VERMIN_BUTCHER_ITEM}}
| None
| Allows the item to be obtained from butchered or rotted vermin.

|-
| {{text anchor|STANCE}}
|
| Allows the creature to stand. Damage or loss of these body parts will cause creature to fall over.

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

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

|-
| {{text anchor|SMELL}}
| None
| Body part is used to smell. No known function.

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

|-
| {{text anchor|APERTURE}}
|
| Marks body part as an opening in the body. This body part cannot be destroyed except by destroying the part it is attached to.

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

|-
| {{text anchor|INTERNAL}}
|
| Marks the body part as inside the body. Needs [SMALL] tag as well to not be targetable by attacks.

|-
| {{text anchor|BREATHE}}
|
| Body part is used to breathe. If all body parts with [BREATHE] are damaged or destroyed, the creature will suffocate unless it has the NOBREATHE tag in its creature def.

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

|-
| {{text anchor|GUTS}}
| None
| Body parts marked with this tag make the creature nauseous and vomit when hit.

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

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

|-
| {{text anchor|DIGIT}}
|
|

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

|-
| {{text anchor|SOCKET}}
|
| Allows the body part to be easily knocked out. Used on teeth.

|-
| {{text anchor|MOUTH}}
|
|

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

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

|-
| {{text anchor|NUMBER}}
|
*value
| In theory, the number lets you stack identical body parts. These can be individually damaged by wounds, but you don't have to define them explicitly one by one. If you don't give them individual names (see teeth) they'll be preceded by ordinal numbers (first, second, etc).
HOWEVER, this tag appears to be non-functional.

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

|}

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

v0.31:Tissue definition token

2026-04-04T00:39:15Z

Quietust:

{{quality|Fine|21:41, 22 February 2011 (UTC)}}{{av}}

__TOC__

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

|-
| {{text anchor|TISSUE_NAME}}
|
*name
*plural
|plural can alternatively be NP (No Plural) or STP (Standard Plural, adds an 's' on the end).

|-
| {{text anchor|TISSUE_MATERIAL}}
|
* [[material token]]
| Defines the tissue material.

|-
| {{text anchor|RELATIVE_THICKNESS}}
|
*value
| The relative thickness of the tissue. A higher thickness is harder to penetrate, but raising a tissue's relative thickness decreases the thickness of all other tissues.

|-
| {{text anchor|HEALING_RATE}}
|
*value
| Lower is faster. Omitting the token will result in a tissue that never heals.

|-
| {{text anchor|VASCULAR}}
|
*value
| Related to how much said tissue bleeds. Higher = More bleeding (Which is why the heart has the highest value.)

|-
| {{text anchor|PAIN_RECEPTORS}}
|
*value
| Related to how much pain your character will suffer when said tissue is damaged. Higher = More pain when damaged (Which is why the bone tissue has a much higher value than other tissues. A broken bone hurts a lot more than a flesh cut.)

|-
| {{text anchor|THICKENS_ON_STRENGTH}}
|
| The thickness of the tissue increases when character strength increases.

|-
| {{text anchor|THICKENS_ON_ENERGY_STORAGE}}
|
| Thickness of said tissue increases when the character eats and doesn't exercise sufficiently.

|-
| {{text anchor|ARTERIES}}
|
| The tissue contains arteries. Edged attacks have the chance to break an artery, increasing blood loss.

|-
| {{text anchor|SCARS}}
|
| Simply, whether or not the tissue will be scarred once healed.

|-
| {{text anchor|STRUCTURAL}}
|
| Holds the body part together. A cut or a fracture disables the body part it's in.

|-
| {{text anchor|CONNECTIVE_TISSUE_ANCHOR}}
|
| Any ligaments or tendons are part of this tissue. Vulnerable to edged attacks, damage disables the limb.

|-
| {{text anchor|SETTABLE}}
|
| The tissue will not heal, or heals slower, until it is set by a bone doctor.

|-
| {{text anchor|SPLINTABLE}}
|
| The broken tissue can be fixed with a cast or a splint to restore function while it heals.

|-
| {{text anchor|FUNCTIONAL}}
|
| The tissue performs some sort of special function (e.g. sight, hearing, breathing, etc.) An organ with such a function will stop working if a sufficient amount of damage is sustained by its FUNCTIONAL tissues. If an organ has no FUNCTIONAL tissues, it will stop working only if it is severed or destroyed entirely by heat or cold.

|-
| {{text anchor|NERVOUS}}
|
| Nervous function - not used. This token is used in [[Body_token#NERVOUS|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|THOUGHT}}
|
| If a creature has no functioning parts with the THOUGHT token, it will be unable to move or breathe. NO_THOUGHT_CENTER_FOR_MOVEMENT bypasses this limitation.

|-
| {{text anchor|MUSCULAR}}
|
| Seems to affect where sensory or motor nerves are located, and whether damage to this tissue will render a limb useless.

|-
| {{text anchor|SMELL}}
|
| Used to smell - not used. This token is used in [[Body_token#SMELL|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|HEAR}}
|
| Used to hearing - not used. This token is used in [[Body_token#HEAR|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|FLIGHT}}
|
| Unknown - not used. Most likely related to flying, see [[Body_token#FLIER|[FLIER] in [OBJECT:BODY]]].

|-
| {{text anchor|BREATHE}}
|
| Used to breathing - not used. This token is used in [[Body_token#BREATHE|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|SIGHT}}
|
| Used to seeing - not used. This token is used in [[Body_token#SIGHT|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|CONNECTS}}
|
| Holds body parts together. A body part will not be severed unless all of its component tissues with the CONNECTS tag are severed.

|-
| {{text anchor|MAJOR_ARTERIES}}
|
| Causes tissue to sometimes severely bleed when damaged. This is independent of its VASCULAR value.

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

|-
| {{text anchor|COSMETIC}}
|
| ?

|-
| {{text anchor|STYLEABLE}}
|
| The tissue can be styled as per a tissue style (defined in an [[Entity_token|entity]] entry)

|-
| {{text anchor|TISSUE_SHAPE}}
|
*value
| Value can be one of the following:
;LAYER
:Regular layer tissue.
;STRANDS
:Can be spun into thread at a farmer's workshop. Edge attacks will pass right through the tissue.
;FEATHERS
:Edge attacks will pass right through the tissue.
;SCALES
:?
;CUSTOM
:?

|-
| {{text anchor|SUBORDINATE_TO_TISSUE}}
|
*value
| Tissue is implicitly attached to another tissue and will fall off if that tissue layer is destroyed. Used for hair and feathers, which are subordinate to skin.

|-
| {{text anchor|TISSUE_MAT_STATE}}
|
*SOLID, SOLID_POWDER, LIQUID, or GAS 
(possibly others, as well. Needs testing.)
| Sets/forces a default material state for the selected tissue.

|-
| {{text anchor|TISSUE_LEAKS}}
|
| The selected tissue leaks out of the creature when the layers above it are pierced.
|}

== Tissue layer tokens ==

These are used in creature raws to override the above for whatever reason.

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

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

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
|
* value
| Sets a new relative thickness for selected tissue layers.

|-
| {{text anchor|TL_CONNECTS}}
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
|
| Gives Major Artery attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
|
* value
| Sets a new HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
|
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
|
| Sets a new number of pain receptors for selected tissue layers.
|}

==Defaults==
Default values (as of 0.31.21):

{| {{prettytable}} style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 70%;"
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|-
| SKIN_TEMPLATE || skin:NP || LOCAL_CREATURE_MAT:SKIN || || 1 || 100 || 1 || 5 || || || LAYER
|-
| FAT_TEMPLATE || fat:NP || LOCAL_CREATURE_MAT:FAT || || 1 || 100 || 3 || 5 || || 100 || LAYER
|-
| MUSCLE_TEMPLATE || muscle:muscles || LOCAL_CREATURE_MAT:MUSCLE || || 3 || 100 || 5 || 5 || || || LAYER
|-
| BONE_TEMPLATE || bone:NP || LOCAL_CREATURE_MAT:BONE || || 2 || 1000 || 3 || 50 || || || LAYER
|-
| SHELL_TEMPLATE || shell:NP || LOCAL_CREATURE_MAT:SHELL || || 2 || 1000 || || || || || LAYER
|-
| HORN_TEMPLATE || horn:NP || LOCAL_CREATURE_MAT:HORN || || 2 || || || || || || LAYER
|-
| HOOF_TEMPLATE || hoof:NP || LOCAL_CREATURE_MAT:HOOF || || 2 || || || || || || LAYER
|-
| CARTILAGE_TEMPLATE || cartilage:NP || LOCAL_CREATURE_MAT:CARTILAGE || || 2 || || || || || || LAYER
|-
| HAIR_TEMPLATE || hair:NP || LOCAL_CREATURE_MAT:HAIR || || 1 || || || || SKIN || 100 || STRANDS
|-
| CHEEK_WHISKERS_TEMPLATE || cheek whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| CHIN_WHISKERS_TEMPLATE || chin whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| MOUSTACHE_TEMPLATE || moustache:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| SIDEBURNS_TEMPLATE || sideburns:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYEBROW_TEMPLATE || eyebrow:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYELASH_TEMPLATE || eyelash:eyelashes || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| FEATHER_TEMPLATE || feather:STP || LOCAL_CREATURE_MAT:FEATHER || || 2 || || || || SKIN || 100 || FEATHERS
|-
| SCALE_TEMPLATE || scale:STP || LOCAL_CREATURE_MAT:SCALE || || 1 || 100 || 1 || 5 || || || SCALES
|-
| NAIL_TEMPLATE || nail:NP || LOCAL_CREATURE_MAT:NAIL || || 2 || || || || || || LAYER
|-
| CLAW_TEMPLATE || claw:NP || LOCAL_CREATURE_MAT:CLAW || || 2 || || || || || || LAYER
|-
| TALON_TEMPLATE || talon:NP || LOCAL_CREATURE_MAT:TALON || || 2 || || || || || || LAYER
|-
| TOOTH_TEMPLATE || tooth:NP || LOCAL_CREATURE_MAT:TOOTH || || 2 || || || || || || LAYER
|-
| IVORY_TEMPLATE || ivory:NP || LOCAL_CREATURE_MAT:IVORY || || 2 || || || || || || LAYER
|-
| EYE_TEMPLATE || eye tissue:NP || LOCAL_CREATURE_MAT:EYE || || 1 || 100 || 3 || 5 || || || LAYER
|-
| NERVE_TEMPLATE || nervous tissue:NP || LOCAL_CREATURE_MAT:NERVE || || 1 || || 3 || || || || LAYER
|-
| BRAIN_TEMPLATE || brain tissue:NP || LOCAL_CREATURE_MAT:BRAIN || || 1 || || 3 || || || || LAYER
|-
| LUNG_TEMPLATE || lung tissue:NP || LOCAL_CREATURE_MAT:LUNG || || 1 || 100 || 8 || 5 || || || LAYER
|-
| HEART_TEMPLATE || heart tissue:NP || LOCAL_CREATURE_MAT:HEART || || 1 || 100 || 10 || 5 || || || LAYER
|-
| LIVER_TEMPLATE || liver tissue:NP || LOCAL_CREATURE_MAT:LIVER || || 1 || 100 || 8 || 5 || || || LAYER
|-
| GUT_TEMPLATE || gut:NP || LOCAL_CREATURE_MAT:GUT || || 1 || 100 || 3 || 5 || || || LAYER
|-
| STOMACH_TEMPLATE || stomach tissue:NP || LOCAL_CREATURE_MAT:STOMACH || || 1 || 100 || 3 || 5 || || || LAYER
|-
| PANCREAS_TEMPLATE || pancreatic tissue:NP || LOCAL_CREATURE_MAT:PANCREAS || || 1 || 100 || 3 || 5 || || || LAYER
|-
| SPLEEN_TEMPLATE || spleen tissue:NP || LOCAL_CREATURE_MAT:SPLEEN || || 1 || 100 || 5 || 5 || || || LAYER
|-
| KIDNEY_TEMPLATE || kidney tissue:NP || LOCAL_CREATURE_MAT:KIDNEY || || 1 || 100 || 8 || 5 || || || LAYER
|-
| FLAME_TEMPLATE || flames:NP || LOCAL_CREATURE_MAT:FLAME || GAS || 1 || || || || || || LAYER
|-
| CHITIN_TEMPLATE || chitin:NP || LOCAL_CREATURE_MAT:CHITIN || || 1 || 100 || 1 || 5 || || || LAYER
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|}

Default flags (as of 0.31.21):

{| {{prettytable}} style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 70%;"
|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|-
| SKIN_TEMPLATE || || || || X || || || || || X || || || ||
|-
| FAT_TEMPLATE || X || || || X || || || || || X || || || ||
|-
| MUSCLE_TEMPLATE || || X || X || X || X || || || || X || || ||
|-
| BONE_TEMPLATE || || || || || || || X || X || X || X || X || ||
|-
| SHELL_TEMPLATE || || || || || || || X || || X || X || X || ||
|-
| HORN_TEMPLATE || || || || || || || X || || X || || || ||
|-
| HOOF_TEMPLATE || || || || || || || X || || X || || || ||
|-
| CARTILAGE_TEMPLATE || || || || || || || X || || X || || || ||
|-
| HAIR_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHEEK_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHIN_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| MOUSTACHE_TEMPLATE || || || || || || || || || || || || X || X
|-
| SIDEBURNS_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYEBROW_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYELASH_TEMPLATE || || || || || || || || || || || || X || X
|-
| FEATHER_TEMPLATE || || || || || || || || || || || ||
|-
| SCALE_TEMPLATE || || || || X || || || || || X || || || ||
|-
| NAIL_TEMPLATE || || || || || || || X || || X || || || ||
|-
| CLAW_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TALON_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TOOTH_TEMPLATE || || || || || || || X || || X || || || ||
|-
| IVORY_TEMPLATE || || || || || || || X || || X || || || ||
|-
| EYE_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| NERVE_TEMPLATE || || || || X || || X || || || X || || || ||
|-
| BRAIN_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| LUNG_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| HEART_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| LIVER_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| GUT_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| STOMACH_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| PANCREAS_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| SPLEEN_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| KIDNEY_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| FLAME_TEMPLATE || || || || || X || X || X || || X || || || ||
|-
| CHITIN_TEMPLATE || || || || X || || || X || X || X || X || X || ||
|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|}

==See Also==
*[[Material definition token]]

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

v0.34:Tissue definition token

2026-04-04T00:35:37Z

Quietust:

{{quality|Superior}}{{av}}

__TOC__

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

|-
| {{text anchor|TISSUE_NAME}}
|
*name
*plural
|plural can alternatively be NP (No Plural) or STP (Standard Plural, adds an 's' on the end).

|-
| {{text anchor|TISSUE_MATERIAL}}
|
* [[material token]]
| Defines the tissue material.

|-
| {{text anchor|RELATIVE_THICKNESS}}
|
*value
| The relative thickness of the tissue. A higher thickness is harder to penetrate, but raising a tissue's relative thickness decreases the thickness of all other tissues.

|-
| {{text anchor|HEALING_RATE}}
|
*value
| Lower is faster. Omitting the token will result in a tissue that never heals.

|-
| {{text anchor|VASCULAR}}
|
*value
| Related to how much said tissue bleeds. Higher = More bleeding (Which is why the heart has the highest value.)

|-
| {{text anchor|PAIN_RECEPTORS}}
|
*value
| Related to how much pain your character will suffer when said tissue is damaged. Higher = More pain when damaged (Which is why the bone tissue has a much higher value than other tissues. A broken bone hurts a lot more than a flesh cut.)

|-
| {{text anchor|THICKENS_ON_STRENGTH}}
|
| The thickness of the tissue increases when character strength increases.

|-
| {{text anchor|THICKENS_ON_ENERGY_STORAGE}}
|
| Thickness of said tissue increases when the character eats and doesn't exercise sufficiently.

|-
| {{text anchor|ARTERIES}}
|
| The tissue contains arteries. Edged attacks have the chance to break an artery, increasing blood loss.

|-
| {{text anchor|SCARS}}
|
| Simply, whether or not the tissue will be scarred once healed.

|-
| {{text anchor|STRUCTURAL}}
|
| Holds the body part together. A cut or a fracture disables the body part it's in.

|-
| {{text anchor|CONNECTIVE_TISSUE_ANCHOR}}
|
| Any ligaments or tendons are part of this tissue. Vulnerable to edged attacks, damage disables the limb.

|-
| {{text anchor|SETTABLE}}
|
| The tissue will not heal, or heals slower, until it is set by a bone doctor.

|-
| {{text anchor|SPLINTABLE}}
|
| The broken tissue can be fixed with a cast or a splint to restore function while it heals.

|-
| {{text anchor|FUNCTIONAL}}
|
| The tissue performs some sort of special function (e.g. sight, hearing, breathing, etc.) An organ with such a function will stop working if a sufficient amount of damage is sustained by its FUNCTIONAL tissues. If an organ has no FUNCTIONAL tissues, it will stop working only if it is severed or destroyed entirely by heat or cold.

|-
| {{text anchor|NERVOUS}}
|
| Nervous function - not used. This token is used in [[Body_token#NERVOUS|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|THOUGHT}}
|
| If a creature has no functioning parts with the THOUGHT token, it will be unable to move or breathe. NO_THOUGHT_CENTER_FOR_MOVEMENT bypasses this limitation.

|-
| {{text anchor|MUSCULAR}}
|
| Seems to affect where sensory or motor nerves are located, and whether damage to this tissue will render a limb useless.

|-
| {{text anchor|SMELL}}
|
| Used to smell - not used. This token is used in [[Body_token#SMELL|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|HEAR}}
|
| Used to hearing - not used. This token is used in [[Body_token#HEAR|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|FLIGHT}}
|
| Unknown - not used. Most likely related to flying, see [[Body_token#FLIER|[FLIER] in [OBJECT:BODY]]].

|-
| {{text anchor|BREATHE}}
|
| Used to breathing - not used. This token is used in [[Body_token#BREATHE|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|SIGHT}}
|
| Used to seeing - not used. This token is used in [[Body_token#SIGHT|[OBJECT:BODY]]] tokens.

|-
| {{text anchor|CONNECTS}}
|
| Holds body parts together. A body part will not be severed unless all of its component tissues with the CONNECTS tag are severed.

|-
| {{text anchor|MAJOR_ARTERIES}}
|
| Causes tissue to sometimes severely bleed when damaged. This is independent of its VASCULAR value.

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

|-
| {{text anchor|COSMETIC}}
|
| ?

|-
| {{text anchor|STYLEABLE}}
|
| The tissue can be styled as per a tissue style (defined in an [[Entity_token|entity]] entry)

|-
| {{text anchor|TISSUE_SHAPE}}
|
*value
| Value can be one of the following:
;LAYER
:Regular layer tissue.
;STRANDS
:Can be spun into thread at a farmer's workshop. Edge attacks will pass right through the tissue.
;FEATHERS
:Edge attacks will pass right through the tissue.
;SCALES
:?
;CUSTOM
:?

|-
| {{text anchor|SUBORDINATE_TO_TISSUE}}
|
*value
| Tissue is implicitly attached to another tissue and will fall off if that tissue layer is destroyed. Used for hair and feathers, which are subordinate to skin.

|-
| {{text anchor|TISSUE_MAT_STATE}}
|
*SOLID, SOLID_POWDER, LIQUID, or GAS 
(possibly others, as well. Needs testing.)
| Sets/forces a default material state for the selected tissue.

|-
| {{text anchor|TISSUE_LEAKS}}
|
| The selected tissue leaks out of the creature when the layers above it are pierced.
|}

== Tissue layer tokens ==

These are used in creature raws to override the above for whatever reason.

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

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

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
|
* value
| Sets a new relative thickness for selected tissue layers.

|-
| {{text anchor|TL_CONNECTS}}
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
|
| Gives Major Artery attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
|
* value
| Sets a new HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
|
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
|
| Sets a new number of pain receptors for selected tissue layers.
|}

==Defaults==
Default values (as of 0.34.11):

{| {{prettytable}} style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 70%;"
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|-
| SKIN_TEMPLATE || skin:NP || LOCAL_CREATURE_MAT:SKIN || || 1 || 100 || 1 || 5 || || || LAYER
|-
| FAT_TEMPLATE || fat:NP || LOCAL_CREATURE_MAT:FAT || || 1 || 100 || 3 || 5 || || 100 || LAYER
|-
| MUSCLE_TEMPLATE || muscle:muscles || LOCAL_CREATURE_MAT:MUSCLE || || 3 || 100 || 5 || 5 || || || LAYER
|-
| BONE_TEMPLATE || bone:NP || LOCAL_CREATURE_MAT:BONE || || 2 || 1000 || 3 || 50 || || || LAYER
|-
| SHELL_TEMPLATE || shell:NP || LOCAL_CREATURE_MAT:SHELL || || 2 || 1000 || || || || || LAYER
|-
| HORN_TEMPLATE || horn:NP || LOCAL_CREATURE_MAT:HORN || || 2 || || || || || || LAYER
|-
| HOOF_TEMPLATE || hoof:NP || LOCAL_CREATURE_MAT:HOOF || || 2 || || || || || || LAYER
|-
| CARTILAGE_TEMPLATE || cartilage:NP || LOCAL_CREATURE_MAT:CARTILAGE || || 2 || || || || || || LAYER
|-
| HAIR_TEMPLATE || hair:NP || LOCAL_CREATURE_MAT:HAIR || || 1 || || || || SKIN || 100 || STRANDS
|-
| CHEEK_WHISKERS_TEMPLATE || cheek whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| CHIN_WHISKERS_TEMPLATE || chin whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| MOUSTACHE_TEMPLATE || moustache:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| SIDEBURNS_TEMPLATE || sideburns:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYEBROW_TEMPLATE || eyebrow:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYELASH_TEMPLATE || eyelash:eyelashes || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| FEATHER_TEMPLATE || feather:STP || LOCAL_CREATURE_MAT:FEATHER || || 2 || || || || SKIN || 100 || FEATHERS
|-
| SCALE_TEMPLATE || scale:STP || LOCAL_CREATURE_MAT:SCALE || || 1 || 100 || 1 || 5 || || || SCALES
|-
| NAIL_TEMPLATE || nail:NP || LOCAL_CREATURE_MAT:NAIL || || 2 || || || || || || LAYER
|-
| CLAW_TEMPLATE || claw:NP || LOCAL_CREATURE_MAT:CLAW || || 2 || || || || || || LAYER
|-
| TALON_TEMPLATE || talon:NP || LOCAL_CREATURE_MAT:TALON || || 2 || || || || || || LAYER
|-
| TOOTH_TEMPLATE || tooth:NP || LOCAL_CREATURE_MAT:TOOTH || || 2 || || || || || || LAYER
|-
| IVORY_TEMPLATE || ivory:NP || LOCAL_CREATURE_MAT:IVORY || || 2 || || || || || || LAYER
|-
| EYE_TEMPLATE || eye tissue:NP || LOCAL_CREATURE_MAT:EYE || || 1 || 100 || 3 || 5 || || || LAYER
|-
| NERVE_TEMPLATE || nervous tissue:NP || LOCAL_CREATURE_MAT:NERVE || || 1 || || 3 || || || || LAYER
|-
| BRAIN_TEMPLATE || brain tissue:NP || LOCAL_CREATURE_MAT:BRAIN || || 1 || || 3 || || || || LAYER
|-
| LUNG_TEMPLATE || lung tissue:NP || LOCAL_CREATURE_MAT:LUNG || || 1 || 100 || 8 || 5 || || || LAYER
|-
| HEART_TEMPLATE || heart tissue:NP || LOCAL_CREATURE_MAT:HEART || || 1 || 100 || 10 || 5 || || || LAYER
|-
| LIVER_TEMPLATE || liver tissue:NP || LOCAL_CREATURE_MAT:LIVER || || 1 || 100 || 8 || 5 || || || LAYER
|-
| GUT_TEMPLATE || gut:NP || LOCAL_CREATURE_MAT:GUT || || 1 || 100 || 3 || 5 || || || LAYER
|-
| STOMACH_TEMPLATE || stomach tissue:NP || LOCAL_CREATURE_MAT:STOMACH || || 1 || 100 || 3 || 5 || || || LAYER
|-
| PANCREAS_TEMPLATE || pancreatic tissue:NP || LOCAL_CREATURE_MAT:PANCREAS || || 1 || 100 || 3 || 5 || || || LAYER
|-
| SPLEEN_TEMPLATE || spleen tissue:NP || LOCAL_CREATURE_MAT:SPLEEN || || 1 || 100 || 5 || 5 || || || LAYER
|-
| KIDNEY_TEMPLATE || kidney tissue:NP || LOCAL_CREATURE_MAT:KIDNEY || || 1 || 100 || 8 || 5 || || || LAYER
|-
| FLAME_TEMPLATE || flames:NP || LOCAL_CREATURE_MAT:FLAME || GAS || 1 || || || || || || LAYER
|-
| CHITIN_TEMPLATE || chitin:NP || LOCAL_CREATURE_MAT:CHITIN || || 1 || 100 || 1 || 5 || || || LAYER
|-
| SPINE_TEMPLATE || spine:NP || LOCAL_CREATURE_MAT:SPINE || || 2 || || || || || || LAYER
|-
| SPONGE_TEMPLATE || sponge:NP || LOCAL_CREATURE_MAT:SPONGE || || 1 || 100 || 3 || 5 || || 100 || LAYER
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|}

Default flags (as of 0.34.11):

{| {{prettytable}} style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 70%;"
|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|-
| SKIN_TEMPLATE || || || || X || || || || || X || || || ||
|-
| FAT_TEMPLATE || X || || || X || || || || || X || || || ||
|-
| MUSCLE_TEMPLATE || || X || X || X || X || || || || X || || ||
|-
| BONE_TEMPLATE || || || || || || || X || X || X || X || X || ||
|-
| SHELL_TEMPLATE || || || || || || || X || || X || X || X || ||
|-
| HORN_TEMPLATE || || || || || || || X || || X || || || ||
|-
| HOOF_TEMPLATE || || || || || || || X || || X || || || ||
|-
| CARTILAGE_TEMPLATE || || || || || || || X || || X || || || ||
|-
| HAIR_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHEEK_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHIN_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| MOUSTACHE_TEMPLATE || || || || || || || || || || || || X || X
|-
| SIDEBURNS_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYEBROW_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYELASH_TEMPLATE || || || || || || || || || || || || X || X
|-
| FEATHER_TEMPLATE || || || || || || || || || || || ||
|-
| SCALE_TEMPLATE || || || || X || || || || || X || || || ||
|-
| NAIL_TEMPLATE || || || || || || || X || || X || || || ||
|-
| CLAW_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TALON_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TOOTH_TEMPLATE || || || || || || || X || || X || || || ||
|-
| IVORY_TEMPLATE || || || || || || || X || || X || || || ||
|-
| EYE_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| NERVE_TEMPLATE || || || || X || || X || || || X || || || ||
|-
| BRAIN_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| LUNG_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| HEART_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| LIVER_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| GUT_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| STOMACH_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| PANCREAS_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| SPLEEN_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| KIDNEY_TEMPLATE || || || || X || || X || X || || X || || || ||
|-
| FLAME_TEMPLATE || || || || || X || X || X || || X || || || ||
|-
| CHITIN_TEMPLATE || || || || X || || || X || X || X || X || X || ||
|-
| SPINE_TEMPLATE || || || || || || || X || || X || || || ||
|-
| SPONGE_TEMPLATE || || || || X || || || || || X || || || ||
|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|}

==See Also==
*[[Material definition token]]

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

v0.31:Plant token

2026-04-04T00:33:05Z

Quietust:

{{quality|Exceptional|21:01, 30 March 2011 (UTC)}}{{av}}
The default plants are stored in the plant_standard.txt file, while grasses are stored in plant_grasses.txt.

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

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

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

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

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

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

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

|-
| {{text anchor|MATERIAL}}
|
*material_name
| Starts defining a new local plant material with the given name and '''no''' properties. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL}}
|
*material_name
*old_material
| Starts defining a new local plant material with the given name and using the properties of another local plant material. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
|
*material_name
*template_name
| Starts defining a new local plant material with the given name and using the properties of the specified material template. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|BASIC_MAT}}
|
* [[Material token|material]]
| Sets the basic material of the plant. According to Toady, you can use other materials (for instance, iron) but the game may hiccup on plants that aren't structurally plants. For crops, said material should have [STRUCTURAL_PLANT_MAT] to permit proper stockpiling. Generally, this should be "LOCAL_PLANT_MAT:material_name", using a material defined using MATERIAL, USE_MATERIAL, or USE_MATERIAL_TEMPLATE.
|}

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

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

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

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

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

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

|-
| {{text anchor|FREQUENCY}}
|
*freq (0-100)
| How frequently this plant is generated in a particular area. Defaults to 50.

|-
| {{text anchor|WET}}
|
| Allows the plant to grow near water features.

|-
| {{text anchor|DRY}}
|
| Allows the plant to grow away from water features.

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

|}

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

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

|-
| {{text anchor|TREE}}
|
* [[Material token|material]]
| Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material.

|-
| {{text anchor|AUTUMNCOLOR}}
|
| Makes the tree turn yellow, orange, and red in Autumn, then lose its leaves in Winter.

|-
| {{text anchor|TREE_TILE}}
|
*tile
| The tile used for the tree on the map. May be a number or a character inside apostrophes. Defaults to 24 (↑).

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

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

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

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

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

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

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

|-
| {{text anchor|SAPLING_DROWN_LEVEL}}
|
*depth
| The water depth at which saplings of this tree will drown. Exact behavior is unknown. Defaults to 4.

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

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

|}

==Crop Tokens==
These tokens are used only for plantable crops and harvestable shrubs.

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

|-
| {{text anchor|SPRING}}
|
| Allows the plant to grow during spring.

|-
| {{text anchor|SUMMER}}
|
| Allows the plant to grow during summer.

|-
| {{text anchor|AUTUMN}}
|
| Allows the plant to grow during autumn.

|-
| {{text anchor|WINTER}}
|
| Allows the plant to grow during winter.

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

|-
| {{text anchor|VALUE}}
|
*value
| Appears to have no effect.

|-
| {{text anchor|PICKED_TILE}}
|
*tile
| The tile used when harvested. May either be a number or letter within apostrophes(confirm?). See [[Main:character table|character table]]. Defaults to 231 (τ).

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

|-
| {{text anchor|SHRUB_TILE}}
|
*tile
| What tile is used for shrubs bearing this plant. Can be either a number or a character inside apostrophes. Defaults to 34 (").

|-
| {{text anchor|DEAD_SHRUB_TILE}}
|
*tile
| What tile is used for dead shrubs that once bore this plant. Can be either a number or a character inside apostrophes. Defaults to 34 (").

|-
| {{text anchor|CLUSTERSIZE}}
|
*size
| The maximum stack size collected when gathered via herbalism. Defaults to 5.

|-
| {{text anchor|PICKED_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant in farms. Defaults to 2:0:0 (dark green).

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

|-
| {{text anchor|SHRUB_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of shrubs bearing this plant. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SHRUB_COLOR}}
|
*foreground
*background
*bright
|The [[color]] of dead shrubs that bore this plant. Defaults to 6:0:0 (brown).

|-
| {{text anchor|SHRUB_DROWN_LEVEL}}
|
*depth
| The water depth at which shrubs of this plant will drown. Exact behavior is unknown. Defaults to 4.

|-
| {{text anchor|DRINK}}
|
* [[Material token|material]]
| Permits brewing the plant into [[alcohol]] made of this material. Said material should have [ALCOHOL_PLANT] to permit proper stockpiling.

|-
| {{text anchor|MILL}}
|
* [[Material token|material]]
| Permits milling the plant at a [[quern]] or [[millstone]] into a powder made of this material. Said material should have [POWDER_MISC_PLANT] to permit proper stockpiling.

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

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

|-
| {{text anchor|LEAVES}}
|
*name
*name_plural
*tile
*foreground
*background
*bright
*wilt_foreground
*wilt_background
*wilt_bright
*[[Material token|material]]
| Permits processing the plant into a [[bag]] at a [[farmer's workshop]] to yield leaves made of this material and having these properties. Said material should have [LEAF_MAT] to permit proper stockpiling.

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

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

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

|}

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

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

|-
| {{text anchor|GRASS}}
|
| Makes the plant behave as a type of grass.

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

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

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

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

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

v0.34:Plant token

2026-04-04T00:32:07Z

Quietust:

{{quality|Exceptional|21:01, 30 March 2011 (UTC)}}{{av}}
The default plants are stored in the plant_standard.txt file, while grasses are stored in plant_grasses.txt.

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

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

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

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

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

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

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

|-
| {{text anchor|MATERIAL}}
|
*material_name
| Starts defining a new local plant material with the given name and '''no''' properties. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL}}
|
*material_name
*old_material
| Starts defining a new local plant material with the given name and using the properties of another local plant material. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
|
*material_name
*template_name
| Starts defining a new local plant material with the given name and using the properties of the specified material template. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|BASIC_MAT}}
|
* [[Material token|material]]
| Sets the basic material of the plant. According to Toady, you can use other materials (for instance, iron) but the game may hiccup on plants that aren't structurally plants. For crops, said material should have [STRUCTURAL_PLANT_MAT] to permit proper stockpiling. Generally, this should be "LOCAL_PLANT_MAT:material_name", using a material defined using MATERIAL, USE_MATERIAL, or USE_MATERIAL_TEMPLATE.
|}

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

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

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

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

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

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

|-
| {{text anchor|FREQUENCY}}
|
*freq (0-100)
| How frequently this plant is generated in a particular area. Defaults to 50.

|-
| {{text anchor|WET}}
|
| Allows the plant to grow near water features.

|-
| {{text anchor|DRY}}
|
| Allows the plant to grow away from water features.

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

|}

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

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

|-
| {{text anchor|TREE}}
|
* [[Material token|material]]
| Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material.

|-
| {{text anchor|AUTUMNCOLOR}}
|
| Makes the tree turn yellow, orange, and red in Autumn, then lose its leaves in Winter.

|-
| {{text anchor|TREE_TILE}}
|
*tile
| The tile used for the tree on the map. May be a number or a character inside apostrophes. Defaults to 24 (↑).

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

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

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

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

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

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

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

|-
| {{text anchor|SAPLING_DROWN_LEVEL}}
|
*depth
| The water depth at which saplings of this tree will drown. Exact behavior is unknown. Defaults to 4.

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

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

|}

==Crop Tokens==
These tokens are used only for plantable crops and harvestable shrubs.

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

|-
| {{text anchor|SPRING}}
|
| Allows the plant to grow during spring.

|-
| {{text anchor|SUMMER}}
|
| Allows the plant to grow during summer.

|-
| {{text anchor|AUTUMN}}
|
| Allows the plant to grow during autumn.

|-
| {{text anchor|WINTER}}
|
| Allows the plant to grow during winter.

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

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

|-
| {{text anchor|PICKED_TILE}}
|
*tile
| The tile used when harvested. May either be a number or letter within apostrophes(confirm?). See [[Main:character table|character table]]. Defaults to 231 (τ).

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

|-
| {{text anchor|SHRUB_TILE}}
|
*tile
| What tile is used for shrubs bearing this plant. Can be either a number or a character inside apostrophes. Defaults to 34 (").

|-
| {{text anchor|DEAD_SHRUB_TILE}}
|
*tile
| What tile is used for dead shrubs that once bore this plant. Can be either a number or a character inside apostrophes. Defaults to 34 (").

|-
| {{text anchor|CLUSTERSIZE}}
|
*size
| The maximum stack size collected when gathered via herbalism. Defaults to 5.

|-
| {{text anchor|PICKED_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant in farms. Defaults to 2:0:0 (dark green).

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

|-
| {{text anchor|SHRUB_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of shrubs bearing this plant. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SHRUB_COLOR}}
|
*foreground
*background
*bright
|The [[color]] of dead shrubs that bore this plant. Defaults to 6:0:0 (brown).

|-
| {{text anchor|SHRUB_DROWN_LEVEL}}
|
*depth
| The water depth at which shrubs of this plant will drown. Exact behavior is unknown. Defaults to 4.

|-
| {{text anchor|DRINK}}
|
* [[Material token|material]]
| Permits brewing the plant into [[alcohol]] made of this material. Said material should have [ALCOHOL_PLANT] to permit proper stockpiling.

|-
| {{text anchor|MILL}}
|
* [[Material token|material]]
| Permits milling the plant at a [[quern]] or [[millstone]] into a powder made of this material. Said material should have [POWDER_MISC_PLANT] to permit proper stockpiling.

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

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

|-
| {{text anchor|LEAVES}}
|
*name
*name_plural
*tile
*foreground
*background
*bright
*wilt_foreground
*wilt_background
*wilt_bright
*[[Material token|material]]
| Permits processing the plant into a [[bag]] at a [[farmer's workshop]] to yield leaves made of this material and having these properties. Said material should have [LEAF_MAT] to permit proper stockpiling.

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

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

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

|}

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

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

|-
| {{text anchor|GRASS}}
|
| Makes the plant behave as a type of grass.

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

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

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

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

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

v0.31:Labor token

2026-04-04T00:29:05Z

Quietust:

{{quality|Exceptional|18:10, 28 April 2011 (UTC)}}{{av}}

A list of all labor tokens, mainly used in custom buildings.

{| {{prettytable}} class="sortable"
|- style='background-color:#ddd'
! # !! Token !! Labor
|-
| 0 || {{text anchor|MINE}} || [[Mining]]
|-
| 1 || {{text anchor|HAUL_STONE}} || [[Stone hauling]]
|-
| 2 || {{text anchor|HAUL_WOOD}} || [[Wood hauling]]
|-
| 3 || {{text anchor|HAUL_BODY}} || [[Burial]]
|-
| 4 || {{text anchor|HAUL_FOOD}} || [[Food hauling]]
|-
| 5 || {{text anchor|HAUL_REFUSE}} || [[Refuse hauling]]
|-
| 6 || {{text anchor|HAUL_ITEM}} || [[Item hauling]]
|-
| 7 || {{text anchor|HAUL_FURNITURE}} || [[Furniture hauling]]
|-
| 8 || {{text anchor|HAUL_ANIMALS}} || [[Animal hauling]]
|-
| 9 || {{text anchor|CLEAN}} || [[Cleaning]]
|-
| 10 || {{text anchor|CUTWOOD}} || [[Wood cutting]]
|-
| 11 || {{text anchor|CARPENTER}} || [[Carpentry]]
|-
| 12 || {{text anchor|DETAIL}} || [[Stone detailing]]
|-
| 13 || {{text anchor|MASON}} || [[Masonry]]
|-
| 14 || {{text anchor|ARCHITECT}} || [[Architecture]]
|-
| 15 || {{text anchor|ANIMALTRAIN}} || [[Animal training]]
|-
| 16 || {{text anchor|ANIMALCARE}} || [[Animal care]]
|-
| 17 || {{text anchor|DIAGNOSE}} || [[Diagnosis]]
|-
| 18 || {{text anchor|SURGERY}} || [[Surgery]]
|-
| 19 || {{text anchor|BONE_SETTING}} || [[Setting bones]]
|-
| 20 || {{text anchor|SUTURING}} || [[Suturing]]
|-
| 21 || {{text anchor|DRESSING_WOUNDS}} || [[Dressing wounds]]
|-
| 22 || {{text anchor|FEED_WATER_CIVILIANS}} || [[Feed patients/prisoners]]
|-
| 23 || {{text anchor|RECOVER_WOUNDED}} || [[Recovering wounded]]
|-
| 24 || {{text anchor|BUTCHER}} || [[Butchery]]
|-
| 25 || {{text anchor|TRAPPER}} || [[Trapper]]
|-
| 26 || {{text anchor|DISSECT_VERMIN}} || [[Small animal dissection]]
|-
| 27 || {{text anchor|LEATHER}} || [[Leatherworking]]
|-
| 28 || {{text anchor|TANNER}} || [[Tanning]]
|-
| 29 || {{text anchor|BREWER}} || [[Brewing]]
|-
| 30 || {{text anchor|ALCHEMIST}} || [[Alchemy]]
|-
| 31 || {{text anchor|SOAP_MAKER}} || [[Soap making]]
|-
| 32 || {{text anchor|WEAVER}} || [[Weaving]]
|-
| 33 || {{text anchor|CLOTHESMAKER}} || [[Clothesmaking]]
|-
| 34 || {{text anchor|MILLER}} || [[Milling]]
|-
| 35 || {{text anchor|PROCESS_PLANT}} || [[Plant processing]]
|-
| 36 || {{text anchor|MAKE_CHEESE}} || [[Cheese making]]
|-
| 37 || {{text anchor|MILK}} || [[Milking]]
|-
| 38 || {{text anchor|COOK}} || [[Cooking]]
|-
| 39 || {{text anchor|PLANT}} || [[Farming (fields)]]
|-
| 40 || {{text anchor|HERBALIST}} || [[Plant gathering]]
|-
| 41 || {{text anchor|FISH}} || [[Fishing]]
|-
| 42 || {{text anchor|CLEAN_FISH}} || [[Fish cleaning]]
|-
| 43 || {{text anchor|DISSECT_FISH}} || [[Fish dissection]]
|-
| 44 || {{text anchor|HUNT}} || [[Hunting]]
|-
| 45 || {{text anchor|SMELT}} || [[Furnace operating]]
|-
| 46 || {{text anchor|FORGE_WEAPON}} || [[Weaponsmithing]]
|-
| 47 || {{text anchor|FORGE_ARMOR}} || [[Armoring]]
|-
| 48 || {{text anchor|FORGE_FURNITURE}} || [[Blacksmithing]]
|-
| 49 || {{text anchor|METAL_CRAFT}} || [[Metalcrafting]]
|-
| 50 || {{text anchor|CUT_GEM}} || [[Gem cutting]]
|-
| 51 || {{text anchor|ENCRUST_GEM}} || [[Gem setting]]
|-
| 52 || {{text anchor|WOOD_CRAFT}} || [[Woodcrafting]]
|-
| 53 || {{text anchor|STONE_CRAFT}} || [[Stonecrafting]]
|-
| 54 || {{text anchor|BONE_CARVE}} || [[Bone carving]]
|-
| 55 || {{text anchor|GLASSMAKER}} || [[Glassmaking]]
|-
| 56 || {{text anchor|EXTRACT_STRAND}} || [[Strand extraction]]
|-
| 57 || {{text anchor|SIEGECRAFT}} || [[Siege engineering]]
|-
| 58 || {{text anchor|SIEGEOPERATE}} || [[Siege operating]]
|-
| 59 || {{text anchor|BOWYER}} || [[Crossbow-making]]
|-
| 60 || {{text anchor|MECHANIC}} || [[Mechanics]]
|-
| 61 || {{text anchor|POTASH_MAKING}} || [[Potash making]]
|-
| 62 || {{text anchor|LYE_MAKING}} || [[Lye making]]
|-
| 63 || {{text anchor|DYER}} || [[Dyeing]]
|-
| 64 || {{text anchor|BURN_WOOD}} || [[Wood burning]]
|-
| 65 || {{text anchor|OPERATE_PUMP}} || [[Pump operating]]
|-
| 66 || {{text anchor|SHEARER}} || [[Shearing]]
|-
| 67 || {{text anchor|SPINNER}} || [[Spinning]]
|-
| 68 || {{text anchor|POTTERY}} || [[Pottery]]
|-
| 69 || {{text anchor|GLAZING}} || [[Glazing]]
|-
| 70 || {{text anchor|PRESSING}} || [[Pressing]]
|-
| 71 || {{text anchor|BEEKEEPING}} || [[Beekeeping]]
|-
| 72 || {{text anchor|WAX_WORKING}} || [[Wax working]]
|}

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

v0.34:Labor token

2026-04-04T00:28:41Z

Quietust:

{{Quality|Superior|21:42, 17 May 2015 (UTC)}}
{{av}}

A list of all labor tokens, mainly used in custom buildings.

{| {{prettytable}} class="sortable"
|- style='background-color:#ddd'
! # !! Token !! Labor
|-
| 0 || {{text anchor|MINE}} || [[Mining]]
|-
| 1 || {{text anchor|HAUL_STONE}} || [[Stone hauling]]
|-
| 2 || {{text anchor|HAUL_WOOD}} || [[Wood hauling]]
|-
| 3 || {{text anchor|HAUL_BODY}} || [[Burial]]
|-
| 4 || {{text anchor|HAUL_FOOD}} || [[Food hauling]]
|-
| 5 || {{text anchor|HAUL_REFUSE}} || [[Refuse hauling]]
|-
| 6 || {{text anchor|HAUL_ITEM}} || [[Item hauling]]
|-
| 7 || {{text anchor|HAUL_FURNITURE}} || [[Furniture hauling]]
|-
| 8 || {{text anchor|HAUL_ANIMALS}} || [[Animal hauling]]
|-
| 9 || {{text anchor|CLEAN}} || [[Cleaning]]
|-
| 10 || {{text anchor|CUTWOOD}} || [[Wood cutting]]
|-
| 11 || {{text anchor|CARPENTER}} || [[Carpentry]]
|-
| 12 || {{text anchor|DETAIL}} || [[Stone detailing]]
|-
| 13 || {{text anchor|MASON}} || [[Masonry]]
|-
| 14 || {{text anchor|ARCHITECT}} || [[Architecture]]
|-
| 15 || {{text anchor|ANIMALTRAIN}} || [[Animal training]]
|-
| 16 || {{text anchor|ANIMALCARE}} || [[Animal care]]
|-
| 17 || {{text anchor|DIAGNOSE}} || [[Diagnosis]]
|-
| 18 || {{text anchor|SURGERY}} || [[Surgery]]
|-
| 19 || {{text anchor|BONE_SETTING}} || [[Setting bones]]
|-
| 20 || {{text anchor|SUTURING}} || [[Suturing]]
|-
| 21 || {{text anchor|DRESSING_WOUNDS}} || [[Dressing wounds]]
|-
| 22 || {{text anchor|FEED_WATER_CIVILIANS}} || [[Feed patients/prisoners]]
|-
| 23 || {{text anchor|RECOVER_WOUNDED}} || [[Recovering wounded]]
|-
| 24 || {{text anchor|BUTCHER}} || [[Butchery]]
|-
| 25 || {{text anchor|TRAPPER}} || [[Trapper]]
|-
| 26 || {{text anchor|DISSECT_VERMIN}} || [[Small animal dissection]]
|-
| 27 || {{text anchor|LEATHER}} || [[Leatherworking]]
|-
| 28 || {{text anchor|TANNER}} || [[Tanning]]
|-
| 29 || {{text anchor|BREWER}} || [[Brewing]]
|-
| 30 || {{text anchor|ALCHEMIST}} || [[Alchemy]]
|-
| 31 || {{text anchor|SOAP_MAKER}} || [[Soap making]]
|-
| 32 || {{text anchor|WEAVER}} || [[Weaving]]
|-
| 33 || {{text anchor|CLOTHESMAKER}} || [[Clothesmaking]]
|-
| 34 || {{text anchor|MILLER}} || [[Milling]]
|-
| 35 || {{text anchor|PROCESS_PLANT}} || [[Plant processing]]
|-
| 36 || {{text anchor|MAKE_CHEESE}} || [[Cheese making]]
|-
| 37 || {{text anchor|MILK}} || [[Milking]]
|-
| 38 || {{text anchor|COOK}} || [[Cooking]]
|-
| 39 || {{text anchor|PLANT}} || [[Farming (fields)]]
|-
| 40 || {{text anchor|HERBALIST}} || [[Plant gathering]]
|-
| 41 || {{text anchor|FISH}} || [[Fishing]]
|-
| 42 || {{text anchor|CLEAN_FISH}} || [[Fish cleaning]]
|-
| 43 || {{text anchor|DISSECT_FISH}} || [[Fish dissection]]
|-
| 44 || {{text anchor|HUNT}} || [[Hunting]]
|-
| 45 || {{text anchor|SMELT}} || [[Furnace operating]]
|-
| 46 || {{text anchor|FORGE_WEAPON}} || [[Weaponsmithing]]
|-
| 47 || {{text anchor|FORGE_ARMOR}} || [[Armoring]]
|-
| 48 || {{text anchor|FORGE_FURNITURE}} || [[Blacksmithing]]
|-
| 49 || {{text anchor|METAL_CRAFT}} || [[Metalcrafting]]
|-
| 50 || {{text anchor|CUT_GEM}} || [[Gem cutting]]
|-
| 51 || {{text anchor|ENCRUST_GEM}} || [[Gem setting]]
|-
| 52 || {{text anchor|WOOD_CRAFT}} || [[Woodcrafting]]
|-
| 53 || {{text anchor|STONE_CRAFT}} || [[Stonecrafting]]
|-
| 54 || {{text anchor|BONE_CARVE}} || [[Bone carving]]
|-
| 55 || {{text anchor|GLASSMAKER}} || [[Glassmaking]]
|-
| 56 || {{text anchor|EXTRACT_STRAND}} || [[Strand extraction]]
|-
| 57 || {{text anchor|SIEGECRAFT}} || [[Siege engineering]]
|-
| 58 || {{text anchor|SIEGEOPERATE}} || [[Siege operating]]
|-
| 59 || {{text anchor|BOWYER}} || [[Crossbow-making]]
|-
| 60 || {{text anchor|MECHANIC}} || [[Mechanics]]
|-
| 61 || {{text anchor|POTASH_MAKING}} || [[Potash making]]
|-
| 62 || {{text anchor|LYE_MAKING}} || [[Lye making]]
|-
| 63 || {{text anchor|DYER}} || [[Dyeing]]
|-
| 64 || {{text anchor|BURN_WOOD}} || [[Wood burning]]
|-
| 65 || {{text anchor|OPERATE_PUMP}} || [[Pump operating]]
|-
| 66 || {{text anchor|SHEARER}} || [[Shearing]]
|-
| 67 || {{text anchor|SPINNER}} || [[Spinning]]
|-
| 68 || {{text anchor|POTTERY}} || [[Pottery]]
|-
| 69 || {{text anchor|GLAZING}} || [[Glazing]]
|-
| 70 || {{text anchor|PRESSING}} || [[Pressing]]
|-
| 71 || {{text anchor|BEEKEEPING}} || [[Beekeeping]]
|-
| 72 || {{text anchor|WAX_WORKING}} || [[Wax working]]
|-
| 73 || {{text anchor|HANDLE_VEHICLES}} || [[Push/haul vehicles]]
|}

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

v0.34:Interaction token

2026-04-04T00:27:35Z

Quietust:

{{av}}

The following tokens can be used to define and use interactions.

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

|-
| {{text anchor|I_SOURCE}}
| Global
| type
| Defines what things are capable of triggering this interaction. Can be specified multiple times. Valid values:
* REGION - The interaction takes place in particular types of regions in the world.
* UNDERGROUND_SPECIAL - The interaction takes place in [[Demonic fortress|curious underground structure]]s.
* SECRET - The interaction is a secret that can be learned by particular individuals.
* DISTURBANCE - The interaction is triggered when disturbing a [[tomb]].
* DEITY - The interaction is inflicted upon mortals by the gods.
* ATTACK - The interaction is triggered by an attack during combat.
* INGESTION - The interaction is triggered by eating or drinking something.
* CREATURE_ACTION - The interaction is triggered by an explicit action.

|-
| {{text anchor|IS_HIST_STRING_1}}
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure. Displayed after the name of the historical figure that performed the interaction.

[IS_HIST_STRING_1: cursed ]

|-
| {{text anchor|IS_HIST_STRING_2}}
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure. Displayed after the name of the historical figure that was targeted by the interaction.

[IS_HIST_STRING_2: to assume the form of a lizard-like monster every full moon]

|-
| {{text anchor|IS_FREQUENCY}}
| Within I_SOURCE
| Number
| Presumably, the probability of biome specified by [IS_REGION] to have this interaction.

|-
| {{text anchor|IS_NAME}}
| Within I_SOURCE
| string
| Generally used with secrets, describes what the secret is about.

|-
| {{text anchor|IS_REGION}}
| Within I_SOURCE:REGION
| Region type
| Indicates what types regions are capable of performing this interaction. Can be specified multiple times. Valid values:
* ANY
* ANY_TERRAIN
* NORMAL_ALLOWED
* EVIL_ALLOWED
* GOOD_ALLOWED
* SAVAGE_ALLOWED
* EVIL_ONLY
* GOOD_ONLY
* SAVAGE_ONLY
* Region type - SWAMP, DESERT, FOREST, MOUNTAINS, OCEAN, LAKE, GLACIER, TUNDRA, GRASSLAND, HILLS

|-
| {{text anchor|IS_SPHERE}}
| Within I_SOURCE:SECRET
| [[Sphere]]
| Indicates the sphere to which this secret pertains. Only one sphere can be defined for each [I_SOURCE:SECRET] token, thus several [I_SOURCE:SECRET] tokens required to create a valid custom secret, which belongs to several different spheres

|-
| {{text anchor|IS_SECRET_GOAL}}
| Within I_SOURCE:SECRET
| Secret Goal token
| Indicates why somebody would want to learn the secret. Valid values:
* IMMORTALITY

|-
| {{text anchor|IS_SECRET}}
| Within I_SOURCE:SECRET
| Secret Flag
| Indicates how the secret can be learned. Valid values:
* SUPERNATURAL_LEARNING_POSSIBLE - the secret can be learned by supernatural means
* MUNDANE_RESEARCH_POSSIBLE - the secret can be researched by mundane means
* MUNDANE_TEACHING_POSSIBLE - the secret can be taught to apprentices
* MUNDANE_RECORDING_POSSIBLE:objects/text/(book_title).txt:objects/text/(book_topic).txt - the secret can be written in books with the specified title. 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 CDI:USAGE_HINT below for valid values - in this context, MAJOR_CURSE is the only value that makes sense.

|-
| {{text anchor|I_TARGET}}
| Global
| id, type
| Specifies what things this interaction acts upon. Can be specified multiple times. Valid values:
* CORPSE - Also includes pieces of corpses
* CREATURE
* MATERIAL
* LOCATION

|-
| {{text anchor|IT_LOCATION}}
| Within I_TARGET
| Location
| Narrows down exactly what the interaction targets. Valid values:
* CONTEXT_REGION - Can only be used by IS_REGION interactions.
* CONTEXT_CREATURE
* CONTEXT_ITEM - Used when the target is a CORPSE.
* CONTEXT_BP - Use body part from CDI:BP_REQUIRED token (below).
* CONTEXT_LOCATION

|-
| {{text anchor|IT_MANUAL_INPUT}}
| Within I_TARGET
| text
| Tells the player what they should be selecting.

|-
| {{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, LIKES_FIGHTING (or LIKESFIGHTING), 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. Valid values:
* FLOW:Breath attack token - Specifies an attack not made of any material.
* MATERIAL:[[Material token]]:Breath attack token - Specifies an attack made of a specific material.
* CONTEXT_MATERIAL - Use material from CDI:MATERIAL token (below).

|-
| {{text anchor|I_EFFECT}}
| Global
| type
| Specifies what the interaction does to the targets. Can be specified multiple times. Valid values:
* ANIMATE - Raises the target corpse/bodypart as a zombie. 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.
* RESURRECT - 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.
* ADD_SYNDROME - Adds one or more syndromes. The actual syndrome is specified with the [SYNDROME] tag.
* CLEAN - Cleans off most liquids/dust covering the creature.
* HIDE - Allows the creature to hide even if another creature can see it.
* CONTACT - Causes the creatures to touch. The interaction's range must be TOUCHABLE.
* MATERIAL_EMISSION - Used within the MATERIAL_EMISSION interaction.

|-
| {{text anchor|IE_TARGET}}
| Within I_EFFECT
| ID
| Specifies which I_TARGET this effect will be applied to

|-
| {{text anchor|IE_INTERMITTENT}}
| Within I_EFFECT
| Frequency
| Indicates that the effect happens intermittently and specifies roughly how often. Valid values:
* WEEKLY

|-
| {{text anchor|IE_IMMEDIATE}}
| Within I_EFFECT
|
| Indicates that the effect happens immediately.

|-
| {{text anchor|IE_LOCATION}}
| Within I_EFFECT
| Location Hint
| Indicates where the effect can take place. Valid values:
* IN_WATER
* IN_MAGMA
* NO_WATER
* NO_MAGMA

|-
| {{text anchor|IE_ARENA_NAME}}
| Within I_EFFECT
| text
| Allows the interaction to be applied to newly spawned creatures in Arena mode.

|-
| {{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 flag
| Indicates that cleaning off materials will activate their syndromes if they have this flag.

|-
| {{text anchor|GENERATED}}
| Global
|
| Indicates that this is a generated interaction. Cannot be specified in user-defined raws.

|}

==Interaction Usage==
In order to actually use an interaction, add the [[creature token]] [CAN_DO_INTERACTION:NAME] followed by a series of [CDI:...] tokens. Interactions can also be granted through [[syndrome]]s using the token [CE_CAN_DO_INTERACTION] (plus the same series of CDI tokens).

The following CDI tokens can be specified:
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| {{text anchor|INTERACTION}}
| id
| Specifies which interaction can be performed. Only to be used with syndromes, since CE_CAN_DO_INTERACTION does not allow specifying the interaction ID directly.

|-
| {{text anchor|TARGET}}
| target ID, target types
| Specifies how the creature chooses what to . 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
* SELF_ALLOWED - the target can be the source
* SELF_ONLY - the target '''must''' be the source

|-
| {{text anchor|TARGET_RANGE}}
| target ID, range
| Specifies how far away the target can be, in tiles.

|-
| {{text anchor|LOCATION_HINT}}
| Location Hint (see above)
| ?

|-
| {{text anchor|USAGE_HINT}}
| Usage hint token
| Indicates when and how CPU-controlled creatures will use the interaction. If no hint is specified, the interaction will be used whenever a valid target is available. Valid values:
* MAJOR_CURSE - Used in disturbance curses and deity curses. Targets the tomb disturber/temple defiler.
* GREETING - Creatures will target 'friendly' creatures, usually at random.
* CLEAN_SELF - Creature targets itself when covered in liquids or dust.
* CLEAN_FRIEND - Same, but targets other friendly units.
* ATTACK - Targets enemy creatures in combat. If the interaction specifies SELF_ONLY, CPU-controlled creatures will never use it.
* FLEEING - Used when fleeing an enemy. Creature will target itself.

|-
| {{text anchor|ADV_NAME}}
| text
| Specifies the interaction's name when used in Adventurer mode.

|-
| {{text anchor|MAX_TARGET_NUMBER}}
| ID, number
| Specifies the maximum number of things that can be selected for a particular I_TARGET.

|-
| {{text anchor|WAIT_PERIOD}}
| number
| Controls how often the interaction can be used.

|-
| {{text anchor|VERBAL}}
|
| Only creatures that can speak will be able to use the interaction. Might also be needed for VERBAL_SPEECH.

|-
| {{text anchor|VERBAL_SPEECH}}
| filename
| Specifies what the creature says when they perform the interaction. Filename path is relative to /data/speech.

|-
| {{text anchor|CAN_BE_MUTUAL}}
|
| Presumably, allows two creatures with this same interaction to use it on each other simultaneously, for example cats cleaning each other.

|-
| {{text anchor|FREE_ACTION}}
|
| Indicates that performing the interaction doesn't take any time.

|-
| {{text anchor|VERB}}
| self:other:mutual
| When a creature uses the interaction, a message will display, describing the source as doing this.

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

|-
| {{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:category, BY_TYPE:type, or BY_TOKEN:token.

|-
| {{text anchor|FLOW}}
| [[Syndrome#Breath Attack Types|Breath attack token]]
| Causes the interaction to create an effect not made of any material. Only makes sense for FIREBALL, FIREJET, or DRAGONFIRE.

|-
| {{text anchor|MATERIAL}}
| [[Material token]]:Breath attack token
| Causes the interaction to create an effect made of a specific material. Doesn't make sense for FIREBALL, FIREJET, or DRAGONFIRE.

|}

==See Also==
* [[Syndrome]]

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

40d:Ethic

2026-04-04T00:24:58Z

Quietust:

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

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

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

== Ethics types ==
{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Extra Information
|-
|{{text anchor|ASSAULT}}
| Determines punishments for the "Assault" and "Disorderly Conduct" [[justice|crime]]s.
|-
|{{text anchor|EAT_SAPIENT_KILL}}
| Civilizations that accept this type of cannibalism and civilizations that do not may go to war over "the devouring of the bodies of sapient beings" in world-gen. Members of civilizations that accept this type of cannibalism will devour the bodies of creatures they kill in world-gen.
|-
|{{text anchor|EAT_SAPIENT_OTHER}}
| Civilizations that accept this type of cannibalism and civilizations that do not may go to war over "the devouring of the bodies of sapient beings" in world-gen. Adds meat and other materials from creatures who can learn into trade.
|-
|{{text anchor|KILL_ANIMAL}}
| Civilizations that accept killing animals and civilizations that do not may go to war over "the treatment of animals."
|-
|{{text anchor|KILL_ENEMY}}
|
|-
|{{text anchor|KILL_ENTITY_MEMBER}}
| Determines punishments for the "Murder" [[justice|crime]]. Members of a civilization that accepts murder may kill other entity members in world-gen.
|-
|{{text anchor|KILL_NEUTRAL}}
|
|-
|{{text anchor|KILL_PLANT}}
| This includes a race's position towards wood - a response between MISGUIDED and UNTHINKABLE (see below) causes the entity to refuse wooden objects in trade and also prohibits them from bringing caravan [[wagon]]s.

Civilizations that accept killing plants and civilizations that do not may go to war in world-gen.
|-
|{{text anchor|LYING}}
| Civilizations that accept lying and civilizations that do not may go to war over "truthfulness" in world-gen.
|-
|{{text anchor|MAKE_TROPHY_ANIMAL}}
| Civilizations that accept making this type of trophy and civilizations that do not may go to war over "the display of war and hunting trophies" in world-gen.
|-
|{{text anchor|MAKE_TROPHY_SAME_RACE}}
| Civilizations that accept making this type of trophy and civilizations that do not may go to war over "the display of war and hunting trophies" in world-gen.
|-
|{{text anchor|MAKE_TROPHY_SAPIENT}}
| Civilizations that accept making this type of trophy and civilizations that do not may go to war over "the display of war and hunting trophies" in world-gen.
|-
|{{text anchor|OATH_BREAKING}}
| Civilizations that accept oath-breaking and civilizations that do not may go to war over "a formalized agreement" in world-gen.
|-
|{{text anchor|SLAVERY}}
| Civilizations that accept slavery will take the former population of sites they conquer as slaves in world-gen.
|-
|{{text anchor|THEFT}}
|
|-
|{{text anchor|TORTURE_ANIMALS}}
| Civilizations that accept this type of torture and civilizations that do not may go to war in world-gen.
|-
|{{text anchor|TORTURE_AS_EXAMPLE}}
|
|-
|{{text anchor|TORTURE_FOR_FUN}}
| Civilizations that accept this type of torture and civilizations that do not may go to war over "torture" in world-gen.
|-
|{{text anchor|TORTURE_FOR_INFORMATION}}
|
|-
|{{text anchor|TREASON}}
|
|-
|{{text anchor|TRESPASSING}}
|
|-
|{{text anchor|VANDALISM}}
|Determines punishments for the "Building Destruction" [[justice|crime]]s.
|}

==Ethic value numbers in relation to each other==
The following table describes how entities respond to other cultures, with the observer on the vertical axis and their target on the horizontal axis.
If an entity's accumulated animosity towards another passes a certain threshold (determined by the ruler's personality) then it will run a risk-assessment check. If passed, this will lead to a declaration of war.

In general, entities react much more strongly to actions that violate ''their'' taboos than to the outlawing of their customs in other civilisations.
For example, Civ A finds slavery Acceptable, but Civ B considers it a Capital Offence.
* Civ A will consider Civ B most unreasonable (−5) for executing people over such a non-issue.
* Civ B will be shocked and disgusted (−15) that Civ A engages in such a debased activity.
* The end result is mutual negativity. However, Civ B is 3× ''more'' offended, and much more likely to go to war over the issue — assuming, of course, they think they have a chance of winning.

{| {{prettytable}}
|- bgcolor="#dddddd"
! rowspan=2 colspan=2 |  
! colspan=16 | TARGET
|- bgcolor="#dddddd"
!width=6%| Accept. ||width=6%| Personal ||width=6%| Reperc. ||width=6%| Good ||width=6%| Extreme ||width=6%| Self-Def. ||width=6%| Sanct. ||width=6%| Misguid. ||width=6%| Shun ||width=6%| Appall. ||width=6%| Reprim. ||width=6%| Serious ||width=6%| Exile ||width=6%| Capital ||width=6%| Unthink.
|-
! rowspan=16 | {{rotate|OBSERVER}}     
! Acceptable || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || 0 || 0 || 0 || {{tc|red|−1}} || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−3}} || {{tc|red|−5}} || {{tc|red|−5}} || {{tc|red|−2}}
|-
! Personal || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || 0 || 0 || 0 || {{tc|red|−1}} || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−3}} || {{tc|red|−5}} || {{tc|red|−5}} || {{tc|red|−2}}
|-
! No Reperc. || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || 0 || 0 || 0 || {{tc|red|−1}} || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−3}} || {{tc|red|−5}} || {{tc|red|−5}} || {{tc|red|−2}}
|-
! Good Reas. || 0 || 0 || 0 || {{tc|blue|+2}} || {{tc|blue|+1}} || 0 || 0 || 0 || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}}
|-
! Extreme Rs. || {{tc|red|−1}} || {{tc|red|−1}} || 0 || {{tc|blue|+1}} || {{tc|blue|+2}} || 0 || 0 || 0 || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}}
|-
! Self-Defence || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−1}} || 0 || {{tc|blue|+1}} || {{tc|blue|+2}} || 0 || 0 || 0 || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}}
|-
! Sanctioned || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−1}} || 0 || {{tc|blue|+1}} || 0 || {{tc|blue|+2}} || 0 || 0 || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−1}}
|-
! Misguided || {{tc|red|−1}} || {{tc|red|−1}} || 0 || 0 || 0 || 0 || 0 || {{tc|blue|+2}} || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || 0 || {{tc|red|−1}} || {{tc|blue|+1}}
|-
! Shun || {{tc|red|−1}} || {{tc|red|−1}} || 0 || 0 || 0 || 0 || 0 || {{tc|blue|+1}} || {{tc|blue|+2}} || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || 0 || {{tc|red|−1}} || {{tc|blue|+1}}
|-
! Appalling || {{tc|red|−5}} || {{tc|red|−5}} || {{tc|red|−3}} || {{tc|red|−2}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−2}} || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+2}} || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || {{tc|blue|+1}}
|-
! Reprimand || {{tc|red|−5}} || {{tc|red|−5}} || {{tc|red|−3}} || {{tc|red|−2}} || {{tc|red|−1}} || {{tc|red|−1}} || {{tc|red|−2}} || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+2}} || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || {{tc|blue|+1}}
|-
! Serious || {{tc|red|−10}} || {{tc|red|−10}} || {{tc|red|−7}} || {{tc|red|−3}} || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−3}} || 0 || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || {{tc|blue|+2}} || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+1}}
|-
! Exile || {{tc|red|−10}} || {{tc|red|−10}} || {{tc|red|−7}} || {{tc|red|−3}} || {{tc|red|−2}} || {{tc|red|−2}} || {{tc|red|−3}} || 0 || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || {{tc|blue|+1}} || {{tc|blue|+2}} || {{tc|blue|+1}} || {{tc|blue|+1}}
|-
! Capital || {{tc|red|−15}} || {{tc|red|−15}} || {{tc|red|−10}} || {{tc|red|−5}} || {{tc|red|−3}} || {{tc|red|−3}} || {{tc|red|−5}} || 0 || 0 || {{tc|blue|+1}} || 0 || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+2}} || {{tc|blue|+1}}
|-
! Unthinkable || {{tc|red|−15}} || {{tc|red|−15}} || {{tc|red|−10}} || {{tc|red|−5}} || {{tc|red|−3}} || {{tc|red|−3}} || {{tc|red|−5}} || 0 || {{tc|blue|+1}} || {{tc|blue|+1}} || 0 || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+1}} || {{tc|blue|+2}}
|}

All above info was collected and interpreted from the data given by Toady himself at [http://www.bay12forums.com/smf/index.php?topic=22151.msg239689] and confirmed against a disassembly.

v0.31:Ethic

2026-04-04T00:23:55Z

Quietust:

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

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

Example usage: [ETHIC:ASSAULT:PUNISH_SERIOUS]

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

== Ethics types ==
{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Extra Information
|-
|{{text anchor|ASSAULT}}
|
|-
|{{text anchor|EAT_SAPIENT_KILL}}
| This determines if the race will sometimes devour dead enemy combatants.
|-
|{{text anchor|EAT_SAPIENT_OTHER}}
| This also determines whatever or not a race is willing to butcher other sapients.
|-
|{{text anchor|KILL_ANIMAL}}
|
|-
|{{text anchor|KILL_ENEMY}}
|
|-
|{{text anchor|KILL_ENTITY_MEMBER}}
|
|-
|{{text anchor|KILL_NEUTRAL}}
|
|-
|{{text anchor|KILL_PLANT}}
| This determines a race's position towards wood as well. Setting this ethic's response to MISGUIDED, SHUN, APPALLING, PUNISH_*, or UNTHINKABLE (see below) prohibits the entity from using [[wagon]]s in trade.
|-
|{{text anchor|LYING}}
|
|-
|{{text anchor|MAKE_TROPHY_ANIMAL}}
|
|-
|{{text anchor|MAKE_TROPHY_SAME_RACE}}
|
|-
|{{text anchor|MAKE_TROPHY_SAPIENT}}
|
|-
|{{text anchor|OATH_BREAKING}}
|
|-
|{{text anchor|SLAVERY}}
|
|-
|{{text anchor|THEFT}}
| This determines whether the race will try to steal goods.
|-
|{{text anchor|TORTURE_ANIMALS}}
|
|-
|{{text anchor|TORTURE_AS_EXAMPLE}}
|
|-
|{{text anchor|TORTURE_FOR_FUN}}
|
|-
|{{text anchor|TORTURE_FOR_INFORMATION}}
|
|-
|{{text anchor|TREASON}}
|
|-
|{{text anchor|TRESPASSING}}
|
|-
|{{text anchor|VANDALISM}}
|
|}

==Ethics values==
In order of acceptability:

{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
|-
|{{text anchor|NOT_APPLICABLE}}
|-
|{{text anchor|ACCEPTABLE}}
|-
|{{text anchor|PERSONAL_MATTER}}
|-
|{{text anchor|JUSTIFIED_IF_NO_REPERCUSSIONS}}
|-
|{{text anchor|JUSTIFIED_IF_GOOD_REASON}}
|-
|{{text anchor|JUSTIFIED_IF_EXTREME_REASON}}
|-
|{{text anchor|JUSTIFIED_IF_SELF_DEFENSE}}
|-
|{{text anchor|ONLY_IF_SANCTIONED}}
|-
|{{text anchor|MISGUIDED}}
|-
|{{text anchor|SHUN}}
|-
|{{text anchor|APPALLING}}
|-
|{{text anchor|PUNISH_REPRIMAND}}
|-
|{{text anchor|PUNISH_SERIOUS}}
|-
|{{text anchor|PUNISH_EXILE}}
|-
|{{text anchor|PUNISH_CAPITAL}}
|-
|{{text anchor|UNTHINKABLE}}
|}

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

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

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

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

v0.31:Entity token

2026-04-04T00:22:23Z

Quietust:

{{quality|Exceptional|18:03, 28 April 2011 (UTC)}}{{av}}
These tokens define entities, or civilizations, in entity_*.txt files.

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

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. It seems that the best way to use this is to put your entity in the same order as the other tiers. The tiers are in descending order. So you should put a new adventure entity above the Dwarves. Not at the end of the file.
[ADVENTURE_TIER:4]

|-
| {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear.

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

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. Multiple entries will be chosen from at random for each civilization.
[CREATURE:DWARF]

|}

== Placement ==

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

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

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME: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 and FORTRESS, though these likely will not work. Defaults to CITY. As of version 0.31.13, dark fortresses, detailed caves, and tree cities can no longer be visited in Adventurer mode.
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

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

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

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

|}

== Population ==

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

|-
| {{text anchor|START_GROUP_NUMBER}}
| number
| Number of breeding couples to start with per entity. Helps give a boost to weaker civs by giving them more cannon fodder at the beginning of their histories, and better genetic diversity (if that's modeled for that particular creature). Note that single-gender (eg. [FEMALE], [MALE], [NO_GENDER]) creatures will not have breeding couples, so a civilization with only these creatures will not be very likely to survive. As of 40d, although many had problems getting such civilizations to survive, there are those who have demonstrably and repeatedly done so. Presumably if the civ-starting code can't place breeding couples, it doesn't start the civ. However, because the children never grow up, the civ is limited to its original individuals).
[START_GROUP_NUMBER:10]

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

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

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

|}

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

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

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play.
[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. 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}}
|
* type
* 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}}
|
* type
* 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 the ways in their tokens.

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

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

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Unknown.

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

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

|}

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

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

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can 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 WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

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

[SPHERE_ALIGNMENT:TREES:512]

|}

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

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

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

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

|}

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

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

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

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}
|
| The civ will send out these sorts of adventurers in worldgen.

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

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

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

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

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

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

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

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

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Intended to cause visiting diplomats to be accompanied by a pair of soldiers. Does not work due to a long-standing bug.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
|

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

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Causes merchants to be accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| No known effect.

|-
| {{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. 0 means that no population requirement is needed for interaction, but only appears to apply to diplomacy and trade and is ignored by sieges. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. 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. 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. 0 corresponds to no population requirement capable of causing interaction; i.e. population changes do not cause sieges to come. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140.

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

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

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

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

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Makes the entity angry if you cut down too many trees. They will send a warning first.

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

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown.

|}

== Items and Animals Used ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
|

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Assuming it passes other checks, any creature in their list of usables (from common domestic if they have that or from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet (next time, it'll let them use mounts/pullers/pack animals of any kind as well, but I'm not sure this matters in the stock raws). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped.

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped.

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

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

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped.

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

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

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If wood is available locally, and the relevant professions are permitted, controls availability of lye, charcoal, potash and pearlash.

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| If a creature has MOUNT and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| If a creature has PACK_ANIMAL and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required currently for trading to occur.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required to have any animals at all, including those used in trading.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| If a creature has WAGON_PULLER and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.

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

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade.

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

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

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

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

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

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

|-
| {{text anchor|METAL_PREF}}
|
| Needs testing.

|-
| {{text anchor|STONE_PREF}}
|
| Enables creatures of this entity to bring stones in trade. Also seems to enable the use of metals smelted from ore, such as iron or copper.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| Causes members to be able to use wooden weapons.

|-
| {{text anchor|WOOD_ARMOR}}
|
| Causes members to be able to use wooden armor.

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

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

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

|}

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

|-
| {{text anchor|TISSUE_STYLE}}
|
*tissue???
| Presumably selects tissue to set cultural style parameters for. Needs testing.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
*length?
*???
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| ???
| Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

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

v0.31:Building token

2026-04-04T00:16:02Z

Quietust:

{{quality|Fine|22:04, 2 March 2011 (UTC)}}{{av}}

'''Building tokens''' control the functionality of custom buildings.

All custom buildings are defined as objects of type BUILDING_WORKSHOP or BUILDING_FURNACE; workshops show up in the {{K|b}}-{{K|w}} menu, while furnaces show up in the {{K|b}}-{{K|e}} menu.

You also must add any new custom buildings to the [[Entity token|civilization]] that you want to use it.

Additionally, furnaces must be designed by an [[architect]] before being constructed (and will gain [[quality]] accordingly), though they will always use the labor(s) specified in the building definition rather than ones based on the materials being used.

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

|-
| {{text anchor|NAME}}
| name
| The name of the custom building.

|-
| {{text anchor|NAME_COLOR}}
| [[Color#Modding_color|fg:bg:bright]]
| The color of the building's name when {{K|q}}uerying it. Seemingly ignored for furnaces, which are hardcoded to 4:0:1.

|-
| {{text anchor|DIM}}
| width:height
| The size of the custom building, in number of tiles. Defaults to 3:3. Maximum possible size is 31x31.

|-
| {{text anchor|WORK_LOCATION}}
| x:y
| The tile (1:1 for upper-left) in which dwarves will stand when they are performing tasks. Defaults to 3:3 (bottom-right).

|-
| {{text anchor|BUILD_LABOR}}
| [[labor token]]
| The labor required to construct the custom building. If multiple BUILD_LABOR tokens are specified, then any of the indicated labors can be used to construct the building; if none are specified, then no labors are required. For furnaces, this labor does not come into play until after the workshop has been designed by an [[architect]].

|-
| {{text anchor|BUILD_KEY}}
| key token
| The shortcut key used in the Build menu for selecting the custom building.

|-
| {{text anchor|BLOCK}}
|
* row
* tiles...
| Specifies whether or not each workshop tile blocks movement. The first parameter is the row (1 = top), and each subsequent parameter is a 0 (nonblocking) or 1 (blocking) for each column, left to right.

|-
| {{text anchor|TILE}}
|
* stage
* row
* tiles...
| Specifies the characters used to represent the custom building. The first parameter is the building stage, varying from 0 (awaiting construction) to N (completed) where N is between 1 and 3, the 2nd parameter is the row number, and each subsequent parameter is a character number (or literal character enclosed in 'quotes').

|-
| {{text anchor|COLOR}}
|
* stage
* row
* colors...
| Specifies the colors in which the custom building's tiles will be displayed. The first parameter is the building stage, the 2nd parameter is the row number, and subsequent parameters are either sets of 3 numbers (foreground:background:brightness) or the token "MAT" to use the color of the primary building material. MAT may not be available on BUILDING_FURNACEs.{{verify}}

|-
| {{text anchor|BUILD_ITEM}}
|
* quantity
* [[item token]]
* [[material token]]
| Specifies one of the objects necessary to construct the custom building. Each BUILD_ITEM can be followed by zero or more modifiers.

|-
| {{text anchor|NEEDS_MAGMA}}
|
| Specifies that one of the building's tiles (other than the WORK_LOCATION) must be hanging over [[magma]] in order for the building to function. Buildings with this token also ignore the [FUEL] token in their reactions.
|}

==Item Modifiers==
Building items have many of the same modifiers as [[Reactions#Modifiers|reagents]] in custom reactions.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [{{text anchor|REACTION_CLASS}}:X]
| Item's material has a [REACTION_CLASS] token with the appropriate ID.
|-
| [{{text anchor|HAS_MATERIAL_REACTION_PRODUCT}}:X]
| Item's material has a [MATERIAL_REACTION_PRODUCT] token with the appropriate ID.
|-
| [{{text anchor|UNROTTEN}}]
| Item must not be rotten, mainly for organic materials.
|-
| [{{text anchor|CONTAINS_LYE}}]
| Item must be a BARREL or TOOL which contains at least one item of type LIQUID_MISC made of LYE.
|-
| [{{text anchor|POTASHABLE}}]
| Alias for [CONTAINS_LYE].
|-
| [{{text anchor|NOT_WEB}}]
| Item must be collected (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| [{{text anchor|WEB_ONLY}}]
| Item must be undisturbed (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| [{{text anchor|EMPTY}}]
| If the item is a container, it must be empty.
|-
| [{{text anchor|NOT_CONTAIN_BARREL_ITEM}}]
| If the item is a container, it must not contain [[lye]] or [[milk]]. Not necessary if specifying [EMPTY].
|-
| [{{text anchor|BAG}}]
| Item must be a bag - that is, a BOX made of plant fiber, silk, yarn, or leather.
|-
| [{{text anchor|GLASS_MATERIAL}}]
| Item material must have the [IS_GLASS] token. All 3 types of [[glass]] have this token hardcoded.
|-
| [{{text anchor|BUILDMAT}}]
| Item must be a general [[building material]] - BAR, BLOCKS, BOULDER, or WOOD.
|-
| [{{text anchor|FIRE_BUILD_SAFE}}]
| Item material must be [[fire-safe]]. Only works with building materials (see above) and anvils - all others are considered unsafe.
|-
| [{{text anchor|MAGMA_BUILD_SAFE}}]
| Item material must be [[magma-safe]]. Only works with building materials (see above) and anvils - all others are considered unsafe.
|-
| [{{text anchor|CAN_USE_ARTIFACT}}]
| Item can be an Artifact.
|-
| [{{text anchor|WORTHLESS_STONE_ONLY}}]
| Item material must be non-[[economic]].
|-
| [{{text anchor|ANY_PLANT_MATERIAL}}]
| Item material must be subordinate to a PLANT object.
|-
| [{{text anchor|ANY_SILK_MATERIAL}}]
| Item material must have the [SILK] token.
|-
| [{{text anchor|ANY_YARN_MATERIAL}}]
| Item material must have the [YARN] token.
|-
| [{{text anchor|ANY_SOAP_MATERIAL}}]
| Item material must have the [SOAP] token.
|-
| [{{text anchor|ANY_LEATHER_MATERIAL}}]
| Item material must have the [LEATHER] token.
|-
| [{{text anchor|ANY_BONE_MATERIAL}}]
| Item material must have the [BONE] token.
|-
| [{{text anchor|ANY_STRAND_TISSUE}}]
| Item is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT].
|-
| [{{text anchor|ANY_SHELL_MATERIAL}}]
| Item material must have the [SHELL] token.
|-
| [{{text anchor|ANY_TOOTH_MATERIAL}}]
| Item material must have the [TOOTH] token.
|-
| [{{text anchor|ANY_HORN_MATERIAL}}]
| Item material must have the [HORN] token.
|-
| [{{text anchor|ANY_PEARL_MATERIAL}}]
| Item material must have the [PEARL] token.
|-
| [{{text anchor|USE_BODY_COMPONENT}}]
| Item must be a body part (CORPSE or CORPSEPIECE).
|-
| [{{text anchor|NO_EDGE_ALLOWED}}]
| Item must not have an edge - excludes sharp stones (produced using knapping) and most types of weapon/ammo.
|-
| [{{text anchor|NOT_ENGRAVED}}]
| Item has not been engraved (excludes memorial slabs).
|-
| [{{text anchor|METAL_ORE}}:X]
| Item material must be an ore of the specified metal.
|-
| [{{text anchor|MIN_DIMENSION}}:X]
| Item's dimension must be at least this large. The item type must be BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, or CLOTH for this to work.
|-
| [{{text anchor|HAS_TOOL_USE}}:X]
| Item must be a [[tool]] with the specific TOOL_USE value. The item type must be TOOL:NONE for this to make any sense.
|}

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

v0.34:Position token

2026-04-03T14:51:08Z

Quietust: /* Responsibilities */

{{quality|Exceptional|18:14, 28 April 2011 (UTC)}}{{av}}
These tokens define positions in entity_*.txt files. See [[Entity token]].
==Position Tokens==
These tokens belong in an entity definition. These tokens apply to a position (such as monarch) and should follow the [POSITION:POSITION_NAME] token.

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

|-
| {{text anchor|ACCOUNT_EXEMPT}}
|
| The position holder is not subjected to the economy. Less than relevant right now.

|-
| {{text anchor|ALLOWED_CLASS}}
| {{token|CREATURE_CLASS|creature}} Token
| Only creatures with the specified class token can be appointed to this position.

|-
| {{text anchor|ALLOWED_CREATURE}}
| CREATURE:CASTE
| Restricts the position to only the defined caste. Only works with a caste of the entity's current race (If the entity had multiple CREATURE: tokens)

|-
| {{text anchor|APPOINTED_BY}}
| position
| This position can only be chosen to the task from the nobles screen, and is available only if there is an *argument* present. For example, the GENERAL is [APPOINTED_BY:MONARCH]. Contrast [ELECTED]. Being appointed by a MONARCH seems to handle a lot of worldgen stuff and interferes with fort mode titles.

|-
| {{text anchor|BRAG_ON_KILL}}
|
| A creature that kills this position will be sure to talk about it a lot.

|-
| {{text anchor|CHAT_WORTHY}}
|
| In adventure mode, when referencing locations an NPC may mention this position holder living there or having done some deed there.

|-
| {{text anchor|COLOR}}
| color
| Creatures of this position will have this color, instead of their profession color. e.g. [COLOR:5:0:1]

|-
| {{text anchor|COMMANDER}}
| position:ALL
| This position will act as a commander of the specified position{{verify}}. E.g. GENERAL is [COMMANDER:LIEUTENANT:ALL]. Unknown if values other than ALL work.

|-
| {{text anchor|CONQUERED_SITE}}
|
| This position is the puppet ruler left behind at a conquered site.

|-
| {{text anchor|DEMAND_MAX}}
| number (0-100)
| How many [[demand]]s at one time the position can make of the population.

|-
| {{text anchor|DETERMINES_COIN_DESIGN}}
|
| Minted [[coin]]s will have images that reflect the personality of this position holder.

|-
| {{text anchor|DO_NOT_CULL}}
|
| The position won't be culled from Legends as "unimportant" during world generation.

|-
| {{text anchor|DUTY_BOUND}}
|
| Members of this position will never agree to 'join' your character during adventure mode.

|-
| {{text anchor|ELECTED}}
|
| The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY].

|-
| {{text anchor|EXECUTION_SKILL}}
| weapon skill
| A mandatory subtag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for his work.

|-
| {{text anchor|EXPORTED_IN_LEGENDS}}
|
| The various members who have filled this role will be listed in the civilisation's history.

|-
| {{text anchor|FLASHES}}
|
| The creature holding this position will visibly flash, like legendary citizens. Represents a properly noble station by default.

|-
| {{text anchor|GENDER}}
| male/female
| The position can only be held by specified gender.

|-
| {{text anchor|KILL_QUEST}}
|
| The position can assign quests to adventurers.

|-
| {{text anchor|LAND_HOLDER}}
| importance tier (1-10)
| The position is a title bestowed by the King. The outpost liaison may offer to appoint a citizen to this position once the wealth requirements given in the LAND_HOLDER_TRIGGER in the entity definition has been met.

|-
| {{text anchor|LAND_NAME}}
| string
| The name the area takes on when under the control of a LAND_HOLDER. E.g. for the DUKE, [LAND_NAME:a duchy]

|-
| {{text anchor|MANDATE_MAX}}
| number (0-100)
| The maximum number of [[mandate]]s the position can make at once.

|-
| {{text anchor|MENIAL_WORK_EXEMPTION}}
|
| The position cannot be assigned labours, and will generally just lounge around like nobles do. Currently does not actually work. {{bug|3721}}

|-
| {{text anchor|MENIAL_WORK_EXEMPTION_SPOUSE}}
|
| The spouse of the position holder doesn't have to work, either. Also doesn't work either. {{bug|3721}}

|-
| {{text anchor|MILITARY_SCREEN_ONLY}}
|
| This position can not be appointed from the nobles screen. Intended for militia captains and other squad leaders to reduce clutter.

|-
| {{text anchor|NAME}}
| singular:plural
| The name of the position.

|-
| {{text anchor|NAME_MALE}}
| singular:plural
| If the creature holding the position is male, this is the position's name. E.g. for MONARCH, [NAME_MALE:king:kings]

|-
| {{text anchor|NAME_FEMALE}}
| singular:plural
| If the creature holding the position is female, this is the position's name. E.g. for MONARCH, [NAME_FEMALE:queen:queens]

|-
| {{text anchor|NUMBER}}
|
* number/AS_NEEDED
| How many of the position there should be. If the [SITE] token exists, this is per site, otherwise this is per civilisation.

|-
| {{text anchor|PRECEDENCE}}
| number (0-30000)
| How important the position is in society; a lower number is more important and displayed higher in the Nobles menu. For MONARCH it's 1, for MILITIA_CAPTAIN it's 200.

|-
| {{text anchor|PUNISHMENT_EXEMPTION}}
|
| The position holder will not be held accountable for his or her crimes. Does not appear to work. {{bug|4589}}

|-
| {{text anchor|QUEST_GIVER}}
|
| The position holder can give quests in Adventurer mode. Functionality in 0.31.13 and later is uncertain.

|-
| {{text anchor|REJECTED_CLASS}}
| {{token|CREATURE_CLASS|creature}} Token
| Creatures of the specified class cannot be appointed to this position.

|-
| {{text anchor|REJECTED_CREATURE}}
| CREATURE:CASTE
| Restricts position holders by CREATURE type.

|-
| {{text anchor|REPLACED_BY}}
| position
| This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR].

|-
| {{text anchor|REQUIRED_BEDROOM}}
| number (0-1000000)
| The position holder requires a bedroom with at least this value.

|-
| {{text anchor|REQUIRED_BOXES}}
| number (0-100)
| The position holder requires at least this many [[box]]es (i.e. chests or coffers).

|-
| {{text anchor|REQUIRED_CABINETS}}
| number (0-100)
| The position holder requires at least this many [[cabinet]]s.

|-
| {{text anchor|REQUIRED_DINING}}
| number (0-1000000)
| The position holder requires a dining room with at least this value.

|-
| {{text anchor|REQUIRED_OFFICE}}
| number (0-1000000)
| The position holder requires an office with at least this value.

|-
| {{text anchor|REQUIRED_RACKS}}
| number (0-100)
| The position holder requires at least this many [[weapon rack]]s.

|-
| {{text anchor|REQUIRED_STANDS}}
| number (0-100)
| The position holder requires at least this many [[armor stand]]s.

|-
| {{text anchor|REQUIRED_TOMB}}
| number (0-1000000)
| The position holder requires a tomb with at least this value.

|-
| {{text anchor|REQUIRES_POPULATION}}
| number
| The position requires the population to be at least this number before it becomes available or before the position holder will move in.

|-
| {{text anchor|RESPONSIBILITY}}
| responsibility
| The position holder does a thing. See the table below for suitable arguments.

|-
| {{text anchor|RULES_FROM_LOCATION}}
|
| The position holder is the main ruler of his site and tends to stay there. {{verify}} This token is also required for custom position to appear in fortresses and town keeps in adventure mode, like randomly generated lords/ladies.

|-
| {{text anchor|SITE}}
|
| The civilisation will attempt to have this position separate for each site.

|-
| {{text anchor|SLEEP_PRETENSION}}
|
| The position holder will get upset if someone with a higher PRECEDENCE holds quarters with a greater value than their own.

|-
| {{text anchor|SPECIAL_BURIAL}}
|
| The civilisation will inter the corpse of the position holder in a special grave, either in catacombs or in monuments. If that grave is disturbed, the position holder can return as a mummy. {{verify}}

|-
| {{text anchor|SPOUSE}}
| singular:plural
| The name of the position holder's spouse.

|-
| {{text anchor|SPOUSE_FEMALE}}
| singular:plural
| If the spouse of the creature holding the position is female, this is the spouse's position name.

|-
| {{text anchor|SPOUSE_MALE}}
| singular:plural
| If the spouse of the creature holding the position is male, this is the spouse's position name.

|-
| {{text anchor|SQUAD}}
| number:singular:plural
| The position holder is authorized to form a military squad, led by themselves. The number denotes the maximum headcount. The noun used to describe the subordinates (e.g. royal guard) may be a relic from the 40d era.{{verify}}

|-
| {{text anchor|SUCCESSION}}
|
* BY_HEIR / BY_POSITION:position
| How a new position holder is chosen. A single position can have multiple BY_POSITION tokens.

|}

== Responsibilities ==
{| {{prettytable}}
|- bgcolor="#dddddd"
! Argument
! Description

|-
| {{text anchor|ACCOUNTING}}
| Found on bookkeeper. Position will use Record Keeper skill to keep track of stocks.

|-
| {{text anchor|ATTACK_ENEMIES}}
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}

|-
| {{text anchor|BUILD_MORALE}}
| Found on [[champion]]. Citizens get a special thought for "talking to a pillar of society" when speaking to this noble.

|-
| {{text anchor|COLLECT_TAXES}}
| Found on tax collector. Position goes around and collects the tax money from the populace, under armed escort. Only functions if the dwarven [[economy]] is active, which never happens.

|-
| {{text anchor|EQUIPMENT_MANIFESTS}}
| Has no effect.

|-
| {{text anchor|ESCORT_TAX_COLLECTOR}}
| Found on hammerer. Position serves as one of the tax collector's bodyguards during his rounds. Only functions if the dwarven [[economy]] is active, which never happens.

|-
| {{text anchor|ESTABLISH_COLONY_TRADE_AGREEMENTS}}
| Found on outpost liaison. Position will live in the civilization capital and travels to make trade agreements with its colonies.

|-
| {{text anchor|EXECUTIONS}}
| Found on hammerer. Position executes death penalties with a weapon of the appropriate skill.

|-
| {{text anchor|HEALTH_MANAGEMENT}}
| Found on chief medical dwarf. Position will use Diagnostician skill enable the {{key|z}}-menu health screen.

|-
| {{text anchor|LAW_ENFORCEMENT}}
| Found on sheriff/captain of the guard. Position and its subordinates are in charge of punishing criminals.

|-
| {{text anchor|LAW_MAKING}}
| Found on monarch/landholders. Seems to allow position to receive elf and human diplomats.{{verify}}

|-
| {{text anchor|MAKE_INTRODUCTIONS}}
| Found on diplomat. Allows Elves to make "first contact".

|-
| {{text anchor|MAKE_PEACE_AGREEMENTS}}
| Found on diplomat. Position negotiates peace treaties in order to end wars.

|-
| {{text anchor|MAKE_TOPIC_AGREEMENTS}}
| Found on diplomat. Position negotiates special agreements such as tree cutting quotas.

|-
| {{text anchor|MANAGE_PRODUCTION}}
| Found on manager. Position enables the use of workshop profiles and uses the Organizer skill to process work orders entered in the job manager after the fortress population reaches 20.

|-
| {{text anchor|MEET_WORKERS}}
| Found on expedition leader/mayor. Position holds meetings with unhappy citizens and tries to pacify them with happy thoughts.

|-
| {{text anchor|MILITARY_GOALS}}
| Found on monarch/landholder/leaders. Effect unknown.{{verify}}

|-
| {{text anchor|MILITARY_STRATEGY}}
| Found on general/militia commander. During worldgen, position will go on expeditions to tame exotic creatures.{{verify}}

|-
| {{text anchor|PATROL_TERRITORY}}
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}

|-
| {{text anchor|RECEIVE_DIPLOMATS}}
| Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats and liaisons.

|-
| {{text anchor|RELIGION}}
| Found on elven druid. Position informs you about worship cults{{verify}}

|-
| {{text anchor|SORT_AMMUNITION}}
| Has no effect.

|-
| {{text anchor|TAME_EXOTICS}}
| Has no effect.

|-
| {{text anchor|TRADE}}
| Found on broker. Position will use Appraisal skill to display value estimates and trade at the depot when set to broker only. When applied to other civilizations, the position will arrive with the caravan to make trade agreements.

|-
| {{text anchor|UPGRADE_SQUAD_EQUIPMENT}}
| Has no effect.

|}

== Related Tokens ==
The following two ENTITY tokens are not actually position tokens, but bear mentioning on this page because they can modify the way that a civilization's positions behave:

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

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* landholder tier
* population
* wealth exported
* created wealth
| Defines the requirements for the noble ruler promotions. The tier numbers determine which position is used.

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

|}

== Why Won't My Positions Appear? ==
The way DF determines what positions will actually ''appear'' in your fortress is somewhat counterintuitive and fairly limiting. This guide should help you understand what you can do to actually get your positions working properly.

There are five tokens governing which positions appear in your fortress - LAND_HOLDER, REQUIRES_POPULATION, APPOINTED_BY, ELECTED, and REPLACED_BY. The first two determine when your fortress is eligible for a new position, the next two determine how a new position for which your fortress is eligible can be added, and the fifth allows you to clear up obsolete positions. Unfortunately, they also interact in some strange ways that makes creating interesting position structures difficult.

When you start a new fortress, DF compiles a list of your initial positions. To do this, it looks at the requirements for each position - any position whose only requirement is less than seven dwarves (either because they have no requirement tokens, or because their only requirement tokens are [REQUIRES_POPULATION: =< 7] or [LAND_HOLDER:some trigger whose only requirement is some number of dwarves equal to or less than 7]). Most importantly, ''any'' position whose only requirement is a LAND_HOLDER requirement, regardless of what the trigger for that requirement is, will be added if another eligible starting position is REPLACED_BY it. '''A non-LAND_HOLDER position that is REPLACED_BY a LAND_HOLDER position will never appear.''' With this list compiled, the game culls all positions that are REPLACED_BY another eligible position, and then culls all positions that have the APPOINTED_BY token. '''You may not embark with any appointed positions.''' Any remaining positions are then filled by a dwarf chosen at random.

'''Positions do not automatically appear when you reach their requirements.''' For example, if you remove the ELECTED token from the Mayor, then the Mayor will never appear, even once you reach his required number of dwarves. '''For a position that does not appear at embark to appear in your fortress, it must be APPOINTED_BY another position or ELECTED.'''

Naturally, this is more complicated than it looks. '''APPOINTED_BY positions must be appointed by another position already in your fortress, or a civ-level position. Only LAND_HOLDER positions may be appointed by civ-level positions.''' LAND_HOLDER positions that are APPOINTED_BY civ-level positions are inherently tied to civ-level tokens with the ESTABLISH_COLONY_TRADE_AGREEMENTS responsibility. If a fortress meets the LAND_HOLDER_TRIGGER for a new LAND_HOLDER tier when a caravan leaves, then the next time the outpost liaison or equivalent arrives, he will offer to make you an official colony, which will allow you to select all positions for that LAND_HOLDER level. '''Each time he appears, the outpost liaison will only promote your fortress one tier up the LAND_HOLDER track.''' The biggest problem with this system is that you may set your LAND_HOLDER_TRIGGERS such that you are eligible for the first tier of LAND_HOLDER positions at embark. '''If you are eligible for the first tier of LAND_HOLDER positions at embark, then all first-tier positions will appear twice - once at embark, and again when the outpost liaison comes to appoint you to the first tier.'''

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