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 "40d:Stone token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(almost forgot this)
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{av}}
+
{{quality|Exceptional|21:19, 30 March 2011 (UTC)}}{{av}}
 
Stones are stored in the matgloss_stone_*.txt files. These include soils, layer stones, minerals, and gems.
 
Stones are stored in the matgloss_stone_*.txt files. These include soils, layer stones, minerals, and gems.
  
Line 5: Line 5:
 
|- style='background-color:#ddd'
 
|- style='background-color:#ddd'
 
! Token
 
! Token
 +
! Arguments
 
! Description
 
! Description
 +
 
|-
 
|-
|[NAME:name]||The name of the stone.
+
| {{text anchor|NAME}}
 +
| name
 +
| The name of the stone.
 +
 
 
|-
 
|-
|[STONE_NAME:name]||The name of the stone when mined out. Used for "nuggets" of native metals.
+
| {{text anchor|STONE_NAME}}
 +
| name
 +
| The name of the stone when mined out. Used for "nuggets" of native metals.
 +
 
 
|-
 
|-
|[GEM:singular:plural]||Makes the stone drop rough gems instead of chunks of rock. The plural form can be "STP", which just appends an "s" to the end.
+
| {{text anchor|GEM}}
 +
|
 +
* singular
 +
* plural
 +
| Makes the stone drop rough gems instead of chunks of rock. The plural form can be "STP", which just appends an "s" to the end.
 +
 
 
|-
 
|-
|[TILE:num]||What number tile is used to represent unmined stone of this type. See [[character table]].
+
| {{text anchor|TILE}}
 +
| num
 +
| What number tile is used to represent unmined stone of this type. See [[Main:character table|character table]]. Defaults to 219 [█].
 +
 
 
|-
 
