Material token - Revision history

Quietust: /* Tokens */ looking at the material parser logic right now, and USE_LAVA_STONE picks randomly, not looking at local geology; also, builtin

2026-02-16T14:23:26Z

Tokens: looking at the material parser logic right now, and USE_LAVA_STONE picks randomly, not looking at local geology; also, builtin

DarklingArcher: /* Hardcoded Materials */ the token for unknown material is NONE

2024-12-27T17:48:22Z

Hardcoded Materials: the token for unknown material is NONE

DarklingArcher: /* Hardcoded Materials */ -1 is a placeholder material

2024-12-27T11:59:47Z

Hardcoded Materials: -1 is a placeholder material

Quietust: /* Tokens */ just discovered INDEX###, only supported for Creature materials since version 0.34.xx

2024-12-08T02:18:14Z

Tokens: just discovered INDEX###, only supported for Creature materials since version 0.34.xx

Zippy at 16:14, 2 April 2024

2024-04-02T16:14:20Z

LethosorBot: Tagging v50 page (2727/4888)

2022-12-21T00:37:52Z

Tagging v50 page (2727/4888)

LethosorBot: LethosorBot moved page DF2014:Material token to Material token: Migrating v50 page (2636/4618) (content)

2022-12-20T03:41:42Z

LethosorBot moved page DF2014:Material token to Material token: Migrating v50 page (2636/4618) (content)

216.46.157.49: /* Tokens */ moved coal up the table, added "hardcoded materials" table heading

2022-04-21T03:30:36Z

Tokens: moved coal up the table, added "hardcoded materials" table heading

Doorkeeper at 18:58, 10 February 2022

2022-02-10T18:58:57Z

Doorkeeper: mov navbox

2022-02-10T18:58:11Z

mov navbox

@@ Line 17: / Line 17: @@
 | {{text anchor|INORGANIC}}
 | MATERIAL_NAME
-| Specifies a standalone inorganic material defined in the raws, generally a stone or metal. For example, INORGANIC:IRON refers to [[iron]], and INORGANIC:CERAMIC_PORCELAIN refers to [[porcelain]]. The material name can be substituted with USE_LAVA_STONE to automatically select the local [[Inorganic material definition token|lava stone]], which is normally [[obsidian]].
+| Specifies a standalone inorganic material defined in the raws, generally a stone or metal. For example, INORGANIC:IRON refers to [[iron]], and INORGANIC:CERAMIC_PORCELAIN refers to [[porcelain]]. The material name can be substituted with USE_LAVA_STONE to randomly select a suitable [[Inorganic material definition token|lava stone]], which is normally [[obsidian]]. Specify NONE or NO_MATGLOSS to instead select [[magma]].
 |-
@@ Line 32: / Line 32: @@
 | {{text anchor|COAL}}
 | CHARCOAL, COKE, or NO_MATGLOSS
-| Specifies a material that can be used as fuel - charcoal or coke. Specifying NO_MATGLOSS ('''not''' NONE) will make it accept "refined coal" in general, which matches charcoal, coke, and generic refined coal.
+| Specifies a material that can be used as fuel - charcoal or coke. Specifying NO_MATGLOSS ('''not''' NONE) will make it accept "refined coal" in general, matching both charcoal and coke.
 |-
@@ Line 47: / Line 47: @@
 | {{text anchor|PLANT_MAT}}
 | PLANT_ID:MATERIAL_NAME
-| Specifies a material associated with a specific plant. Example: PLANT_MAT:BUSH_QUARRY:LEAF refers to [[quarry bush]] leaves.
+| Specifies a material associated with a specific plant. Example: PLANT_MAT:BUSH_QUARRY:LEAF refers to [[quarry bush]] leaves. Unlike CREATURE_MAT, "INDEX###" is '''not''' permitted.
 |-
 | {{text anchor|LOCAL_PLANT_MAT}}
 | MATERIAL_NAME
-| Alias for PLANT_MAT:'''PLANT_ID''':MATERIAL_NAME, where PLANT_ID is the plant currently being defined; as such, it can only be used in plant definitions.
+| Alias for PLANT_MAT:'''PLANT_ID''':MATERIAL_NAME, where PLANT_ID is the plant currently being defined; as such, it can only be used in plant definitions. Unlike LOCAL_CREATURE_MAT, "INDEX###" is '''not''' permitted.
 |-
