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 "Token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(Added a mention to Reactions, although I'm not sure of the best place to put it.)
(Seems to cover all tokens.)
 
(46 intermediate revisions by 16 users not shown)
Line 1: Line 1:
In Dwarf Fortress, a '''token''' is a game code tag that adds information, restrictions or behaviour to a [[creature]], object, [[material]], terrain feature or other part of the game. Tokens are visible in the [[RAW]] .txt files, and can often be [[modding|modified]] to create some interesting results - some useful, some not so much.
+
{{Quality|Fine}}
 +
{{av}}
 +
{{Modding}}
 +
In ''Dwarf Fortress'', a '''token''' is a piece of text that defines the properties of an object.  An "object" could be a material, a type of tissue, an organ, a piece of armor, a creature, a biome, a civilisation, or anything else in the game.  A "property" could be how large something is, what it is made from, its melting temperature, its name, its biome preference (for civilisations) or anything else that makes it unique.  All information associated with the properties of an object in the game is defined using tokens. Tokens are used in the [[raws]], which can be easily [[modding|modified]], allowing users to create (and distribute) new content.
  
Examples of tokens include...
+
:* [[Ammo token]]s define ammunition, such as arrows and bolts.
 
 
:* [[Ammo token]]s, used for ammo.
 
 
:* [[Armor token]]s define armor.
 
:* [[Armor token]]s define armor.
:* [[Biome token]]s are used in creature, entity and plant definitions for placement.
+
:* [[Biome token]]s define environments for creatures, plants and entities (entities being civilisations).
:* [[Building token]]s define buildings, their tiles, hotkeys, and how they block movement.
+
:* [[Building token]]s define buildings.
:* [[Body token]]s determine bodily structure, both ''body templates'' (BODY) and ''body parts''
+
:* [[Body token]]s determine bodily structure and materials.
:* [[Body detail plan token]] Like the above but for detail.
+
:* [[Body detail plan token]]s define some details of a body, similar to body tokens.
:* [[Bodygloss]] change how body parts appear.
+
:* [[Bodygloss]] tokens perform a single-word substitution of a creature's body parts.
 
:* [[Creature token]]s determine the properties of creatures.
 
:* [[Creature token]]s determine the properties of creatures.
:* [[DF2012:Creature variation token]] change the properties of creatures.
+
:* [[Creature variation token]]s are used to create creatures derived from other already-existing creatures, without duplicating every single token.
:* [[Entity token]] defines entities, or [[civilizations]], in entity_*.txt files.
+
:* [[Descriptor color token]]s define colors used in text-based descriptions. Not to be confused with [[color scheme]]s.
:* [[Item token]]s are used in reactions, creatures and entities to refer to specific items.
+
:* [[Descriptor pattern token]]s define color patterns.
:* [[Item definition token]] is used in item definitions in the raws.
+
:* [[Descriptor shape token]]s define [[shape]]s.
:* [[Interaction token]] is used by interactions.
+
:* [[Entity token]]s define entities, or [[civilization]]s.
:* [[Labor token]] define labors.
+
:* [[Graphics token]] define tile-based [[graphics]].
:* [[Language token]] define language.
+
:* [[Item token]]s define the most basic form of items (made specific by material tokens). Item tokens are mainly used in [[reactions]].
:* [[Material token]]s are the same as item tokens, but for materials.
+
:* [[Item definition token]]s are used for actual definitions of items.
:* [[Material definition token]]s are used to define materials, like item definitions.
+
:* [[Instrument token]]s define instruments.
:* [[Plant token]]s define what plants are made of, where they grow, what can be made out of them, etc.
+
:* [[Interaction token]]s define interactions.
:* [[Profession token]]s are referred to by tilesets and entities for purposes of nobility and the like.
+
:* [[Labor token]]s define labors.
:* [[Position token]]s define positions in entity_*.txt files.
+
:* [[Language token]]s define a language's vocabulary. Since fictional languages in ''Dwarf Fortress'' are currently only used in names, language tokens do not define grammar.
:* [[Skill token]]s are referred to by creatures for natural skills and such.
+
:* [[Material token]]s are used to refer to materials, similar to item tokens.
:* [[Syndrome tokens]] define syndromes.
+
:* [[Material definition token]]s are used to define materials, similar to item definition tokens.
:* [[Tool token]] define tools. They're a lot like weapon tokens.  
+
:* [[Inorganic material definition token]]s are used to define inorganic materials, similar to material definition tokens.
:* [[Trap component token]]s define traps. A bit like weapon tokens.
+
:* [[Plant token]]s define plants.
:* [[Weapon token]]s define weapons. They're fairly simple, so it's a good place to start with DF modding.
+
:* [[Position token]]s define roles/occupations/positions in character entities.
 +
:* [[Skill token]]s reference skills.
 +
:* [[Syndrome token]]s define syndromes (ie conditions, diseases, bonuses and maluses).
 +
:* [[Tissue definition token]]s define tissues.
 +
:* [[Tool token]]s define tools, similar to weapon tokens.
 +
:* [[Trap component token]]s define traps.
 +
:* [[Unit type token]]s are referred to by tilesets and entities, for purposes of nobility and the like.
 +
:* [[Weapon token]]s define weapons.
 
:* [[World token]]s are used in custom world generation.
 
:* [[World token]]s are used in custom world generation.
:* [[Unit type token]]s are used with various entity tokens, as well as in graphical tilesets.  
+
:* [[Music token]]s These are the triggers for the default music effects.
 +
:* [[Sound token]]s These are the triggers for the default sound effects.
  
Also note [[Reactions]], which are a little more complicated than simple tokens.
+
Also note [[reactions]], which are a little more complicated than simple tokens.
  
This [http://www.bay12games.com/forum/index.php?board=13.0 forum] is the official DF subforum dedicated to discussions about modding.
+
== See also ==
 +
{{catbox|Tokens}}
  
 
----
 
 
 
'''See Also:'''
 
* [[Bodygloss]]
 
 
* [[Raw file]]
 
* [[Raw file]]
 
* [[Modding]]
 
* [[Modding]]
 +
* [[Dipscript]]
 +
* [[Speech file]]
 +
 
[[category:Modding]]
 
[[category:Modding]]
 +
[[ru:Token]]

Latest revision as of 13:54, 22 February 2024

This article is about the current version of DF.
Note that some content may still need to be updated.


In Dwarf Fortress, a token is a piece of text that defines the properties of an object. An "object" could be a material, a type of tissue, an organ, a piece of armor, a creature, a biome, a civilisation, or anything else in the game. A "property" could be how large something is, what it is made from, its melting temperature, its name, its biome preference (for civilisations) or anything else that makes it unique. All information associated with the properties of an object in the game is defined using tokens. Tokens are used in the raws, which can be easily modified, allowing users to create (and distribute) new content.

Also note reactions, which are a little more complicated than simple tokens.

See also[edit]