DTB

DTB (DaTa Binary?) is the binary serialised counterpart to the plaintext DTA file format. It is capable of storing all DataNodes that the DTA counterpart can store, with the exception of comments.

It is typically stored with .dtb (Guitar Hero 1 through Rock Band 4) and .*_dta_* (Rock Band 4 and Rock Band VR) file extensions.

Structure

There are several variations on the DTB file format, and this dictates the structure of DataArrays in the file (and possibly more), as well as the header.

TODO: further document the actual structure. For now, read the reference implementations for more information

Header

The header is at the start of the file, and serves as information for the DataArray that the file is representing. (TODO: are these correct?)

.dtb

Name	Type	Size	Function
Identifier	Byte	1 byte	Always 0x01.
Root Nodes	Short (LE)	2 bytes	The number of root nodes.
Unknown	Integer (LE)	4 bytes	???

.*_dta_*

Name	Type	Size	Function
Identifier	Byte	1 byte	Always 0x01.
Unknown	Integer (LE)	4 bytes	???
Root Nodes	Short (LE)	2 bytes	The number of root nodes.
Unknown	Short (LE)	2 bytes	???

Body

The body consists of a DataArray representation, of a count of the root DataNodes specified in the header.

Name	Type	Size	Function
Type	Integer (LE)	4 bytes	The type of the DataNode
Value	Varies	Varies	The value of the DataNode

Supported DataNode Types

All values are little endian unless specified otherwise. For more information on what these do, see DataNode.

TODO: complete missing values

ID	Name	Size	Value
0x00	Integer	4 bytes	A 32-bit signed integer.
0x01	Float	4 bytes	A 32-bit single-precision floating point.
0x02	Variable	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x03	Symbol	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x06	Empty	4 bytes	Four null bytes.
0x07	IfDef	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x08	Else	4 bytes	Four null bytes.
0x09	EndIf	4 bytes	Four null bytes.
0x10	DataArray	Varies	See #Nested DataArrays
0x11	Command	Varies	TODO
0x12	String	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x13	Macro	Varies	TODO
0x20	Define	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x21	Include	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x22	Include	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x23	IfNDef	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x24	Autorun	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.
0x25	Undef	4 bytes + string length	A 32-bit signed integer followed by a UTF8 string.

Nested DataArrays

DataArrays in DTB files are prefixed with a header, followed by the regular DTB representation of all values in the nested array.

.dtb

Name	Type	Size	Function
Child Nodes	Short (LE)	2 bytes	The number of DataNodes within this DataArray.
Unknown	Integer (LE)	4 bytes	Some kind of ID?

.*_dta_*

Name	Type	Size	Function
Unknown	Integer (LE)	4 bytes	????
Child Nodes	Short (LE)	2 bytes	The number of DataNodes within this DataArray.
Unknown	Short (LE)	2 bytes	????

Encryption

DTA files are encrypted when included on-disc. The encryption format was changed in Guitar Hero 2's Xbox 360 release and has been the same since.

Encrypted files begin with a 4-byte little endian integer which acts as a key for the encryption cipher, followed by an encrypted form of a regular DTB file.

TODO: document the encryption cipher. In the meantime, refer to CryptStream.cs from DtxCS.

Implementations

• dtab by Onyxite (source code: GitHub)
• DtxCS by maxton (source code: GitHub)