Aitch at 23:05, 1 August 2025

2025-08-01T23:05:46Z

Aitch: Created page with "'''DAT''' is the generic file format used in Super Smash Bros. Melee. These files store animations, textures, models, character attributes, subaction bytecode, etc., everythin..."

2025-08-01T23:04:53Z

Created page with "'''DAT''' is the generic file format used in Super Smash Bros. Melee. These files store animations, textures, models, character attributes, subaction bytecode, etc., everythin..."

New page

'''DAT''' is the generic file format used in Super Smash Bros. Melee. These files store animations, textures, models, character attributes, subaction bytecode, etc., everything except for movies and audio. The file format itself does not care about the type of data stored within it, it is simply a generic container format for storing objects and symbols pointing to objects, as well as relocation information.

[https://github.com/AlexanderHarrison/cdat CDat] is a simple open-source C library for reading and modifying dat files.

__TOC__

= Format =

Every dat file has six sections laid out in order.
These six sections are: '''Header''', '''Data''', '''Relocation Table''', '''Root Table''', '''External Reference Table''', and '''String Table'''.
Each section follows immediately after the previous section.

== Header ==

Always 0x20 bytes.

{| class="wikitable"
! Offset
! Size
! Description
|-
| 0x0
| 4
| '''File Size'''
|-
| 0x4
| 4
| '''Data Section Size'''
|-
| 0x8
| 4
| '''Relocation Entry Count'''
|-
| 0xC
| 4
| '''Root Entry Count'''
|-
| 0x10
| 4
| '''External Reference Entry Count'''
|-
| 0x14
| 12
| ''unused''
|}

== Data ==

The data section always starts at 0x20 and runs for the length indicated in the header.
This is just a large heap of bytes pointed to by the other sections.
The dat format is not concerned with the contents of this section.

== Relocation Table ==

The Relocation Table section starts immediately after the data section and runs for <code>4 * reloc_entry_count</code> bytes.
Each entry is a single 4 byte word.

{| class="wikitable"
! Offset
! Size
! Description
|-
| 0x0
| 4
| '''Data Offset'''
|}

This table is used to maintain pointers between objects when loading dat files into memory.
For each data offset, the game will add the file pointer to the data word pointed to by each data offset contained in this table.
For example:
<syntaxhighlight lang="c">
for (u32 i = 0; i < reloc_entry_count; ++i) {
u32 reloc_offset = dat_reloc_section[i];
u32 *reloc_target = (u32*)(data_section + reloc_offset);
*reloc_target += (u32)dat_file_ptr;
}</syntaxhighlight>

== Root Table ==

The Root Table section starts immediately after the relocation table section and runs for <code>8 * root_entry_count</code> bytes.
Each entry is two 4 byte words.

{| class="wikitable"
! Offset
! Size
! Description
|-
| 0x0
| 4
| '''Data Offset'''. This is an offset into the data section.
|-
| 0x4
| 4
| '''Symbol Offset'''. This is an offset into the string table section.
|}

Roots often point to models or arrays of animations.
The type of the root node is interpreted at runtime, type information is not stored in the dat file itself.

== External Reference Table ==

This section is very similar to the root table section. It starts immediately after the root table section and runs for <code>8 * external_ref_entry_count</code> bytes.
Each entry is two 4 byte words, exactly the same as the root table section.

This section contains references to root nodes in other dat files.

== Symbol Table ==
The Symbol Table section starts immediately after the external reference table. This section contains null terminated strings pointed to by entries in the root table.

← Older revision		Revision as of 23:05, 1 August 2025
Line 107:		Line 107:
	== Symbol Table ==		== Symbol Table ==
	The Symbol Table section starts immediately after the external reference table. This section contains null terminated strings pointed to by entries in the root table.		The Symbol Table section starts immediately after the external reference table. This section contains null terminated strings pointed to by entries in the root table.
		+
		+	[[Category:File Formats]]
		+	[[Category:Super Smash Bros. Melee]]

DAT (File Format) - Revision history

Aitch at 23:05, 1 August 2025

Aitch: Created page with "'''DAT''' is the generic file format used in Super Smash Bros. Melee. These files store animations, textures, models, character attributes, subaction bytecode, etc., everythin..."