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 "v0.31:Raw file"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(use category template for versioning)
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{av}}
 
{{av}}
 
{{Quality|Fine}}
 
{{Quality|Fine}}
'''Raw files''' are text files found in the '''\raw\objects''' subfolder of Dwarf Fortress (used for {{L|world generation}}) and in '''\data\save\<region-name>\raw\objects''' (for already generated worlds).  These files can be looked through to discover various specifics of game items, materials, and creatures, and can be changed to alter how the game behaves.  They are sometimes referred to by players as just "the raws".
+
'''Raw files''' are text files found in the '''\raw\objects''' subfolder of Dwarf Fortress (used for [[world generation]]) and in '''\data\save\<region-name>\raw\objects''' (for already generated worlds).  These files can be looked through to discover various specifics of game items, materials, and creatures, and can be changed to alter how the game behaves.  They are sometimes referred to by players as just "the raws".
  
The '''\raw\graphics''' subfolder of Dwarf Fortress is used to store user-customizable {{L|graphics sets|graphics sets}}.
+
The '''\raw\graphics''' subfolder of Dwarf Fortress is used to store user-customizable [[graphics sets]].
  
Dwarf Fortress is not an open source program, so most {{L|modding|modding}} of the game is limited to altering the raws or doing {{L|memory hacking}}.
+
Dwarf Fortress is not an open source program, so most [[modding]] of the game is limited to altering the raws or doing [[memory hacking]].
  
 
Duplicating the raw files can cause several bugs, and even crashes. The game gets very messy and buggy when you do it.
 
Duplicating the raw files can cause several bugs, and even crashes. The game gets very messy and buggy when you do it.
Line 22: Line 22:
 
===Types of content:===
 
===Types of content:===
 
*BODY - body parts and structures
 
*BODY - body parts and structures
*BODY_DETAIL_PLAN - similar to the following creature variation file type, but used for defining tokens related to body parts (specifically materials, tissues, the assignment thereof, and body part positions, relative sizes, etc.)
+
*BODY_DETAIL_PLAN - similar to CREATURE_VARIATION, but used for defining tokens related to body parts (specifically materials, tissues, the assignment thereof, and body part positions, relative sizes, etc.)
 
*BUILDING - custom workshops
 
*BUILDING - custom workshops
 
*CREATURE - creatures
 
*CREATURE - creatures
Line 28: Line 28:
 
*DESCRIPTOR_COLOR - named colours for use with DESCRIPTOR_PATTERN objects (other purposes unknown)
 
*DESCRIPTOR_COLOR - named colours for use with DESCRIPTOR_PATTERN objects (other purposes unknown)
 
*DESCRIPTOR_PATTERN - patterns with colour combinations for use with creatures (other purposes unknown)
 
*DESCRIPTOR_PATTERN - patterns with colour combinations for use with creatures (other purposes unknown)
*DESCRIPTOR_SHAPE - shapes with descriptions and variations. Shapes are used in engravings and as civ symbols. One of their adjectives will describe the shape.
+
*DESCRIPTOR_SHAPE - shapes with descriptions and variations. Previous versions used this for engravings, but their use in the current version is unverified as of yet.
 
*ENTITY - civilization types, with assigned race, language, culture, ethics, and social structure.
 
*ENTITY - civilization types, with assigned race, language, culture, ethics, and social structure.
 
*GRAPHICS - graphic tiles for creatures
 
*GRAPHICS - graphic tiles for creatures
Line 51: Line 51:
 
*MATERIAL_TEMPLATE - definitions of information common to groups of materials (referenced all over the place)
 
*MATERIAL_TEMPLATE - definitions of information common to groups of materials (referenced all over the place)
 
*PLANT - definitions of plants, their materials, and their derivitives
 
*PLANT - definitions of plants, their materials, and their derivitives
*REACTION - reactions/custom workshop jobs (turn items into other items though dwarven effort)
+
*REACTION - reactions/custom workshop jobs (turn items into other items through dwarven effort)
 
*TISSUE_TEMPLATE - defines templated tissues for use with BODY_DETAIL_PLAN objects or in creatures
 
*TISSUE_TEMPLATE - defines templated tissues for use with BODY_DETAIL_PLAN objects or in creatures
  
 
+
Usually empty strings are used to divide different types of structures like the fine name and [OBJECT:] or different entries, however everything which is not a token besides the 1st string (which is the filename) is understood as comments and is not considered.
    * usually the empty strings are used to divide different types of structures like the fine name
 
and [OBJECT:] or different entries, however everything which is not a token besides the 1st string
 
(which is the filename) is understood as comments and is not considered.
 
  
 
The tokens are enclosed in square brackets ([TOKEN:VALUES]).
 
The tokens are enclosed in square brackets ([TOKEN:VALUES]).
  
