Token

xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼

v50.12 · v0.47.05 This article is about the current version of DF. Note that some content may still need to be updated. More Info · V

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 found in the raws, and can be easily modified, allowing users to create (and distribute) new content.

• Ammo tokens define ammunition, such as arrows and bolts.
• Armor tokens define armor.
• Biome tokens define environments for creatures, plants and entities (entities being civilisations).
• Building tokens define buildings.
• Body tokens determine bodily structure and materials.
• Body detail plan tokens define some details of a body, similar to body tokens.
• Bodygloss tokens perform a single-word substitution of a creature's body parts.
• Creature tokens determine the properties of creatures.
• Creature variation tokens are used to create creatures derived from other already-existing creatures, without duplicating every single token.
• Descriptor color tokens define colors used in text-based descriptions. Not to be confused with color schemes.
• Descriptor pattern tokens define color patterns.
• Descriptor shape tokens define shapes.
• Entity tokens define entities, or civilizations.
• Item tokens define the most basic form of items (made specific by material tokens). Item tokens are mainly used in reactions, while item definition tokens are used for actual definitions of items.
• Instrument tokens define instruments.
• Interaction tokens define interactions.
• Labor tokens define labors.
• Language tokens define a language's vocabulary. Since fictional languages in Dwarf Fortress are currently only used in names, language tokens do not define grammar.
• Material tokens are used to refer to materials, similar to item tokens.
• Material definition tokens are used to define organic materials, while inorganic material definition tokens are used to define inorganic materials.
• Plant tokens define plants.
• Position tokens define positions in entities.
• Skill tokens reference skills.
• Syndrome tokens define syndromes.
• Tissue definition tokens define tissues.
• Tool tokens define tools, similar to weapon tokens.
• Trap component tokens define traps.
• Unit type tokens are referred to by tilesets and entities, for purposes of nobility and the like.
• Weapon tokens define weapons.
• World tokens are used in custom world generation.

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

This forum is the official Dwarf Fortress subforum dedicated to discussions about modding.

See Also:

• Raw file
• Modding
• Dipscript
• Speech file