v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "v0.31:Material definition token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(almost definitely has always been this way)
 
(77 intermediate revisions by 24 users not shown)
Line 1: Line 1:
{{av}}
+
{{quality|Exceptional|18:11, 28 April 2011 (UTC)}}{{av}}
 
 
==Material Tokens==
 
 
 
The following tokens can be used in material templates, as well as materials defined in other raw files.
 
  
 +
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}}
 
{| {{prettytable}}
|- bgcolor="#ddd"
+
|- bgcolor="#C0C0C0"
 
! Token
 
! Token
 
! Arguments
 
! Arguments
Line 13: Line 11:
  
 
|-
 
|-
| MATERIAL_TEMPLATE
+
| PREFIX
|
+
| * string
*id
+
| 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.'''
| The name of the material template. Used when defining a template in material template files; the id is used as an argument when calling for material templates elsewhere.
 
  
 
|-
 
|-
| STATE_COLOR
+
| STONE_NAME
|
+
| * string
*state
+
| Overrides the name of mined out stones (used for native copper/silver/gold/platinum to make them be called "nuggets").
*color
 
| The state may be SOLID, LIQUID, GAS, POWDER, SOLID_POWDER, ALL_SOLID, or ALL.
 
Color comes from descriptor_color_standard.txt and is used to describe the color of the material.
 
[STATE_COLOR:ALL_SOLID:GREY]
 
  
 
|-
 
|-
| STATE_NAME
+
| IS_GEM
 
|
 
|
*state
+
* name
*name
+
* plural
| The name of the material as displayed in-game.
+
* state
[STATE_COLOR:ALL_SOLID:stone]
+
| 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.
  
 
|-
 
|-
| STATE_ADJ
+
| TEMP_DIET_INFO
|
+
|  
*state
+
* type
*adjective
+
| 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.
| Like STATE_NAME, but used in different situations. Equipment made from the material uses the adjective.
 
  
 
|-
 
|-
| STATE_NAME_ADJ
+
| POWDER_DYE
|
+
| [[color]] token
*state
+
| Defines the material as a type of dye.
*name/adjective
 
| Sets both STATE_NAME and STATE_ADJ at the same time.
 
  
 
|-
 
|-
| DISPLAY_COLOR
+
| TILE
|
+
| [[Main:Character table|tile]]
*foreground color
+
| Specifies the tile that will be used to represent unmined tiles made of this material. Generally only used with stones. Defaults to 219 ('█').
*background color
 
*forground brightness
 
| The on-screen color of the material. Uses a standard 3-digit {{L|Color token}}
 
[DISPLAY_COLOR:7:0:0]
 
  
 
|-
 
|-
| MATERIAL_VALUE
+
| ITEM_SYMBOL
|
+
| tile
*value
+
| Specifies the tile that will be used to represent BOULDER objects made of this material. Generally only used with stones. Defaults to 7 ('•').
| Value modifier for the material.
 
  
 
|-
 
|-
| SPEC_HEAT
+
| DISPLAY_COLOR
 
|
 
|
*specific heat capacity
+
*foreground color
| See {{L|SPEC HEAT}}
+
*background color
 +
*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]
  
 
|-
 
|-
| IGNITE_POINT
+
| BUILD_COLOR
 
|
 
|
*temperature
+
*foreground color
| Temperature at which the material will catch fire. May be set to NONE.
+
*background color
 +
*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).
  
 
|-
 
|-
| MELTING_POINT
+
| TILE_COLOR
 
|
 
|
*temperature
+
*foreground color
| Temperature at which the material melts. May be set to NONE.
+
*background color
 +
*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).
  
 
|-
 
|-
| BOILING_POINT
+
| BASIC_COLOR
 
|
 
|
*temperature
+
*color
| Temperature at which the material boils. May be set to NONE.
+
*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).
  
 
|-
 
|-
| HEATDAM_POINT
+
| STATE_COLOR
 
|
 
|
*temperature
+
*state
| Temperature at which the material takes heat damage. May be set to NONE. If the material has an ignite point but no heatdam point it may burn for very long time.{{verify}}
+
*[[color]] token
 +
| The state may be SOLID, LIQUID, GAS, POWDER/SOLID_POWDER, PASTE/SOLID_PASTE, PRESSED/SOLID_PRESSED, ALL_SOLID, or ALL.
 +
Color comes from descriptor_color_standard.txt and is used to indicate the color of the material. The nearest color value is used to display contaminants and body parts made of this material.
 +
[STATE_COLOR:ALL_SOLID:GREY]
  
 
|-
 
|-
| COLDDAM_POINT
+
| STATE_NAME
 
|
 
|
*temperature
+
*state
| Temperature at which the material takes cold damage. May be set to NONE.
+
*name
 +
| The name of the material as displayed in-game.
 +
[STATE_NAME:ALL_SOLID:stone]
  
 
|-
 
|-
| MAT_FIXED_TEMP
+
| STATE_NAME_ADJ
 
|
 
|
*temperature
+
*state
| Constant temperature of the material. May be set to NONE.
+
*name/adjective
 +
| Sets both STATE_NAME and STATE_ADJ at the same time.
  
 
|-
 
|-
| SOLID_DENSITY
+
| STATE_ADJ
 
|
 
|
*density
+
*state
| Affects the weight of the material. Also affects combat calculations; affects blunt-force damage and ability of edged weapons to pierce tissue layers.{{verify}}
+
*adjective
 +
| Like STATE_NAME, but used in different situations. Equipment made from the material uses the state adjective and not the state name.
  
 
|-
 
|-
| LIQUID_DENSITY
+
| ABSORPTION
 
|
 
|
*density
+
*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.
 
 
|-
 
| MOLAR_MASS
 
|
 
*n
 
| Supposedly not used.
 
  
 
|-
 
|-
 
| IMPACT_YIELD
 
| IMPACT_YIELD
 
|
 
|
*n
+
*value
| used for blunt-force combat.
+
| Specifies how hard of an impact the material can withstand before it will deform. Used for blunt-force combat. Defaults to 10000.
  
 
|-
 
|-
 
| IMPACT_FRACTURE
 
| IMPACT_FRACTURE
 
|
 
|
*n
+
*value
| used for blunt-force combat.
+
| Specifies how hard of an impact the material can withstand before it will break. Used for blunt-force combat. Defaults to 10000.
  
 
|-
 
|-
| IMPACT_ELASTICITY
+
| IMPACT_STRAIN_AT_YIELD or IMPACT_ELASTICITY
 
|
 
|
*n
+
*value
| used for blunt-force combat.
+
| Specifies how much the material will deform when subjected to an impact.{{verify}} 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)
  
 
|-
 
|-
 
| COMPRESSIVE_YIELD
 
| COMPRESSIVE_YIELD
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how hard the material can be compressed before it will deform. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.
  
 
|-
 
|-
 
| COMPRESSIVE_FRACTURE
 
| COMPRESSIVE_FRACTURE
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how hard the material can be compressed before it will break. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.
  
 
|-
 
|-
| COMPRESSIVE_ELASTICITY
+
| COMPRESSIVE_STRAIN_AT_YIELD or COMPRESSIVE_ELASTICITY
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how much the material will deform when compressed.{{verify}} [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 0.
  
 
|-
 
|-
 
| TENSILE_YIELD
 
| TENSILE_YIELD
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how hard the material can be stretched before it will deform. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.
  
 
|-
 
|-
 
| TENSILE_FRACTURE
 
| TENSILE_FRACTURE
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how hard the material can be stretched before it will break. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.
  
 
|-
 
|-
| TENSILE_ELASTICITY
+
| TENSILE_STRAIN_AT_YIELD or TENSILE_ELASTICITY
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how much the material will deform when stretched.{{verify}} [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 0.
  
 
|-
 
|-
 
| TORSION_YIELD
 
| TORSION_YIELD
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how hard the material can be twisted before it will deform. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.
  
 
|-
 
|-
 
| TORSION_FRACTURE
 
| TORSION_FRACTURE
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how hard the material can be twisted before it will break. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.
  
 
|-
 
|-
| TORSION_ELASTICITY
+
| TORSION_STRAIN_AT_YIELD or TORSION_ELASTICITY
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how much the material will deform when twisted.{{verify}} [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 0.
  
 
|-
 
|-
 
| SHEAR_YIELD
 
| SHEAR_YIELD
 
|
 
|
*n
+
*value
| Used for cutting calculations.
+
| Specifies how hard the material can be sheared before it will deform. Used for cutting calculations. Defaults to 10000.
  
 
|-
 
|-
 
| SHEAR_FRACTURE
 
| SHEAR_FRACTURE
 
|
 
|
*n
+
*value
| Used for cutting calculations.
+
| Specifies how hard the material can be sheared before it will break. Used for cutting calculations. Defaults to 10000.
  
 
|-
 
|-
| SHEAR_ELASTICITY
+
| SHEAR_STRAIN_AT_YIELD or SHEAR_ELASTICITY
 
|
 
|
*n
+
*value
| Used for cutting calculations.
+
| Specifies how much the material will deform when sheared.{{verify}} Used for cutting calculations. Defaults to 0.
  
 
|-
 
|-
| BENDING_YIELD
+
| BENDING_YIELD  
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how hard the material can be bent before it will deform. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.
  
 
|-
 
|-
 
| BENDING_FRACTURE
 
| BENDING_FRACTURE
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how hard the material can be bent before it will break.  [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.
  
 
|-
 
|-
| BENDING_ELASTICITY
+
| BENDING_STRAIN_AT_YIELD or BENDING_ELASTICITY
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| Specifies how much the material will deform when bent.{{verify}} [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 0.
  
 
|-
 
|-
 
| MAX_EDGE
 
| MAX_EDGE
 
|
 
|
*n
+
*value
| How sharp the material is. Used in cutting calculations.
+
| 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.
  
 
|-
 
|-
| ABSORPTION
+
| MATERIAL_VALUE
 
|
 
|
*n
+
*value
| Supposedly not used.
+
| 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.
  
 
|-
 
|-
| ITEMS_HARD
+
| MULTIPLY_VALUE
 
|
 
|
 +
*value
 +
| Multiplies the value of the material. '''Not permitted in material template definitions.'''
  
 
|-
 
|-
| ITEMS_QUERN
+
| SPEC_HEAT
 
|
 
|
 +
*specific heat capacity
 +
| Rate at which the material heats up or cools down. See [[SPEC HEAT]] for more information. Defaults to NONE.
  
 
|-
 
|-
| ITEMS_WEAPON
+
| 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.
  
 
|-
 
|-
| ITEMS_WEAPON_RANGED
+
| COLDDAM_POINT
 
|
 
|
 +
*temperature
 +
| Temperature below which the material takes damage from cold. Defaults to NONE.
  
 
|-
 
|-
| ITEMS_AMMO
+
| IGNITE_POINT
 
|
 
|
 +
*temperature
 +
| Temperature at which the material will catch fire. Defaults to NONE.
  
 
|-
 
|-
| ITEMS_DIGGER
+
| MELTING_POINT
 
|
 
|
 +
*temperature
 +
| Temperature at which the material melts. Defaults to NONE.
  
 
|-
 
|-
| ITEMS_ANVIL
+
| BOILING_POINT
 
|
 
|
 +
*temperature
 +
| Temperature at which the material boils. Defaults to NONE.
  
 
|-
 
|-
| ITEMS_ARMOR
+
| MAT_FIXED_TEMP
 
|
 
|
 +
*temperature
 +
| Constant temperature emitted by the material. Defaults to NONE.
  
 
|-
 
|-
| ITEMS_SIEGE_ENGINE
+
| 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.'''
  
 
|-
 
|-
| ITEMS_BARRED
+
| 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.'''
  
 
|-
 
|-
| ITEMS_SCALED
+
| 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.'''
  
 
|-
 
|-
| ITEMS_LEATHER
+
| 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.'''
  
 
|-
 
|-
| ITEMS_SOFT
+
| 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.'''
  
 
|-
 
|-
| ITEMS_DELICATE
+
| 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.'''
  
 
|-
 
|-
| IS_STONE
+
| 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.
  
 
|-
 
|-
| IS_METAL
+
| LIQUID_DENSITY
 
|
 
|
 +
*density
 +
| Specifies the density of the material when in liquid form. Defaults to NONE.
  
 
|-
 
|-
| IS_GLASS
+
| MOLAR_MASS
 
|
 
|
 +
*value
 +
| Supposedly not used. Defaults to NONE.
  
 
|-
 
|-
| IS_GEM
+
| 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.
 +
 
 +
|-
 +
| 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.
  
 
|-
 
|-
| IMPLIES_ANIMAL_KILL
+
| MEAT_NAME
 
|
 
|
| Makes the elves angry if you try to trade something made from this material
+
*prefix
 +
*name
 +
*adjective
 +
| When a creature is butchered, meat yielded from organs made from this material will be named via this token.
  
 
|-
 
|-
| ALCOHOL_PLANT
+
| BLOCK_NAME
 
|
 
|
 +
*singular
 +
*plural
 +
| Specifies the name of [[block]]s made from this material.
  
 
|-
 
|-
| ALCOHOL_CREATURE
+
| 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]
  
 
|-
 
|-
| CHEESE_PLANT
+
| REACTION_CLASS
 
|
 
|
 +
*reaction reference
 +
| Used to classify all items made of the material so that reactions can use them as generic reagents.
  
 
|-
 
|-
| CHEESE_CREATURE
+
| HARDENS_WITH_WATER
 
|
 
|
 +
* [[material token]]
 +
| Allows the material to be used to make [[healthcare|casts]].
  
 
|-
 
|-
| POWDER_MISC_PLANT
+
| SOAP_LEVEL
 
|
 
|
 +
*value
 +
| Unknown. Defaults to 0.
 +
|}
 +
 +
==Material Usage Tokens==
 +
{| {{prettytable}}
 +
|- bgcolor="#C0C0C0"
 +
! Token
 +
! Arguments
 +
! Description
  
 
|-
 
|-
| POWDER_MISC_CREATURE
+
| IMPLIES_ANIMAL_KILL
 
|
 
|
 +
| Lets the game know that an animal was likely killed in the production of this item. Elves (and other entities that are ethically opposed to killing animals) will likely not bring these for trade.
  
 
|-
 
|-
| STOCKPILE_GLOB
+
| ALCOHOL_PLANT
 
|
 
|
 +
| Classifies the material as plant alcohol, allowing it to be stored in food stockpiles under "Drink (Plant)".
  
 
|-
 
|-
| LIQUID_MISC_PLANT
+
| ALCOHOL_CREATURE
 
|
 
|
 +
| Classifies the material as creature alcohol, allowing it to be stored in food stockpiles under "Drink (Animal)".
  
 
|-
 
|-
| LIQUID_MISC_CREATURE
+
| ALCOHOL
 
|
 
|
 +
| Classifies the material as generic alcohol. Implied by both ALCOHOL_PLANT and ALCOHOL_CREATURE. Exact behavior unknown.
  
 
|-
 
|-
| LIQUID_MISC_OTHER
+
| CHEESE_PLANT
 
|
 
|
 +
| Classifies the material as plant cheese, allowing it to be stored in food stockpiles under "Cheese (Plant)".
  
 
|-
 
|-
| STRUCTURAL_PLANT_MAT
+
| CHEESE_CREATURE
 
|
 
|
 +
| Classifies the material as creature cheese, allowing it to be stored in food stockpiles under "Cheese (Animal)".
  
 
|-
 
|-
| SEED_MAT
+
| CHEESE
 
|
 
|
 +
| Classifies the material as generic cheese. Implied by both CHEESE_PLANT and CHEESE_CREATURE. Exact behavior unknown.
  
 
|-
 
|-
| LEAF_MAT
+
| POWDER_MISC_PLANT
 
|
 
|
 +
| Classifies the material as plant powder, allowing it to be stored in food stockpiles under "Milled Plant".
  
 
|-
 
|-
| BONE
+
| POWDER_MISC_CREATURE
 
|
 
|
 +
| Classifies the material as creature powder, allowing it to be stored in food stockpiles under "Bone Meal".
  
 
|-
 
|-
| THREAD_PLANT
+
| POWDER_MISC
 
|
 
|
 +
| Classifies the material as generic powder. Implied by both POWDER_MISC_PLANT and POWDER_MISC_CREATURE. Exact behavior unknown.
  
 
|-
 
|-
| TOOTH
+
| STOCKPILE_GLOB or STOCKPILE_GLOB_SOLID
 
|
 
|
 +
| Permits globs of the material in solid form to be stored in food stockpiles under "Fat" - without it, dwarves will come by and "clean" the items, destroying them (unless [DO_NOT_CLEAN_GLOB] is also included).
  
 
|-
 
|-
| HORN
+
| STOCKPILE_GLOB_PASTE
 
|
 
|
 +
| Permits globs of the material in paste form to be stored in food stockpiles under "Paste".
  
 
|-
 
|-
| SHELL
+
| STOCKPILE_GLOB_PRESSED
 
|
 
|
 +
| Permits globs of the material in pressed form to be stored in food stockpiles under "Pressed Material".
  
 
|-
 
|-
| SILK
+
| LIQUID_MISC_PLANT
 
|
 
|
 +
| Classifies the material as a plant extract, allowing it to be stored in food stockpiles under "Extract (Plant)".
  
 
|-
 
|-
| GENERATES_MIASMA
+
| LIQUID_MISC_CREATURE
 
|
 
|
 +
| Classifies the material as a creature extract, allowing it to be stored in food stockpiles under "Extract (Animal)".
  
 
|-
 
|-
| ROTS
+
| LIQUID_MISC_OTHER
 
|
 
|
 +
| Classifies the material as a miscellaneous liquid, allowing it to be stored in food stockpiles under "Misc. Liquid" along with lye.
  
 
|-
 
|-
| BLOOD_MAP_DESCRIPTOR
+
| LIQUID_MISC
 
|
 
|
 +
| Classifies the material as a generic liquid. Implied by LIQUID_MISC_PLANT, LIQUID_MISC_CREATURE, and LIQUID_MISC_OTHER. Exact behavior unknown.
  
 
|-
 
|-
| ICHOR_MAP_DESCRIPTOR
+
| STRUCTURAL_PLANT_MAT
 
|
 
|
 +
| Classifies the material as plant, allowing it to be stored in food stockpiles under "Plants".
  
 
|-
 
|-
| GOO_MAP_DESCRIPTOR
+
| SEED_MAT
 
|
 
|
 +
| Classifies the material as plant seed, allowing it to be stored in food stockpiles under "Seeds".
  
 
|-
 
|-
| SLIME_MAP_DESCRIPTOR
+
| LEAF_MAT
 
|
 
|
 +
| Classifies the material as plant leaf, allowing it to be stored in food stockpiles under "Leaves".
  
 
|-
 
|-
| PUS_MAP_DESCRIPTOR
+
| BONE
 
|
 
|
 +
| Classifies the material as bone, allowing it to be used by craftsdwarves.
  
 
|-
 
|-
| EDIBLE_VERMIN
+
| WOOD
 
|
 
|
| Can be eaten by vermin.
+
| Classifies the material as wood, allowing it to be used by carpenters. May also make elves angry if you try to trade it to them.
  
 
|-
 
|-
| EDIBLE_RAW
+
| THREAD_PLANT
 
|
 
|
| Can be eaten raw.
+
| Classifies the material as plant fiber, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".
  
 
|-
 
|-
| EDIBLE_COOKED
+
| TOOTH
 
|
 
|
| Can be cooked and then eaten.
+
| Classifies the material as tooth, allowing it to be used by craftsdwarves.
  
 
|-
 
|-
| CRYSTAL_GLASSABLE
+
| HORN
 
|
 
|
| Can be used in the production of crystal glass
+
| Classifies the material as horn, allowing it to be used by craftsdwarves.
  
 
|-
 
|-
| STONE_NAME
+
| PEARL
 
|
 
|
| Name of stones mined out if material is a stone.
+
| Classifies the material as pearl, allowing it to be used by craftsdwarves.
  
 
|-
 
|-
| OVERWRITE_SOLID
+
| SHELL
 
|
 
|
 +
| Classifies the material as shell, allowing it to be used by craftsdwarves.
  
 
|-
 
|-
| TEMP_DIET_INFO
+
| LEATHER
 
|
 
|
 +
| Classifies the material as leather, allowing it to be used by craftsdwarves.
  
 
|-
 
|-
| SLIME
+
| SILK
 
|
 
|
 +
| Classifies the material as silk, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".
  
 
|-
 
|-
| ICHOR
+
| SOAP
 
|
 
|
 +
| Classifies the material as soap, permitting it to be stored in Bar/Block stockpiles with Soap enabled.{{verify}}
  
 
|-
 
|-
| GOO
+
| GENERATES_MIASMA
 
|
 
|
 +
| Material generates miasma when it rots
  
 
|-
 
|-
| FILTH
+
| MEAT
 
|
 
|
 +
| Classifies the material as edible meat.{{verify}}
  
 
|-
 
|-
| POWDER_DYE
+
| ROTS
 
|
 
|
 +
| Material will rot if not stockpiled appropriately
  
 
|-
 
|-
| ITEM_SYMBOL
+
| 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.").
  
 
|-
 
|-
| IF_EXISTS_SET_HEATDAM_POINT
+
| ICHOR_MAP_DESCRIPTOR
 
|
 
|
*temperature
+
| Tells the game to classify contaminants of this material as being "ichor".
 +
 
 +
|-
 +
| GOO_MAP_DESCRIPTOR
 
|
 
|
 +
| Tells the game to classify contaminants of this material as being "goo".
  
 
|-
 
|-
| IF_EXISTS_SET_COLDDAM_POINT
+
| SLIME_MAP_DESCRIPTOR
|
 
*temperature
 
 
|
 
|
 +
| Tells the game to classify contaminants of this material as being "slime".
  
 
|-
 
|-
| IF_EXISTS_SET_IGNITE_POINT
+
| PUS_MAP_DESCRIPTOR
|
 
*temperature
 
 
|
 
|
 +
| Tells the game to classify contaminants of this material as being "pus".
  
 
|-
 
|-
| IF_EXISTS_SET_MELTING_POINT
+
| ENTERS_BLOOD
|
 
*temperature
 
 
|
 
|
 +
| Used for materials which cause [[syndrome]]s, causes it to enter the creature's blood instead of simply spattering on the surface.
  
 
|-
 
|-
| IF_EXISTS_SET_BOILING_POINT
+
| EDIBLE_VERMIN
|
 
*temperature
 
 
|
 
|
 +
| Can be eaten by vermin.
  
 
|-
 
|-
| IF_EXISTS_SET_MAT_FIXED_TEMP
+
| EDIBLE_RAW
|
 
*temperature
 
 
|
 
|
 +
| Can be eaten raw.
  
 
|-
 
|-
| EXTRACT_STORAGE
+
| EDIBLE_COOKED
 
|
 
|
 +
| Can be cooked and then eaten.
  
 
|-
 
|-
| BUTCHER_SPECIAL
+
| DO_NOT_CLEAN_GLOB
 
|
 
|
*item type
+
| Prevents globs made of this material from being cleaned up and destroyed.
*NONE
 
| All instances in the material templates have NONE as the second argument. Possibly subtype?
 
[BUTCHER_SPECIAL:MEAT:NONE]
 
[BUTCHER_SPECIAL:GLOB:NONE]
 
  
 
|-
 
|-
| MEAT_NAME
+
| NO_STONE_STOCKPILE
 
|
 
|
*prefix
+
| Prevents the material from showing up in Stone stockpile settings.
*name
 
*adjective?
 
| When the creature is butchered, its organs will be named via this token.
 
  
 
|-
 
|-
| MATERIAL_REACTION_PRODUCT
+
| ITEMS_METAL
 
|
 
|
*reaction reference
+
| Effect unknown
*LOCAL_CREATURE_MAT
 
*material
 
| Used with reaction raws to preserve material source from reagent to product. First argument comes from HAS_MATERIAL_REACTION_PRODUCT in reaction raws. Second argument is always LOCAL_CREATURE_MAT in templates but could be others.
 
[MATERIAL_REACTION_PRODUCT:TAN_MAT:LOCAL_CREATURE_MAT:LEATHER]
 
  
 
|-
 
|-
| HARDENS_WITH_WATER
+
| ITEMS_BARRED
 
|
 
|
 +
| [[Bone]] items (clothes with [BARRED]) can be made from this material.
  
 
|-
 
|-
| SOAP_LEVEL
+
| ITEMS_SCALED
|
 
*n
 
 
|
 
|
 +
| [[Shell]] items (clothes with [SCALED]) can be made from this material.
  
 
|-
 
|-
| MULTIPLY_VALUE
+
| ITEMS_LEATHER
 
|
 
|
*value
+
| [[Leather]] items (clothes with [LEATHER]) can be made from this material.
| Multiplies the value of the selected material. Seen in local creature materials.
 
 
 
|}
 
 
 
 
 
==Syndrome Tokens==
 
 
 
The following tokens are used to define syndromes associated with a material.
 
 
 
{|{{prettytable}}
 
|- bgcolor="#ddd"
 
! Token
 
! Arguments
 
! Description
 
  
 
|-
 
|-
| SYNDROME
+
| ITEMS_SOFT
 
|
 
|
| Begin defining a syndrome.
+
| Soft clothing items, backpacks and quivers, and siege engine parts can be made from this material.
  
 
|-
 
|-
| SYN_NAME
+
| ITEMS_HARD
 
|
 
|
*string
+
| Furniture, medical supplies, and crafts can be made out of this material.
| Name of the syndrome.
 
  
 
|-
 
|-
| SYN_INJECTED
+
| IS_STONE
 
|
 
|
| Syndrome is contracted if injected via creature attack.
+
| Used to define that said material is stone. Allows storage in stone stockpiles, among other effects.
  
 
|-
 
|-
| SYN_CONTACT
+
| UNDIGGABLE
|
+
|  
| Syndrome is contracted if material contaminent (water covering, for example) is present on the body.
+
| Used for a stone that cannot be dug into.
  
 
|-
 
|-
| SYN_INHALED
+
| DISPLAY_UNGLAZED
 
|
 
|
| Syndrome is contracted if dust, vapor, or gas is inhaled.
+
| Causes containers made of this material to be prefixed with "unglazed" if they have not yet been [[glaze]]d.
  
 
|-
 
|-
| SYN_AFFECTED_CLASS
+
| YARN
 
|
 
|
*creature class
+
| Classifies the material as yarn, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".
| Which creature classes can contract the syndrome. ALL does not make every creature susceptible.
 
  
 
|-
 
|-
| SYN_IMMUNE_CLASS
+
| STOCKPILE_THREAD_METAL
 
|
 
|
*creature class
+
| Classifies the material as metal thread, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Metal)" and "Cloth (Metal)".
| Which creature classes are immune to the syndrome.
 
  
 
|-
 
|-
| SYN_AFFECTED_CREATURE
+
| IS_METAL
 
|
 
|
*creature
+
| Defines the material as being metal, allowing it to be used at forges.
*caste
 
| ALL is a valid argument for the second parameter.
 
  
 
|-
 
|-
| SYN_IMMUNE_CREATURE
+
| IS_GLASS
 
|
 
|
*creature
+
| Used internally by green glass, clear glass, and crystal glass.
*caste
 
| ALL is a valid argument for the second parameter. Be sure to give this to venomous creatures, especially those with contact or inhaled poisons.
 
  
 
|-
 
|-
| Effect
+
| CRYSTAL_GLASSABLE
 
|
 
|
| See below
+
| Can be used in the production of crystal glass, in theory. In practice, thanks to [http://www.bay12games.com/dwarves/mantisbt/view.php?id=1498 bug 1498], this token does nothing.
  
|}
+
|-
 
+
| ITEMS_WEAPON
===Effect token===
+
|
 
+
| Melee [[Weapon#Manufactured weapons|weapons]] can be made out of this material.
Effect tokens are added to a syndrome in the following format:
 
 
 
[effect:SEV:n:PROB:n:special:START:n:PEAK:n:END:n:special]
 
 
 
The following effects can be used, most of which are self-explanatory:
 
 
 
*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
 
 
 
The other arguments and special tokens are as follows. Special tokens can be used before or after the START, PEAK, and END.
 
 
 
{|{{prettytable}}
 
|- bgcolor="#ddd"
 
! Token
 
! Arguments
 
! Description
 
  
 
|-
 
|-
| SEV
+
| ITEMS_WEAPON_RANGED
 
|
 
|
*n
+
| Ranged weapons can be made out of this material.
| Severity of the effect. Number can presumably exceed 100.{{verify}}
 
  
 
|-
 
|-
| PROB
+
| ITEMS_ANVIL
 
|
 
|
*percentage
+
| [[Anvil]]s can be made out of this material.
| Probability of the effect. Probably a percentage.
 
  
 
|-
 
|-
| START, PEAK, END
+
| ITEMS_AMMO
 
|
 
|
*n
+
| [[Weapon#Ammunition|Ammunition]] can be made out of this material.
| Timespan of the effect. The effect will increase from the starting time to the peak time, and decrease from the peak time to the end time. Symptoms without an END time will be chronic.
 
  
 
|-
 
|-
| LOCALIZED
+
| ITEMS_DIGGER
 
|
 
|
| Contact poison will only effect the area it contacts.
+
| [[Weapon#Dwarf-manufactured weapons|Picks]] can be made out of this material.
  
 
|-
 
|-
| RESISTABLE
+
| ITEMS_ARMOR
 
|
 
|
| Effect has a chance of being resisted beyond the probability. Uses disease resistance attribute?{{verify}}
+
| [[Armor]] can be made out of this material.
  
 
|-
 
|-
| ENTERS_BLOOD
+
| ITEMS_DELICATE
 
|
 
|
| Automatically makes creatures who don't have blood immune
+
| Used internally by amber and coral.
  
 
|-
 
|-
| VASCULAR_ONLY
+
| ITEMS_SIEGE_ENGINE
 
|
 
|
| Only affects vascular tissue.
+
| Siege engine parts can be made out of this material. Does not appear to work.
  
 
|-
 
|-
| MUSCULAR_ONLY
+
| ITEMS_QUERN
 
|
 
|
| Only affects muscule tissue.
+
| Querns and millstones can be made out of this material.{{verify}}
 +
|}
 +
 
 +
==Syndrome tokens==
 +
 
 +
{| {{prettytable}}
 +
|- bgcolor="#C0C0C0"
 +
! Token
 +
! Arguments
 +
! Description
 +
 
 +
|-
 +
| SYN_NAME
 +
| text
 +
| defines the name of the syndrome
  
 
|-
 
|-
| BP
+
| SYN_INJECTED
|
+
* BY_TYPE, BY_TOKEN, or BY_CATEGORY
+
| syndrome can be contracted by injection (by a creature)
* body type, token, or category
+
 
* tissue? ALL works here
+
|-
| The effect will only affect a particular body part.
+
| SYN_CONTACT
BP:BY_TYPE:THOUGHT:ALL
+
 +
| syndrome can be contracted on contact (e.g. poison dust or liquid)
 +
 
 +
|-
 +
| SYN_INHALED
 +
 +
| syndrome can be contracted by inhalation (e.g. poison vapor or gas)
 +
 
 +
|-
 +
| SYN_AFFECTED_CLASS
 +
 +
| adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON
 +
 
 +
|-
 +
| SYN_IMMUNE_CLASS
 +
 +
| makes the class of creatures immune to the syndrome
 +
 
 +
|-
 +
| SYN_AFFECTED_CREATURE
 +
| creature
 +
| adds a specific creature to those affected.
 +
 
 +
|-
 +
| SYN_IMMUNE_CREATURE
 +
| creature
 +
| makes the creature immune to the syndrome
 +
 
 +
|-
 +
| CE_PAIN<br />CE_SWELLING<br />CE_OOZING<br />CE_BRUISING<br />CE_BLISTERS<br />CE_NUMBNESS<br />CE_PARALYSIS<br />CE_FEVER<br />CE_BLEEDING<br />CE_COUGH_BLOOD<br />CE_VOMIT_BLOOD<br />CE_NAUSEA<br />CE_UNCONSCIOUSNESS<br />CE_NECROSIS<br />CE_IMPAIR_FUNCTION<br />CE_DROWSINESS<br />CE_DIZZINESS
 +
|  
 +
*SEV:<value>  (severity, higher is worse)
 +
*PROB:<value(1-100)> (probability)
 +
*RESISTABLE (optional) allows resistance
 +
*SIZE_DILUTES (optional) lessens effect based on size
 +
Place affected:
 +
*LOCALIZED (optional)
 +
*VASCULAR_ONLY (optional)
 +
*MUSCULAR_ONLY (optional)
 +
*BP: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]]
  
 
|}
 
|}
  
===Example Syndrome===
+
==See Also==
 +
* [[Inorganic material definition token]]
 +
* [[Syndrome]]
  
[SYNDROME]
+
{{Category|Modding}}
[SYN_NAME:lime disease]
+
{{Category|Tokens}}
[SYN_AFFECTED_CLASS:GENERAL_POISON]
 
[SYN_IMMUNE_CREATURE:TIGER:ALL]
 
[SYN_INHALED][SYN_CONTACT][SYN_INJECTED]
 
[CE_FEVER:SEV:50:PROB:100:RESISTABLE:START:50:PEAK:500:END:1500]
 
[CE_NAUSEA:SEV:35:PROB:100:RESISTABLE:START:50:PEAK:100:END:300]
 
[CE_DROWSINESS:SEV:75:PROB:100:RESISTABLE:START:1000:PEAK:2000:END:4000]
 
[CE_DIZZINESS:SEV:75:PROB:100:RESISTABLE:START:1000:PEAK:2000:END:3000]
 
[CE_BLEEDING:SEV:50:PROB:100:LOCALIZED:VASCULAR_ONLY:START:10:PEAK:500:END:600:SIZE_DILUTES]
 
[CE_NECROSIS:SEV:100:PROB:100:RESISTABLE:BP:BY_TYPE:THOUGHT:ALL:BP:BY_TYPE:NERVOUS:ALL:START:30:PEAK:60:END:1200]
 

Latest revision as of 20:10, 10 March 2014

This article is about an older version of DF.

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

Token Arguments Description
PREFIX * string 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.
STONE_NAME * string Overrides the name of mined out stones (used for native copper/silver/gold/platinum to make them be called "nuggets").
IS_GEM
  • name
  • plural
  • state
Used to indicate that said material is a gemstone - when tiles are mined out, rough gems will be yielded instead of boulders. Plural can be "STP" to automatically append an "s" to the singular form, and OVERWRITE_SOLID will override the relevant STATE_NAME and STATE_ADJ values.
TEMP_DIET_INFO
  • type
Specifies what the material should be treated as when drinking water contaminated by it, for generating unhappy thoughts. Valid values are BLOOD, SLIME, VOMIT, ICHOR, PUS, GOO, GRIME, and FILTH.
POWDER_DYE color token Defines the material as a type of dye.
TILE tile Specifies the tile that will be used to represent unmined tiles made of this material. Generally only used with stones. Defaults to 219 ('█').
ITEM_SYMBOL tile Specifies the tile that will be used to represent BOULDER objects made of this material. Generally only used with stones. Defaults to 7 ('•').
DISPLAY_COLOR
  • foreground color
  • background color
  • foreground brightness
The on-screen color of the material. Uses a standard 3-digit color token. Equivalent to [TILE_COLOR:a:b:c], [BUILD_COLOR:b:a:X] (X = 1 if 'a' equals 'b', 0 otherwise), and [BASIC_COLOR:a:c]
BUILD_COLOR
  • foreground color
  • background color
  • foreground brightness
The color of objects made of this material which use both the foreground and background color: doors, floodgates, hatch covers, bins, barrels, and cages. Defaults to 7:7:1 (white).
TILE_COLOR
  • foreground color
  • background color
  • foreground brightness
The color of unmined tiles containing this material (for stone and soil), as well as engravings in this material. Defaults to 7:7:1 (white).
BASIC_COLOR
  • color
  • brightness
The color of objects made of this material which use only the foreground color, including workshops, floors and boulders, and smoothed walls. Defaults to 7:1 (white).
STATE_COLOR The state may be SOLID, LIQUID, GAS, POWDER/SOLID_POWDER, PASTE/SOLID_PASTE, PRESSED/SOLID_PRESSED, ALL_SOLID, or ALL.

Color comes from descriptor_color_standard.txt and is used to indicate the color of the material. The nearest color value is used to display contaminants and body parts made of this material. [STATE_COLOR:ALL_SOLID:GREY]

STATE_NAME
  • state
  • name
The name of the material as displayed in-game.

[STATE_NAME:ALL_SOLID:stone]

STATE_NAME_ADJ
  • state
  • name/adjective
Sets both STATE_NAME and STATE_ADJ at the same time.
STATE_ADJ
  • state
  • adjective
Like STATE_NAME, but used in different situations. Equipment made from the material uses the state adjective and not the state name.
ABSORPTION
  • value
The material's tendency to absorb liquids. Containers made of materials with nonzero absorption cannot hold liquids unless they have been glazed. Defaults to 0.
IMPACT_YIELD
  • value
Specifies how hard of an impact the material can withstand before it will deform. Used for blunt-force combat. Defaults to 10000.
IMPACT_FRACTURE
  • value
Specifies how hard of an impact the material can withstand before it will break. Used for blunt-force combat. Defaults to 10000.
IMPACT_STRAIN_AT_YIELD or IMPACT_ELASTICITY
  • value
Specifies how much the material will deform when subjected to an impact.[Verify] 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)
COMPRESSIVE_YIELD
  • value
Specifies how hard the material can be compressed before it will deform. Supposedly used only during wrestling. Defaults to 10000.
COMPRESSIVE_FRACTURE
  • value
Specifies how hard the material can be compressed before it will break. Supposedly used only during wrestling. Defaults to 10000.
COMPRESSIVE_STRAIN_AT_YIELD or COMPRESSIVE_ELASTICITY
  • value
Specifies how much the material will deform when compressed.[Verify] Supposedly used only during wrestling. Defaults to 0.
TENSILE_YIELD
  • value
Specifies how hard the material can be stretched before it will deform. Supposedly used only during wrestling. Defaults to 10000.
TENSILE_FRACTURE
  • value
Specifies how hard the material can be stretched before it will break. Supposedly used only during wrestling. Defaults to 10000.
TENSILE_STRAIN_AT_YIELD or TENSILE_ELASTICITY
  • value
Specifies how much the material will deform when stretched.[Verify] Supposedly used only during wrestling. Defaults to 0.
TORSION_YIELD
  • value
Specifies how hard the material can be twisted before it will deform. Supposedly used only during wrestling. Defaults to 10000.
TORSION_FRACTURE
  • value
Specifies how hard the material can be twisted before it will break. Supposedly used only during wrestling. Defaults to 10000.
TORSION_STRAIN_AT_YIELD or TORSION_ELASTICITY
  • value
Specifies how much the material will deform when twisted.[Verify] Supposedly used only during wrestling. Defaults to 0.
SHEAR_YIELD
  • value
Specifies how hard the material can be sheared before it will deform. Used for cutting calculations. Defaults to 10000.
SHEAR_FRACTURE
  • value
Specifies how hard the material can be sheared before it will break. Used for cutting calculations. Defaults to 10000.
SHEAR_STRAIN_AT_YIELD or SHEAR_ELASTICITY
  • value
Specifies how much the material will deform when sheared.[Verify] Used for cutting calculations. Defaults to 0.
BENDING_YIELD
  • value
Specifies how hard the material can be bent before it will deform. Supposedly used only during wrestling. Defaults to 10000.
BENDING_FRACTURE
  • value
Specifies how hard the material can be bent before it will break. Supposedly used only during wrestling. Defaults to 10000.
BENDING_STRAIN_AT_YIELD or BENDING_ELASTICITY
  • value
Specifies how much the material will deform when bent.[Verify] Supposedly used only during wrestling. Defaults to 0.
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.
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.
MULTIPLY_VALUE
  • value
Multiplies the value of the material. Not permitted in material template definitions.
SPEC_HEAT
  • specific heat capacity
Rate at which the material heats up or cools down. See SPEC HEAT for more information. Defaults to NONE.
HEATDAM_POINT
  • temperature
Temperature above which the material takes damage from heat. May be set to NONE. If the material has an ignite point but no heatdam point, it will burn for a very long time (9 months and 16.8 days). Defaults to NONE.
COLDDAM_POINT
  • temperature
Temperature below which the material takes damage from cold. Defaults to NONE.
IGNITE_POINT
  • temperature
Temperature at which the material will catch fire. Defaults to NONE.
MELTING_POINT
  • temperature
Temperature at which the material melts. Defaults to NONE.
BOILING_POINT
  • temperature
Temperature at which the material boils. Defaults to NONE.
MAT_FIXED_TEMP
  • temperature
Constant temperature emitted by the material. Defaults to NONE.
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.
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.
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.
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.
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.
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.
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.
LIQUID_DENSITY
  • density
Specifies the density of the material when in liquid form. Defaults to NONE.
MOLAR_MASS
  • value
Supposedly not used. Defaults to NONE.
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 tokens. Defaults to BARREL.
BUTCHER_SPECIAL Specifies the item type used for butchering results made of this material. Stock raws use GLOB:NONE for fat and MEAT:NONE for other meat materials.
MEAT_NAME
  • prefix
  • name
  • adjective
When a creature is butchered, meat yielded from organs made from this material will be named via this token.
BLOCK_NAME
  • singular
  • plural
Specifies the name of blocks made from this material.
MATERIAL_REACTION_PRODUCT Used with reaction raws to associate a reagent material with a product material. The first argument is used by HAS_MATERIAL_REACTION_PRODUCT and GET_MATERIAL_FROM_REAGENT in reaction raws. The remainder is a material reference, generally LOCAL_CREATURE_MAT:SUBTYPE or LOCAL_PLANT_MAT:SUBTYPE or INORGANIC:STONETYPE.

[MATERIAL_REACTION_PRODUCT:TAN_MAT:LOCAL_CREATURE_MAT:LEATHER]

REACTION_CLASS
  • reaction reference
Used to classify all items made of the material so that reactions can use them as generic reagents.
HARDENS_WITH_WATER Allows the material to be used to make casts.
SOAP_LEVEL
  • value
Unknown. Defaults to 0.

Material Usage Tokens[edit]

Token Arguments Description
IMPLIES_ANIMAL_KILL Lets the game know that an animal was likely killed in the production of this item. Elves (and other entities that are ethically opposed to killing animals) will likely not bring these for trade.
ALCOHOL_PLANT Classifies the material as plant alcohol, allowing it to be stored in food stockpiles under "Drink (Plant)".
ALCOHOL_CREATURE Classifies the material as creature alcohol, allowing it to be stored in food stockpiles under "Drink (Animal)".
ALCOHOL Classifies the material as generic alcohol. Implied by both ALCOHOL_PLANT and ALCOHOL_CREATURE. Exact behavior unknown.
CHEESE_PLANT Classifies the material as plant cheese, allowing it to be stored in food stockpiles under "Cheese (Plant)".
CHEESE_CREATURE Classifies the material as creature cheese, allowing it to be stored in food stockpiles under "Cheese (Animal)".
CHEESE Classifies the material as generic cheese. Implied by both CHEESE_PLANT and CHEESE_CREATURE. Exact behavior unknown.
POWDER_MISC_PLANT Classifies the material as plant powder, allowing it to be stored in food stockpiles under "Milled Plant".
POWDER_MISC_CREATURE Classifies the material as creature powder, allowing it to be stored in food stockpiles under "Bone Meal".
POWDER_MISC Classifies the material as generic powder. Implied by both POWDER_MISC_PLANT and POWDER_MISC_CREATURE. Exact behavior unknown.
STOCKPILE_GLOB or STOCKPILE_GLOB_SOLID Permits globs of the material in solid form to be stored in food stockpiles under "Fat" - without it, dwarves will come by and "clean" the items, destroying them (unless [DO_NOT_CLEAN_GLOB] is also included).
STOCKPILE_GLOB_PASTE Permits globs of the material in paste form to be stored in food stockpiles under "Paste".
STOCKPILE_GLOB_PRESSED Permits globs of the material in pressed form to be stored in food stockpiles under "Pressed Material".
LIQUID_MISC_PLANT Classifies the material as a plant extract, allowing it to be stored in food stockpiles under "Extract (Plant)".
LIQUID_MISC_CREATURE Classifies the material as a creature extract, allowing it to be stored in food stockpiles under "Extract (Animal)".
LIQUID_MISC_OTHER Classifies the material as a miscellaneous liquid, allowing it to be stored in food stockpiles under "Misc. Liquid" along with lye.
LIQUID_MISC Classifies the material as a generic liquid. Implied by LIQUID_MISC_PLANT, LIQUID_MISC_CREATURE, and LIQUID_MISC_OTHER. Exact behavior unknown.
STRUCTURAL_PLANT_MAT Classifies the material as plant, allowing it to be stored in food stockpiles under "Plants".
SEED_MAT Classifies the material as plant seed, allowing it to be stored in food stockpiles under "Seeds".
LEAF_MAT Classifies the material as plant leaf, allowing it to be stored in food stockpiles under "Leaves".
BONE Classifies the material as bone, allowing it to be used by craftsdwarves.
WOOD Classifies the material as wood, allowing it to be used by carpenters. May also make elves angry if you try to trade it to them.
THREAD_PLANT Classifies the material as plant fiber, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".
TOOTH Classifies the material as tooth, allowing it to be used by craftsdwarves.
HORN Classifies the material as horn, allowing it to be used by craftsdwarves.
PEARL Classifies the material as pearl, allowing it to be used by craftsdwarves.
SHELL Classifies the material as shell, allowing it to be used by craftsdwarves.
LEATHER Classifies the material as leather, allowing it to be used by craftsdwarves.
SILK Classifies the material as silk, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".
SOAP Classifies the material as soap, permitting it to be stored in Bar/Block stockpiles with Soap enabled.[Verify]
GENERATES_MIASMA Material generates miasma when it rots
MEAT Classifies the material as edible meat.[Verify]
ROTS Material will rot if not stockpiled appropriately
BLOOD_MAP_DESCRIPTOR Tells the game to classify contaminants of this material as being "blood" in Adventurer mode tile descriptions ("Here we have a Dwarf in a slurry of blood.").
ICHOR_MAP_DESCRIPTOR Tells the game to classify contaminants of this material as being "ichor".
GOO_MAP_DESCRIPTOR Tells the game to classify contaminants of this material as being "goo".
SLIME_MAP_DESCRIPTOR Tells the game to classify contaminants of this material as being "slime".
PUS_MAP_DESCRIPTOR Tells the game to classify contaminants of this material as being "pus".
ENTERS_BLOOD Used for materials which cause syndromes, causes it to enter the creature's blood instead of simply spattering on the surface.
EDIBLE_VERMIN Can be eaten by vermin.
EDIBLE_RAW Can be eaten raw.
EDIBLE_COOKED Can be cooked and then eaten.
DO_NOT_CLEAN_GLOB Prevents globs made of this material from being cleaned up and destroyed.
NO_STONE_STOCKPILE Prevents the material from showing up in Stone stockpile settings.
ITEMS_METAL Effect unknown
ITEMS_BARRED Bone items (clothes with [BARRED]) can be made from this material.
ITEMS_SCALED Shell items (clothes with [SCALED]) can be made from this material.
ITEMS_LEATHER Leather items (clothes with [LEATHER]) can be made from this material.
ITEMS_SOFT Soft clothing items, backpacks and quivers, and siege engine parts can be made from this material.
ITEMS_HARD Furniture, medical supplies, and crafts can be made out of this material.
IS_STONE Used to define that said material is stone. Allows storage in stone stockpiles, among other effects.
UNDIGGABLE Used for a stone that cannot be dug into.
DISPLAY_UNGLAZED Causes containers made of this material to be prefixed with "unglazed" if they have not yet been glazed.
YARN Classifies the material as yarn, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".
STOCKPILE_THREAD_METAL Classifies the material as metal thread, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Metal)" and "Cloth (Metal)".
IS_METAL Defines the material as being metal, allowing it to be used at forges.
IS_GLASS Used internally by green glass, clear glass, and crystal glass.
CRYSTAL_GLASSABLE Can be used in the production of crystal glass, in theory. In practice, thanks to bug 1498, this token does nothing.
ITEMS_WEAPON Melee weapons can be made out of this material.
ITEMS_WEAPON_RANGED Ranged weapons can be made out of this material.
ITEMS_ANVIL Anvils can be made out of this material.
ITEMS_AMMO Ammunition can be made out of this material.
ITEMS_DIGGER Picks can be made out of this material.
ITEMS_ARMOR Armor can be made out of this material.
ITEMS_DELICATE Used internally by amber and coral.
ITEMS_SIEGE_ENGINE Siege engine parts can be made out of this material. Does not appear to work.
ITEMS_QUERN Querns and millstones can be made out of this material.[Verify]

Syndrome tokens[edit]

Token Arguments Description
SYN_NAME text defines the name of the syndrome
SYN_INJECTED syndrome can be contracted by injection (by a creature)
SYN_CONTACT syndrome can be contracted on contact (e.g. poison dust or liquid)
SYN_INHALED syndrome can be contracted by inhalation (e.g. poison vapor or gas)
SYN_AFFECTED_CLASS adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON
SYN_IMMUNE_CLASS makes the class of creatures immune to the syndrome
SYN_AFFECTED_CREATURE creature adds a specific creature to those affected.
SYN_IMMUNE_CREATURE creature makes the creature immune to the syndrome
CE_PAIN
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 Syndromes page

See Also[edit]