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:Inorganic material definition token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(Adding in undiggable tag which was introduced in 31.14 as a bug-fix)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{av}}
+
{{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.
+
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}}
 
{| {{prettytable}}
Line 8: Line 8:
 
! Description
 
! Description
 
|-
 
|-
|[METAL_ORE:metal:chance]||Allows the ore to be {{L|smelter|smelted}} into metal. Multiple tokens allow multiple types of metal to be smelted from a single ore.
+
|[WAFERS]||Used on metals, causes the metal to be made into wafers instead of [[bar]]s.
 
|-
 
|-
|[THREAD_METAL:metal:chance]||Allows strands to be extracted from the metal at a {{L|craftsdwarf's workshop}}.
+
|[DEEP_SPECIAL]||Causes the stone to form hollow tubes leading to Hell. Used for [[raw adamantine]]
 
|-
 
|-
|[DEEP_SURFACE]||Causes the stone to line the landscape of {{L|Hell}}. Used for {{L|slade}}.
+
|[METAL_ORE:metal:chance]||Allows the ore to be [[smelter|smelted]] into metal. Multiple tokens allow multiple types of metal to be smelted from a single ore.
 
|-
 
|-
|[DEEP_SPECIAL]||Causes the stone to form hollow tubes leading to Hell. Used for {{L|raw adamantine}}
+
|[THREAD_METAL:metal:chance]||Allows strands to be extracted from the metal at a [[craftsdwarf's workshop]].
 
|-
 
|-
|[AQUIFER]||Allows the stone to support an {{L|aquifer}}.
+
|[DEEP_SURFACE]||Causes the stone to line the landscape of [[Hell]]. Used for [[slade]].
 
|-
 
|-
|[METAMORPHIC]||Classifies the stone as a {{L|metamorphic layer}}.
+
|[AQUIFER]||Allows the stone to support an [[aquifer]].
 
|-
 
|-
|[SEDIMENTARY]||Classifies the stone as a {{L|sedimentary layer}}.
+
|[METAMORPHIC]||Causes the material to form [[metamorphic layer]]s.
 
|-
 
|-
|[SOIL]||Classifies the material as a {{L|soil}} layer, allowing it to appear in (almost) any biome. Mining is faster and produces no stones.
+
|[SEDIMENTARY]||Causes the material to form [[sedimentary layer]]s.
 
|-
 
|-
|[SOIL_OCEAN]||Classifies the material as a {{L|soil|pelagic sediment}} layer. Mining is faster and produces no stones.
+
|[SOIL]||Causes the material to form [[soil]] layers, allowing it to appear in (almost) any biome. Mining is faster and produces no stones.
 
|-
 
|-
|[SOIL_SAND]||Classifies the material as a {{L|sand}} layer, allowing it to appear in {{L|sand desert}}s and {{L|ocean}}s. Mining is faster and produces no stones. Sand layers can also be used used for making {{L|glass}}. Can be combined with [SOIL].
+
|[SOIL_OCEAN]||Causes the material to form [[soil|pelagic sediment]] layers. Mining is faster and produces no stones.
 
|-
 
|-
|[SEDIMENTARY_OCEAN_SHALLOW]||Allows an already [SEDIMENTARY] stone layer to appear underneath shallow ocean regions.
+
|[SOIL_SAND]||Causes the material to form [[sand]] layers, allowing it to appear in [[sand desert]]s and [[ocean]]s. Mining is faster and produces no stones. Sand layers can also be used used for making [[glass]]. Can be combined with [SOIL].
 
|-
 
|-
|[SEDIMENTARY_OCEAN_DEEP]||Allows an already [SEDIMENTARY] stone layer to appear underneath deep ocean regions.
+
|[SEDIMENTARY_OCEAN_SHALLOW]||Permits an already [SEDIMENTARY] stone layer to appear underneath shallow ocean regions.
 
|-
 
|-
|[IGNEOUS_INTRUSIVE]||Classifies the stone as an {{L|igneous intrusive layer}}.
+
|[SEDIMENTARY_OCEAN_DEEP]||Permits an already [SEDIMENTARY] stone layer to appear underneath deep ocean regions.
 
|-
 
|-
|[IGNEOUS_EXTRUSIVE]||Classifies the stone as an {{L|igneous extrusive layer}}.
+
|[IGNEOUS_INTRUSIVE]||Causes the material to form [[igneous intrusive layer]]s.
 +
|-
 +
|[IGNEOUS_EXTRUSIVE]||Causes the material to form [[igneous extrusive layer]]s.
 
|-
 
|-
 
|[ENVIRONMENT:class:type:freq]||Specifies what types of layers will contain this mineral. See below.
 
|[ENVIRONMENT:class:type:freq]||Specifies what types of layers will contain this mineral. See below.
Line 40: Line 42:
 
|[ENVIRONMENT_SPEC:stone:type:freq]||Specifies which specific minerals will contain this mineral. See below.
 
|[ENVIRONMENT_SPEC:stone:type:freq]||Specifies which specific minerals will contain this mineral. See below.
 
|-
 
|-
|[LAVA]||Causes the stone to line the edges of {{L|magma}} pools and volcanoes, and causes the stone to be formed when {{L|water}} and {{L|magma}} are mixed.
+
|[LAVA]||Causes the stone to line the edges of [[magma]] pools and volcanoes, and causes the stone to be formed when [[water]] and [[magma]] are mixed.
|-
 
|[WAFERS]||Used on metals, causes the metal to be made into wafers instead of {{L|bar}}s.
 
|-
 
|[UNDIGGABLE]||Prevents the stone from being mined out.
 
 
|}
 
|}
  
Line 56: Line 54:
 
* [ENVIRONMENT_SPEC:<id>:<inclusion type>:<frequency>]
 
* [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.
+
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.
 +
 
 +
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.
 +
 
 +
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|Modding}}
 
{{Category|Tokens}}
 
{{Category|Tokens}}

Latest revision as of 22:01, 6 February 2024

This article is about an older version of DF.

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.

Token Description
[WAFERS] Used on metals, causes the metal to be made into wafers instead of bars.
[DEEP_SPECIAL] Causes the stone to form hollow tubes leading to Hell. Used for raw adamantine
[METAL_ORE:metal:chance] Allows the ore to be smelted into metal. Multiple tokens allow multiple types of metal to be smelted from a single ore.
[THREAD_METAL:metal:chance] Allows strands to be extracted from the metal at a craftsdwarf's workshop.
[DEEP_SURFACE] Causes the stone to line the landscape of Hell. Used for slade.
[AQUIFER] Allows the stone to support an aquifer.
[METAMORPHIC] Causes the material to form metamorphic layers.
[SEDIMENTARY] Causes the material to form sedimentary layers.
[SOIL] Causes the material to form soil layers, allowing it to appear in (almost) any biome. Mining is faster and produces no stones.
[SOIL_OCEAN] Causes the material to form pelagic sediment layers. Mining is faster and produces no stones.
[SOIL_SAND] Causes the material to form sand layers, allowing it to appear in sand deserts and oceans. Mining is faster and produces no stones. Sand layers can also be used used for making glass. Can be combined with [SOIL].
[SEDIMENTARY_OCEAN_SHALLOW] Permits an already [SEDIMENTARY] stone layer to appear underneath shallow ocean regions.
[SEDIMENTARY_OCEAN_DEEP] Permits an already [SEDIMENTARY] stone layer to appear underneath deep ocean regions.
[IGNEOUS_INTRUSIVE] Causes the material to form igneous intrusive layers.
[IGNEOUS_EXTRUSIVE] Causes the material to form igneous extrusive layers.
[ENVIRONMENT:class:type:freq] Specifies what types of layers will contain this mineral. See below.
[ENVIRONMENT_SPEC:stone:type:freq] Specifies which specific minerals will contain this mineral. See below.
[LAVA] Causes the stone to line the edges of magma pools and volcanoes, and causes the stone to be formed when water and magma are mixed.

ENVIROMENT and ENVIRONMENT_SPEC[edit]

Format:

  • [ENVIRONMENT:<class>:<inclusion type>:<frequency>]
    • Class may be ALL_STONE, IGNEOUS_ALL, SOIL, SOIL_OCEAN, SOIL_SAND, METAMORPHIC, SEDIMENTARY, IGNEOUS_INTRUSIVE, IGNEOUS_EXTRUSIVE, or ALLUVIAL.
      • ALL_STONE is equivalent to METAMORPHIC, SEDIMENTARY, IGNEOUS_INTRUSIVE, IGNEOUS_EXTRUSIVE, and ALLUVIAL.
      • IGNEOUS_ALL is equivalent to IGNEOUS_INTRUSIVE and IGNEOUS_EXTRUSIVE.
  • [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.

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.

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