When a world is generated, the raw files are moved from <game folder>/raw/ to <game folder>/data/save/REGION/raw/. It is currently unknown how much these can then be changed without breaking the save.
+
When a world is generated, the raw files are copied from <game folder>/raw/ to <game folder>/data/save/REGION/raw/. It is currently unknown how much these can then be changed without breaking the save.
  
 
A list of tokens can be seen at [[:Category:Tokens]].
 
A list of tokens can be seen at [[:Category:Tokens]].
  
[[Category:Files]]
+
{{Category|Files}}
 
{{Category|Modding}}
 
{{Category|Modding}}

Latest revision as of 04:45, 6 January 2023

This article is about an older version of DF.

Raw files are text files found in the \raw\objects subfolder of Dwarf Fortress (used for world generation) and in \data\save\<region-name>\raw\objects (for already generated worlds). These files can be looked through to discover various specifics of game items, materials, and creatures, and can be changed to alter how the game behaves. They are sometimes referred to by players as just "the raws".

The \raw\graphics subfolder of Dwarf Fortress is used to store user-customizable graphics sets.

Dwarf Fortress is not an open source program, so most modding of the game is limited to altering the raws or doing memory hacking.

Duplicating the raw files can cause several bugs, and even crashes. The game gets very messy and buggy when you do it.

Syntax of raw files[edit]

filename

[OBJECT:TYPE]

[TYPE:ID] 
<...contents...>

ID is an unique identificator for your type to use (i.e. [CREATURE:DOG], ID=DOG or [ITEM:ITEM_WEAPON_SWORD], ID=ITEM_WEAPON_SWORD).

Types of content:[edit]

  • BODY - body parts and structures
  • BODY_DETAIL_PLAN - similar to CREATURE_VARIATION, but used for defining tokens related to body parts (specifically materials, tissues, the assignment thereof, and body part positions, relative sizes, etc.)
  • BUILDING - custom workshops
  • CREATURE - creatures
  • CREATURE_VARIATION - variations that can be applied to creatures (eg, making them giants, or anthropomorphic). Technically a series of tokens that are added to or removed from the creature (essentially a set of templated changes)
  • DESCRIPTOR_COLOR - named colours for use with DESCRIPTOR_PATTERN objects (other purposes unknown)
  • DESCRIPTOR_PATTERN - patterns with colour combinations for use with creatures (other purposes unknown)
  • DESCRIPTOR_SHAPE - shapes with descriptions and variations. Previous versions used this for engravings, but their use in the current version is unverified as of yet.
  • ENTITY - civilization types, with assigned race, language, culture, ethics, and social structure.
  • GRAPHICS - graphic tiles for creatures
  • INORGANIC - inorganic material definitions.
  • ITEM - items ranging from ammunition to food types, has secondary types for the purposes of [TYPE:ID]
    • ITEM_AMMO - ammunition for ranged weapons
    • ITEM_ARMOR - body clothing, including armour
    • ITEM_FOOD - prepared food definitions
    • ITEM_GLOVES - hand clothing, including armour
    • ITEM_HELM - head clothing, including armour
    • ITEM_INSTRUMENT - instrument definitions
    • ITEM_PANTS - lower body clothing, including armour
    • ITEM_SHIELD - shields (always armour?)
    • ITEM_SHOES - foot clothing, including armour
    • ITEM_SIEGEAMMO - ammunition for siege weapons (only ballista?)
    • ITEM_TOY - toy definitions
    • ITEM_TRAPCOMP - components that can be used in weapon traps (two special tags define trapcomps that can be used in other constructions: IS_SCREW and IS_SPIKE)
    • ITEM_WEAPON - weapons that are used by soldiers, as well as digging tools
  • LANGUAGE - word definitions for the languages used by ENTITY objects
    • Entries beginning with [SYMBOL:ID] sort words into symbolic/poetic groups to be referenced by ENTITY preferences
    • Entries beginning with [WORD:ID] define words and their alternate forms (in english)
  • MATERIAL_TEMPLATE - definitions of information common to groups of materials (referenced all over the place)
  • PLANT - definitions of plants, their materials, and their derivitives
  • REACTION - reactions/custom workshop jobs (turn items into other items through dwarven effort)
  • TISSUE_TEMPLATE - defines templated tissues for use with BODY_DETAIL_PLAN objects or in creatures

Usually empty strings are used to divide different types of structures like the fine name and [OBJECT:] or different entries, however everything which is not a token besides the 1st string (which is the filename) is understood as comments and is not considered.

The tokens are enclosed in square brackets ([TOKEN:VALUES]).

When a world is generated, the raw files are copied from <game folder>/raw/ to <game folder>/data/save/REGION/raw/. It is currently unknown how much these can then be changed without breaking the save.

A list of tokens can be seen at Category:Tokens.