User:Rick/Save research

0.27.176.38c

Dwarf Fortress .DAT files for this version are basically blocks of zlib compressed data. long + data... repeated throughout the file. The long represents the size of compressed data.

Structures

Basic Types

String

Size	Type	Name	Notes
2	short	Length
x	char	String data of length size.

String List

Size	Type	Name	Notes
4	long	Count
(2 + length) * count	strings	Strings

Byte List

Size	Type	Name	Notes
4	long	Count
1 * count	bytes	Bytes

Short List

Size	Type	Name	Notes
4	long	Count
2 * count	shorts	Shorts

Long List

Size	Type	Name	Notes
4	long	Count
4 * count	longs	Longs

Game Structures

Info Structure

Size	Type	Name	Notes
variable	string
variable	string
28
14
4	long
2	short

Unk89 Structure

Size	Type	Name	Notes
2	short
4	long
2	short

Unk96 Structure

Size	Type	Name	Notes
2	short
variable	shortlist
variable	shortlist
4	long	unk4 count
variable	unk4 structure * unk4 count

Unk96 Unk4 Structure

Size	Type	Name	Notes
1	byte
1	byte
2	short
4	long
2	short
2	short
2	short
2	short

Civilization Structure

Size	Type	Name	Notes
2	short	Probably race?
4	long	Civilization index?
variable	string	Entity type name
2	short
2	short
4	long
2	short
variable	longlist
1	byte	Info present	Following struct is only present if this value is non-zero.
variable	info
2	short
4	long
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
2	short
2	short
2	short
2	short
2	short
2	short
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
variable	shortlist
			Some more data might be possible here depending, havn't investigated yet (00510074 in .32a).
variable	bytelist
variable	bytelist
variable	bytelist
variable	bytelist
variable	bytelist
4	long	unk86 count
			Some more data might be present here if unk86 is non-zero.
4	long	unk87 count
			Some more data might be present here if unk87 is non-zero.
4	long	unk88 count
			Some more data might be present here if unk88 is non-zero.
4	long	unk89 count
variable	unk89 struct * unk89 count
4	long	unk90 count
variable	unk89 struct * unk90 count
variable	longlist
variable	longlist
variable	shortlist
variable	longlist
variable	shortlist
4	long	unk96 count
variable	unk96 struct * unk96 count
2	short
4	long
4	long
2	short
2	short
2	short
2	short
variable	longlist
4	long	unk105 size
variable	char * unk105 size

Region Information

Size	Type	Name	Notes
1	byte		Following data for this block is not present if this is 0.
variable	string
variable	string
28
14
4	long
2	short

Region Information Container

Size	Type	Name	Notes
4	long
variable	Region Information	Region Information
4	long

Region Map

Size	Type	Name	Notes
4	long	follow buffer size
variable			byte * previous long
48
4	long
4	long
2	short

Region Geology Subdata

Size	Type	Name	Notes
2	short
2	short
variable	shortarray
variable	shortarray
variable	bytearray
variable	bytearray
2	short
2	short

Region Geology

Size	Type	Name	Notes
2	short
2	short
2	short	Count of following subitems
variable	array of Region Geology Subdata	array of Region Geology Subdata

Region Subregion

Size	Type	Name	Notes
4	long
variable	Region Information	region information
2	short
variable	shortarray
variable	shortarray
4	long
4	long
4	long
4	long
204
variable	shortarray
variable	shortarray
variable	shortarray
variable	shortarray
variable	shortarray
variable	shortarray
1	byte
1	byte
1	byte
1	byte
incomplete...

Files

world.dat

Version Block

Size	Type	Name	Notes
4	long	Version?	Currently 0x4B5 (1205).
2	short

Header (1) Block

Size	Type	Name	Notes
4	long
4	long
4	long
4	long
4	long
4	long
4	long
4	long	Number of historical figures?
4	long	Number of historical events
4	long
4	long
4	long
1	byte		Following block is not present if this is 0.

Optional Header Block

Size	Type	Name	Notes
2 + length	string
2 + length	string
28	struct?
14	struct?
4	long
2	short

Header (2) Block

Size	Type	Name	Notes
15	struct?
2 + length	string	World name

Data Blocks

IDs Block

Size	Type	Name	Notes
variable	stringlist	Wood Matgloss IDs
variable	stringlist	Stone Matgloss IDs
variable	stringlist	Metal Matgloss IDs
variable	stringlist	Plant Matgloss IDs
variable	stringlist	Creature Body IDs
variable	stringlist	Creature Body Gloss IDs
variable	stringlist	Creature IDs
variable	stringlist	Item IDs
variable	stringlist	Entity IDs
variable	stringlist	Word IDs
variable	stringlist	Symbol IDs
variable	stringlist	Language IDs
variable	stringlist	Color IDs
variable	stringlist	Shape IDs
variable	stringlist	Reaction IDs

Civilization Data Block

Size	Type	Name	Notes
4	long		If this is a non-zero value some data follows, not sure of format yet.
4	long		If this is a non-zero value some data follows, not sure of format yet.
variable	longlist	Civilization IDs?
variable	longlist	Unit IDs?
variable	longlist
variable	longlist
variable	longlist
variable	civ struct * civ count	Civilization data

Region Information Block

Size	Type	Name	Notes
variable	string	*START REGION SAVE*
15
variable	Region Information

Region Dimensions Block

Size	Type	Name	Notes
variable	string	*START REGION DIM SAVE*
2	short	Width
2	short	Height
4	long
2	short
4	long
2	short		Depth? (as in z-layers)

Region Map Block

Size	Type	Name	Notes
variable	string	*START REGION MAP SAVE*
1	byte	Has region maps	Following region map array not present if this is 0.
variable	Array of Region Map	Region Maps	Count = Width * Height
1	byte	Has world map?	Following world map not present if this is 0.
variable		World Map?	size is ((width + 15) >> 4) * ((height + 15) >> 4) * 4 (16 bytes for 17x17 world)
4	long
4	long
4	long	Count of following region information container array
variable	Region Information Container	Array of Region Information Container

Region Geology Block

Size	Type	Name	Notes
variable	string	*START REGION GEOLOGY SAVE*
4	long	Count of geology information
variable	array of Region Gelogy	Array of geology information, by previous count

Region Subregion Block

Size	Type	Name	Notes
variable	string	*START REGION SUBREGION SAVE*
4	long	Count of subregion information
variable	array of Region Subregion	Array of subregion information, by previous count