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.

40d:Matgloss token

From Dwarf Fortress Wiki
Revision as of 22:07, 24 November 2009 by Quietust (talk | contribs) (these most definitely exist - in fact, they're listed in "file changes.txt")
Jump to navigation Jump to search

Preliminary information on tokens used in the material description files, stored at raw/objects/matgloss_*.txt in the default distribution.

These files begin with the filename as the other raws do, then [OBJECT:MATGLOSS]. Individual entries begin with [MATGLOSS_METAL:ID], [MATGLOSS_PLANT:ID], [MATGLOSS_STONE:ID], or [MATGLOSS_WOOD:ID].

General tokens

Token Description
NAME The name of the material
ADJ The adjective applied to objects made of the item
COLOR The color of the material. Note that the background is not always used (i.e. bars, stones)
BASIC_COLOR The color of raw stones and gems.
VALUE The value multiplier of the material. Not wood?
SPEC_HEAT The specific heat of the material, in units of J/kg·K. Only on metal and stone?
MELTING_POINT See temperature scale.
BOILING_POINT See temperature scale.
SOLID_DENSITY Density in kg/m3.
DEEP Hidden fun stuff.

Metal-specific tokens

Token Description
TILE the tile (character or 437 ordinal) for the material while still in the ground (trees, plants, rough walls)
WEAPON Can be made into a melee weapon, excluding picks.
WEAPON_RANGED Can be made into a ranged weapon, like a crossbow.
DIGGER Can be made into a pick.
AMMO Can be made into bolts.
ANVIL Can be made into anvils.
ANY_USE Can be made into miscellaneous items like mechanisms.
BRITTLE Makes it impossible to create anything but bars of that type of metal.
DAMAGE_PERC, BLOCK_PERC Weapons and armors' effectiveness respectively. Relative to Iron.
WAFERS Wafers are produced instead of bars. Requires triple the amount normally to create items. Required for metal cloth?[Verify]

Wood-specific tokens

Some of these are also on plants.

  • AUTUMNCOLOR - changes color with the seasons
  • WET, DRY - Same as for plants
  • SAPLING - Young trees are called saplings instead of e.g. "young tower-cap"
  • BIOME
  • PREFSTRING
  • SAPLING_TILE, SAPLING_COLOR - appearance of tree saplings (not used in default raws)
  • DEAD_SAPLING_TILE, DEAD_SAPLING_COLOR - appearance of dead tree saplings (not used in default raws)

Plant-specific tokens

See Plant tokens.

Stone-specific tokens

  • STONE_NAME - Loose stones are called this, e.g. for "nuggets" vs native metal
  • [METAL_ORE:<metal>:<percentage>] - automatically creates a smelter reaction requiring fuel and one stone to make one bar.
    • Multiple METAL_ORE tokens mean that there is a percentage chance of each metal - c.f. tetrahedrite or galena.
  • [THREAD_METAL:<metal>:<percentage>] - allows strand extraction at craftsdwarf's workshop.
  • ITEM_SYMBOL: Loose stones use this tile. Used to make bituminous coal show up as ☼ and ores as *.
  • LAVA - lines the magma pipe; formed with water + magma
  • SHARP - can be made into CAN_STONE weapons
  • GLASS - rock crystal.
  • [GEM:singular:plural] - the stone drops gems, instead of loose stones. The plural can be STP, which seems to be short for "standard plural", i.e. just add an S after the singular.

Layer types

Note: Soils are considered to be a subtype of stone in the raws.

A stone material can be tagged with one of:

  • [SEDIMENTARY]
  • [IGNEOUS_INTRUSIVE]
  • [IGNEOUS_EXTRUSIVE]
  • [METAMORPHIC]
  • [SOIL]
  • [SOIL_OCEAN]

Additionally these can occur:

  • [SEDIMENTARY_OCEAN_SHALLOW]
  • [SEDIMENTARY_OCEAN_DEEP]
  • [SOIL_SAND] - can be made into glass
  • [AQUIFER] - aquifers can be in these layers

Layer tags are not mutually exclusive with ENVIRONMENT tags.

ENVIROMENT and ENVIRONMENT_SPEC

Format:

  • [ENVIRONMENT:<class>:<inclusion type>:<frequency>]
    • class may also be ALL_STONE, IGNEOUS_ALL, ALLUIVAL.
  • [ENVIRONMENT_SPEC:<id>:<inclusion type>:<frequency>]

The inclusion type can be CLUSTER, CLUSTER_SMALL, CLUSTER_ONE, or VEIN. CLUSTERs are large ovoids that occupy their entire local map tile if present. CLUSTER_SMALL inclusions are blobs of 3-9 tiles; CLUSTER_ONE inclusions are single tiles; and VEINs are large streaks.

If no CLUSTER is present, then zero to two VEINs as well as roughly five to seven other clusters will be present in the local map tile.

Anecdotal evidence suggests that each z-layer will tend to reuse the same type of inclusions, leading to multiple clusters of the same type of opal rather than several different types.

Tokens not found in the raws

These do not appear in any shipped raw file. They were found in the EXE. We can only speculate as to their syntax and meaning. Athough, some are obvious. Others may be easily discovered by modding. It is unknown whether any of these do anything.

  • LIQUID_DENSITY
  • BUILD_COLOR
  • TILE_COLOR
  • DROWN_LEVEL - water level at which shrubs die
  • SAPLING_DROWN_LEVEL - water level at which saplings die
  • TREE_DROWN_LEVEL - water level at which trees die (unused)