|-
|[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.
+
| {{text anchor|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.
 +
 
 
|-
 
|-
|[THREAD_METAL:metal:chance]||Allows strands to be extracted from the metal at a {{L|craftsdwarf's workshop}}.
+
| {{text anchor|THREAD_METAL}}
 +
|
 +
* metal
 +
* chance
 +
| Allows strands to be extracted from the metal at a [[craftsdwarf's workshop]].
 +
 
 
|-
 
|-
|[DEEP]||Causes the stone to occur near {{L|Eerie glowing pit|Hidden Fun Stuff}}.
+
| {{text anchor|DEEP}}
 +
|
 +
| Causes the stone to occur near [[Eerie glowing pit|Hidden Fun Stuff]].
 +
 
 
|-
 
|-
|[REACTION_CLASS:name]||Categorizes the stone for usage in certain reactions. Used for flux stones.
+
| {{text anchor|REACTION_CLASS}}
 +
| name
 +
| Categorizes the stone for usage in certain [[reaction]]s. Used in vanilla for [[flux]] stones.
 +
 
 
|-
 
|-
|[ITEM_SYMBOL:]||Specifies the tile used to represent mined stones (but not rough gems). Defaults to 7 [•].
+
| {{text anchor|ITEM_SYMBOL}}
 +
| num
 +
| Specifies the tile used to represent mined stones (but not rough gems). Defaults to 7 [•].
 +
 
 
|-
 
|-
|[COLOR:x:y:z]||Specifies the {{L|color}} of the stone, mined or unmined.
+
| {{text anchor|COLOR}}
 +
|
 +
* fg
 +
* bg
 +
* bright
 +
| Sets the [[color]] of the stone for all situations. Equivalent to {{token|TILE_COLOR|st|fg:bg:bright}}, {{token|BUILD_COLOR|st|bg:fg:X}} (if a and b are equal, X is 1, otherwise it is 0), and {{token|BASIC_COLOR|st|fg:bright}}
 +
 
 
|-
 
|-
|[TILE_COLOR:x:y:z]||Overrides the color of tiles bearing the unmined stone, as well as {{L|engraving}}s in this material.
+
| {{text anchor|TILE_COLOR}}
 +
|
 +
* fg
 +
* bg
 +
* bright
 +
| Sets the color of tiles bearing the unmined stone, as well as [[engraving]]s in this material. Defaults to 7:7:1 (white with light gray background).
 +
 
 
|-
 
|-
|[BUILD_COLOR:x:y:z]||Overrides the color of stone objects which use both the foreground and background color, such as {{L|door}}s and {{L|floodgate}}s.
+
| {{text anchor|BUILD_COLOR}}
 +
|
 +
* fg
 +
* bg
 +
* bright
 +
| Sets the color of stone objects which use both the foreground and background color, such as [[door]]s and [[floodgate]]s. Defaults to 7:7:1 (white with light gray background).
 +
 
 
|-
 
|-
|[BASIC_COLOR:x:y]||Overrides the color of stone objects which use only the foreground color, including workshops, floors/boulders, and smoothed walls.
+
| {{text anchor|BASIC_COLOR}}
 +
|
 +
* fg
 +
* bright
 +
| Sets the color of stone objects which use only the foreground color, including workshops, floors/boulders, and smoothed walls. Defaults to 7:0 (light gray).
 +
 
 
|-
 
|-
|[AQUIFER]||Allows the stone to support an {{L|aquifer}}.
+
| {{text anchor|VALUE}}
 +
| num
 +
| The [[value]] of the stone. Defaults to 1.
 +
 
 
|-
 
|-
|[METAMORPHIC]||Classifies the stone as a {{L|metamorphic layer}}.
+
| {{text anchor|AQUIFER}}
 +
|
 +
| Allows the stone to support an [[aquifer]].
 +
 
 
|-
 
|-
|[SEDIMENTARY]||Classifies the stone as a {{L|sedimentary layer}}.
+
| {{text anchor|METAMORPHIC}}
 +
|
 +
| Causes the stone to form [[metamorphic layer]]s.
 +
 
 
|-
 
|-
|[SOIL]||Classifies the material as a {{L|soil}} layer. Mining is faster and produces no stones.
+
| {{text anchor|SEDIMENTARY}}
 +
|
 +
| Causes the stone to form [[sedimentary layer]]s.
 +
 
 
|-
 
|-
|[SOIL_OCEAN]||Classifies the material as a {{L|soil|pelagic sediment}} layer. Mining is faster and produces no stones.
+
| {{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.
 +
 
 
|-
 
|-
|[SOIL_SAND]||Classifies a soil layer as {{L|sand}}, permitting it to be used for making {{L|glass}}. Must be used with [SOIL] (or presumably also [SOIL_OCEAN])
+
| {{text anchor|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.
+
| {{text anchor|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 {{token|SOIL|st}}.
 +
 
 
|-
 
|-
|[SEDIMENTARY_OCEAN_DEEP]||Allows an already [SEDIMENTARY] stone layer to appear underneath deep ocean regions.
+
| {{text anchor|SEDIMENTARY_OCEAN_SHALLOW}}
 +
|
 +
| Allows an already {{token|SEDIMENTARY|st}} stone layer to appear underneath shallow ocean regions.
 +
 
 +
|-
 +
| {{text anchor|SEDIMENTARY_OCEAN_DEEP}}
 +
|
 +
| Allows an already {{token|SEDIMENTARY|st}} stone layer to appear underneath deep ocean regions.
 +
 
 +
|-
 +
| {{text anchor|IGNEOUS_INTRUSIVE}}
 +
|
 +
| Causes the stone to form [[igneous intrusive layer]]s.
 +
 
 
|-
 
|-
|[IGNEOUS_INTRUSIVE]||Classifies the stone as an {{L|igneous intrusive layer}}.
+
| {{text anchor|IGNEOUS_EXTRUSIVE}}
 +
|
 +
| Causes the stone to form [[igneous extrusive layer]]s.
 +
 
 
|-
 
|-
|[IGNEOUS_EXTRUSIVE]||Classifies the stone as an {{L|igneous extrusive layer}}.
+
| {{text anchor|ENVIRONMENT}}
 +
|
 +
* class
 +
* type
 +
* freq
 +
| Specifies what types of layers will contain this mineral. See below.
 +
 
 
|-
 
|-
|[ENVIRONMENT:]||Specifies what types of layers will contain this mineral. See below.
+
| {{text anchor|ENVIRONMENT_SPEC}}
 +
|
 +
* stone
 +
* type
 +
* freq
 +
| Specifies which specific minerals will contain this mineral. See below.
 +
 
 
|-
 
|-
|[ENVIRONMENT_SPEC:]||Specifies which specific minerals will contain this mineral. See below.
+
| {{text anchor|LAVA}}
 +
|
 +
| Causes the stone to line the edges of [[magma pool]]s and [[magma pipe]]s, and causes the stone to be formed when [[water]] and [[magma]] are mixed.
 +
 
 
|-
 
|-
|[LAVA]||Causes the stone to line the edges of {{L|magma pool}}s and {{L|magma pipe}}s, and causes the stone to be formed when {{L|water}} and {{L|magma}} are mixed.
+
| {{text anchor|SHARP}}
 +
|
 +
| Allows the stone to be made into weapons having {{token|CAN_STONE|wp}}.
 +
 
 
|-
 
|-
|[SHARP]||Allows the stone to be made into weapons having {{L|Weapon token|[CAN_STONE]}}.
+
| {{text anchor|GLASS}}
 +
|
 +
| Allows rough gems of this material to be used to make [[crystal glass]].
 +
 
 
|-
 
|-
|[GLASS]||Allows rough gems of this material to be used to make crystal {{L|glass}}.
+
| {{text anchor|SPEC_HEAT}}
 +
| num
 +
| The specific heat capacity of the stone. Defaults to 800.
 +
 
 
|-
 
|-
|[SPEC_HEAT:]||The specific heat capacity of the stone.
+
| {{text anchor|HEATDAM_POINT}}
 +
| num
 +
| The temperature at which heat will begin to damage the stone. Defaults to NONE.
 +
 
 
|-
 
|-
|[HEATDAM_POINT:]||The temperature at which heat will begin to damage the stone.
+
| {{text anchor|COLDDAM_POINT}}
 +
| num
 +
| The temperature at which frost will begin to damage the stone. Defaults to NONE.
 +
 
 
|-
 
|-
|[COLDDAM_POINT:]||The temperature at which frost will begin to damage the stone.
+
| {{text anchor|IGNITE_POINT}}
 +
| num
 +
| The temperature at which the stone will burst into flames. Defaults to NONE.
 +
 
 
|-
 
|-
|[IGNITE_POINT:]||The temperature at which the stone will burst into flames.
+
| {{text anchor|MELTING_POINT}}
 +
| num
 +
| The temperature at which the stone will melt. Defaults to 11500.
 +
 
 
|-
 
|-
|[MELTING_POINT:]||The temperature at which the stone will melt.
+
| {{text anchor|BOILING_POINT}}
 +
| num
 +
| The temperature at which the stone will boil into a cloud of vapor. Defaults to 14000.
 +
 
 
|-
 
|-
|[BOILING_POINT:]||The temperature at which the stone will boil into a cloud of vapor.
+
| {{text anchor|FIXED_TEMP}}
 +
| num
 +
| The temperature this stone emits naturally. Defaults to NONE.
 +
 
 
|-
 
|-
|[SOLID_DENSITY:]||The density of the stone when solid.
+
| {{text anchor|SOLID_DENSITY}}
 +
| num
 +
| The density of the stone when solid. Defaults to 2670.
 +
 
 
|-
 
|-
|[LIQUID_DENSITY:]||The density of the stone when molten.
+
| {{text anchor|LIQUID_DENSITY}}
 +
| num
 +
| The density of the stone when molten. Defaults to 3300.
 
|}
 
|}
  
Line 84: Line 226:
 
Format:
 
Format:
 
* [ENVIRONMENT:<class>:<inclusion type>:<frequency>]
 
* [ENVIRONMENT:<class>:<inclusion type>:<frequency>]
** class may be ALL_STONE, IGNEOUS_ALL, METAMORPHIC, SEDIMENTARY, IGNEOUS_INTRUSIVE, IGNEOUS_EXTRUSIVE, ALLUVIAL, SOIL, SOIL_OCEAN, or SOIL_SAND.
+
** 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>]  
 
* [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.
  
 
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.
 
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 layer stone will tend to reuse the same type of inclusions, leading to multiple clusters of the same type of opal rather than several different types.  
+
Anecdotal evidence suggests that each stone layer (as seen on the Embark screen) in each biome will tend to reuse the same type of inclusions, leading to multiple clusters of the same type of stones and gems rather than numerous different types (and causing important gems such as [[rock crystal]]s to be incredibly rare).
 +
 
 +
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}}
  
 
{{Category|Modding}}
 
{{Category|Modding}}
 
{{Category|Tokens}}
 
{{Category|Tokens}}

Latest revision as of 23:58, 24 June 2025

This article is about an older version of DF.

Stones are stored in the matgloss_stone_*.txt files. These include soils, layer stones, minerals, and gems.

Token Arguments Description
 NAME name The name of the stone.
 STONE_NAME name The name of the stone when mined out. Used for "nuggets" of native metals.
 GEM
  • singular
  • plural
Makes the stone drop rough gems instead of chunks of rock. The plural form can be "STP", which just appends an "s" to the end.
 TILE num What number tile is used to represent unmined stone of this type. See character table. Defaults to 219 [█].
 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 Causes the stone to occur near Hidden Fun Stuff.
 REACTION_CLASS name Categorizes the stone for usage in certain reactions. Used in vanilla for flux stones.
 ITEM_SYMBOL num Specifies the tile used to represent mined stones (but not rough gems). Defaults to 7 [•].
 COLOR
  • fg
  • bg
  • bright
Sets the color of the stone for all situations. Equivalent to [TILE_COLOR:fg:bg:bright], [BUILD_COLOR:bg:fg:X] (if a and b are equal, X is 1, otherwise it is 0), and [BASIC_COLOR:fg:bright]
 TILE_COLOR
  • fg
  • bg
  • bright
Sets the color of tiles bearing the unmined stone, as well as engravings in this material. Defaults to 7:7:1 (white with light gray background).
 BUILD_COLOR
  • fg
  • bg
  • bright
Sets the color of stone objects which use both the foreground and background color, such as doors and floodgates. Defaults to 7:7:1 (white with light gray background).
 BASIC_COLOR
  • fg
  • bright
Sets the color of stone objects which use only the foreground color, including workshops, floors/boulders, and smoothed walls. Defaults to 7:0 (light gray).
 VALUE num The value of the stone. Defaults to 1.
 AQUIFER Allows the stone to support an aquifer.
 METAMORPHIC Causes the stone to form metamorphic layers.
 SEDIMENTARY Causes the stone 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 Allows an already [SEDIMENTARY] stone layer to appear underneath shallow ocean regions.
 SEDIMENTARY_OCEAN_DEEP Allows an already [SEDIMENTARY] stone layer to appear underneath deep ocean regions.
 IGNEOUS_INTRUSIVE Causes the stone to form igneous intrusive layers.
 IGNEOUS_EXTRUSIVE Causes the stone 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 magma pipes, and causes the stone to be formed when water and magma are mixed.
 SHARP Allows the stone to be made into weapons having [CAN_STONE].
 GLASS Allows rough gems of this material to be used to make crystal glass.
 SPEC_HEAT num The specific heat capacity of the stone. Defaults to 800.
 HEATDAM_POINT num The temperature at which heat will begin to damage the stone. Defaults to NONE.
 COLDDAM_POINT num The temperature at which frost will begin to damage the stone. Defaults to NONE.
 IGNITE_POINT num The temperature at which the stone will burst into flames. Defaults to NONE.
 MELTING_POINT num The temperature at which the stone will melt. Defaults to 11500.
 BOILING_POINT num The temperature at which the stone will boil into a cloud of vapor. Defaults to 14000.
 FIXED_TEMP num The temperature this stone emits naturally. Defaults to NONE.
 SOLID_DENSITY num The density of the stone when solid. Defaults to 2670.
 LIQUID_DENSITY num The density of the stone when molten. Defaults to 3300.

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.

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 stone layer (as seen on the Embark screen) in each biome will tend to reuse the same type of inclusions, leading to multiple clusters of the same type of stones and gems rather than numerous different types (and causing important gems such as rock crystals to be incredibly rare).

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