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
(Seems to cover all tokens.)
 
(49 intermediate revisions by 19 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]]s define some details of a body, similar to body tokens.
 +
:* [[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.
:* [[Entity token]] defines entities, or [[civilizations]], in entity_*.txt files.
+
:* [[Creature variation token]]s are used to create creatures derived from other already-existing creatures, without duplicating every single token.
:* [[Item token]]s are used in reactions, creatures and entities to refer to specific items.
+
:* [[Descriptor color token]]s define colors used in text-based descriptions. Not to be confused with [[color scheme]]s.
:* [[Item definition token]] is used in item definitions in the raws.
+
:* [[Descriptor pattern token]]s define color patterns.
:* [[Material token]]s are the same as item tokens, but for materials.
+
:* [[Descriptor shape token]]s define [[shape]]s.
:* [[Material definition token]]s are used to define materials, like item definitions.
+
:* [[Entity token]]s define entities, or [[civilization]]s.
:* [[Plant token]]s define what plants are made of, where they grow, what can be made out of them, etc.
+
:* [[Graphics token]] define tile-based [[graphics]].
:* [[Profession token]]s are referred to by tilesets and entities for purposes of nobility and the like.
+
:* [[Item token]]s define the most basic form of items (made specific by material tokens). Item tokens are mainly used in [[reactions]].
:* [[Skill token]]s are referred to by creatures for natural skills and such.
+
:* [[Item definition token]]s are used for actual definitions of items.
:* [[Weapon token]]s define weapons. They're fairly simple, so it's a good place to start with DF modding.
+
:* [[Instrument token]]s define instruments.
 +
:* [[Interaction token]]s define interactions.
 +
:* [[Labor token]]s define labors.
 +
:* [[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.
 +
:* [[Material token]]s are used to refer to materials, similar to item tokens.
 +
:* [[Material definition token]]s are used to define materials, similar to item definition tokens.
 +
:* [[Inorganic material definition token]]s are used to define inorganic materials, similar to material definition tokens.
 +
:* [[Plant token]]s define plants.
 +
:* [[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.
 +
:* [[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.
  
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]