@@ Line 61: / Line 61: @@
 |-
 | {{text anchor|MATERIAL_NAME}}
-| NONE
+| NONE (ignored)
 | Specifies one of the hardcoded materials listed below. Note that this goes in the token itself, not arguments (i.e GLASS_GREEN:NONE, not MATERIAL_NAME:GLASS_GREEN).
 |}

@@ Line 75: / Line 75: @@
 ! # !! Token !! Information
 |-
-|  -1 ||  || [[Unknown material]] (light gray, solid), acts as a placeholder for any material.
+|  -1 || {{text anchor|NONE}} || [[Unknown material]] (light gray, solid), acts as a placeholder for any material.
 |-
 |  0 || {{text anchor|INORGANIC}} || [[Magma]] when specified with subtype NONE or NO_MATGLOSS, otherwise a user-defined inorganic material.

@@ Line 74: / Line 74: @@
 |- bgcolor="#ddd"
 ! # !! Token !! Information
 |-
 |  0 || {{text anchor|INORGANIC}} || [[Magma]] when specified with subtype NONE or NO_MATGLOSS, otherwise a user-defined inorganic material.

@@ Line 36: / Line 36: @@
 |-
 | {{text anchor|CREATURE_MAT}}
-| CREATURE_ID:MATERIAL_NAME
+| CREATURE_ID:MATERIAL_NAME or CREATURE_ID:INDEX###
-| Specifies a material associated with a specific creature. Examples: CREATURE_MAT:DWARF:SKIN refers to [[dwarf]] skin.
+| Specifies a material associated with a specific creature. Examples: CREATURE_MAT:DWARF:SKIN refers to [[dwarf]] skin. Can also specify "INDEX" followed by a 3-digit number to select a material by index instead of by name, where 000 is the first material in that creature.
 |-
 | {{text anchor|LOCAL_CREATURE_MAT}}
-| MATERIAL_NAME
+| MATERIAL_NAME or INDEX###
-| Alias for CREATURE_MAT:'''CREATURE_ID''':MATERIAL_NAME, where CREATURE_ID is the creature currently being defined; as such, it can only be used in creature definitions.
+| Alias for CREATURE_MAT:'''CREATURE_ID''':MATERIAL_NAME (or CREATURE_MAT:'''CREATURE_ID''':INDEX###), where CREATURE_ID is the creature currently being defined; as such, it can only be used in creature definitions.
 |-

@@ Line 1: / Line 1: @@
-{{migrated article}}
+{{Quality|Exceptional}}
 {{av}}
 :''For the tokens that define an individual material's properties, see [[Material definition token]].''

← Older revision	Revision as of 03:41, 20 December 2022
(No difference)

@@ Line 28: / Line 28: @@
 | MATERIAL_NAME
 | Alias for INORGANIC:MATERIAL_NAME, intended for backwards compatibility.
 |-
@@ Line 58: / Line 63: @@
 | NONE
 | Specifies one of the hardcoded materials listed below. Note that this goes in the token itself, not arguments (i.e GLASS_GREEN:NONE, not MATERIAL_NAME:GLASS_GREEN).
 |}
 Several types of [[Item token|items]] expect a creature ID and caste ID (e.g. [[Ant|ANT:SOLDIER]]) in place of the material token.
 It should be noted when using the table below, that you do not place (MATERIAL_NAME:(Your material here)). For example, green glass will be (GLASS_GREEN:NONE).

@@ Line 4: / Line 4: @@
 {{Modding}}
-Material tokens are used to refer to various types of materials in a wide variety of places. They can take the following forms:
+Material tokens are used to refer to various types of materials in a wide variety of places. They can take the following forms below.
 {{clear}}

@@ Line 1: / Line 1: @@
-{{quality|Exceptional|08:56, 23 October 2014 (UTC)}}{{av}}
+{{quality|Exceptional|08:56, 23 October 2014 (UTC)}}
 :''For the tokens that define an individual material's properties, see [[Material definition token]].''
 Material tokens are used to refer to various types of materials in a wide variety of places. They can take the following forms:
 {| {{prettytable}}
 |- bgcolor="#ddd"
@@ Line 108: / Line 112: @@
 |}
 {{Category|Modding}}
 {{Category|Tokens}}
 [[ru:Material token]]