Difference between revisions of "FF8/FileFormat DAT"

From Final Fantasy Inside
< FF8
Jump to navigation Jump to search
my_wiki>Myst6re
m (18 revisions imported)
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
By Mirex, JWP and myst6re.
+
By Mirex, JWP, random_npc and myst6re.
 +
Edit: We now know the animation and skeleton- see https://github.com/MaKiPL/OpenVIII/blob/4ac151daad7cd1475eb0694dd0715bc35d7a4b39/FF8/debug_battleDat.cs
  
 
== Header ==
 
== Header ==
Line 35: Line 36:
 
|-
 
|-
 
|style="background:rgb(255,255,204)" | 2
 
|style="background:rgb(255,255,204)" | 2
|style="background:rgb(255,255,204)" | 14 bytes
+
|style="background:rgb(255,255,204)" | 6 bytes
 +
|style="background:rgb(255,255,204)" | Unknown
 +
|-
 +
| 8
 +
| s16f (divide by 4096f)
 +
| scaleX
 +
|-
 +
| 10
 +
| s16f (divide by 4096f)
 +
| scale -Z
 +
|-
 +
| 12
 +
| s16f (divide by 4096f)
 +
| scale Y
 +
|-
 +
|style="background:rgb(255,255,204)" | 14
 +
|style="background:rgb(255,255,204)" | 2 bytes
 
|style="background:rgb(255,255,204)" | Unknown
 
|style="background:rgb(255,255,204)" | Unknown
 
|-
 
|-
Line 56: Line 73:
 
|-
 
|-
 
| 2
 
| 2
| 2 bytes
+
| s16f (divide by 4096f)
| Bone size
+
| Bone size (?)
 +
|-
 +
| 4
 +
| s16f (divide by 4096f)
 +
| unknown, multiplied by 360f
 +
|-
 +
| 6
 +
| s16f (divide by 4096f)
 +
| unknown, multiplied by 360f
 +
|-
 +
| 8
 +
| s16f (divide by 4096f)
 +
| unknown, multiplied by 360f
 +
|-
 +
| 10
 +
| s16f (divide by 4096f)
 +
| unknown
 +
|-
 +
| 12
 +
| s16f (divide by 4096f)
 +
| unknown
 +
|-
 +
| 14
 +
| s16f (divide by 4096f)
 +
| unknown
 
|-
 
|-
|style="background:rgb(255,255,204)" | 4
+
|style="background:rgb(255,255,204)" | 16
|style="background:rgb(255,255,204)" | 44 bytes
+
|style="background:rgb(255,255,204)" | 28 bytes
 
|style="background:rgb(255,255,204)" | Unknown (often empty)
 
|style="background:rgb(255,255,204)" | Unknown (often empty)
 
|}
 
|}
Line 80: Line 121:
 
| nbObjects * 4 bytes
 
| nbObjects * 4 bytes
 
| Object Positions
 
| Object Positions
 +
|-
 +
| 4 + nbObjects * 4
 +
| Varies
 +
| Object Data (see below)
 +
|-
 +
| Varies
 +
| 4 bytes
 +
| Total count of vertices
 
|}
 
|}
  
Line 95: Line 144:
 
| 2
 
| 2
 
| Varies * NbVerticesData
 
| Varies * NbVerticesData
| Vertices Data
+
| Vertices Data (see below)
 
|-
 
|-
 
| Varies
 
| Varies
| absolutePosition % 4
+
| 4 - (absolutePosition % 4)
 
| Padding (0x00)
 
| Padding (0x00)
 
|-
 
|-
Line 111: Line 160:
 
| Varies
 
| Varies
 
| 8 bytes
 
| 8 bytes
| Padding (0x00)
+
| Always empty
 
|-
 
|-
 
| Varies
 
| Varies
Line 120: Line 169:
 
| numQuads * 20 bytes
 
| numQuads * 20 bytes
 
| Quads
 
| Quads
|-
 
| Varies
 
| 4 bytes
 
| Total number of vertices (may be not visible)
 
 
|}
 
|}
  
Line 148: Line 193:
 
==== Useful structures ====
 
==== Useful structures ====
  
  typedef struct {
+
  struct vertice {
 
       sint16 x, y, z;
 
       sint16 x, y, z;
  } vertice;
+
  };
 
(sizeof = 6)
 
(sizeof = 6)
  
  typedef struct {
+
  struct triangle {
       uint16 vertex_indexes[3];
+
       uint16 vertex_indexes[3]; // vertex_indexes[0] &= 0xFFF, other bits are unknown
 
       uint8 texCoords1[2];
 
       uint8 texCoords1[2];
 
       uint8 texCoords2[2];
 
       uint8 texCoords2[2];
Line 160: Line 205:
 
       uint8 texCoords3[2];
 
       uint8 texCoords3[2];
 
       uint16 u; // textureID_related2
 
       uint16 u; // textureID_related2
  } triangle;
+
  };
 
(sizeof = 16)
 
(sizeof = 16)
  
  typedef struct {
+
  struct quad {
       uint16 vertex_indexes[4];
+
       uint16 vertex_indexes[4]; // vertex_indexes[0] &= 0xFFF, other bits are unknown
 
       uint8 texCoords1[2];
 
       uint8 texCoords1[2];
 
       uint16 textureID_related;
 
       uint16 textureID_related;
Line 171: Line 216:
 
       uint8 texCoords3[2];
 
       uint8 texCoords3[2];
 
       uint8 texCoords4[2];
 
       uint8 texCoords4[2];
  } triangle;
+
  };
 
(sizeof = 20)
 
(sizeof = 20)
  
Line 190: Line 235:
 
| nbAnimations * 4 bytes
 
| nbAnimations * 4 bytes
 
| Animations Positions
 
| Animations Positions
 +
|}
 +
 +
=== Animation ===
 +
 +
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
 +
! style="background:rgb(204,204,204)" | Offset
 +
! style="background:rgb(204,204,204)" | Length
 +
! style="background:rgb(204,204,204)" | Description
 +
|-
 +
| 0
 +
| 1 byte
 +
| Number of frames
 +
|-
 +
|style="background:rgb(255,255,204)" | 1
 +
|style="background:rgb(255,255,204)" | Varies
 +
|style="background:rgb(255,255,204)" | Unknown
 
|}
 
|}
  
 
== Section 4: Unknown ==
 
== Section 4: Unknown ==
  
Optionnal section, often empty.
+
Optional section, often empty.
  
== Section 5: A.I. ==
+
== Section 5: Unknown ==
  
Maybe A.I. scripts.
+
Unknown sequences.
  
 
=== Header ===
 
=== Header ===
Line 209: Line 270:
 
| 0
 
| 0
 
| 2 bytes
 
| 2 bytes
| Number of scripts
+
| Number of sequences
 
|-
 
|-
 
| 2
 
| 2
| nbScripts * 2 bytes
+
| nbSequences * 2 bytes
| Scripts Positions
+
| Sequences Positions
 
|}
 
|}
  
Line 222: Line 283:
 
== Section 7: Informations & stats ==
 
== Section 7: Informations & stats ==
  
TODO (interpreted at 94%)
+
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
 +
! style="background:rgb(204,204,204)" | Offset
 +
! style="background:rgb(204,204,204)" | Length
 +
! style="background:rgb(204,204,204)" | Description
 +
|-
 +
| 0
 +
| 24 bytes
 +
| Monster name
 +
|-
 +
| 24
 +
| 4 bytes
 +
| HP values
 +
|-
 +
| 28
 +
| 4 bytes
 +
| Str values
 +
|-
 +
| 32
 +
| 4 bytes
 +
| Vit values
 +
|-
 +
| 36
 +
| 4 bytes
 +
| Mag values
 +
|-
 +
| 40
 +
| 4 bytes
 +
| Spr values
 +
|-
 +
| 44
 +
| 4 bytes
 +
| Spd values
 +
|-
 +
| 48
 +
| 4 bytes
 +
| Eva values
 +
|-
 +
| 52
 +
| 16*4 bytes
 +
| Abilities, low level
 +
|-
 +
| 116
 +
| 16*4 bytes
 +
| Abilities, med level
 +
|-
 +
| 180
 +
| 16*4 bytes
 +
| Abilities, high level
 +
|-
 +
| 244
 +
| 1 byte
 +
| Med level start
 +
|-
 +
| 245
 +
| 1 byte
 +
| High level start
 +
|-
 +
|style="background:rgb(255,255,204)" | 246
 +
|style="background:rgb(255,255,204)" | 1 byte
 +
|style="background:rgb(255,255,204)" | Unknown (flags, 3 bits used)
 +
|-
 +
| 247
 +
| 1 byte
 +
| [LSB] Zombie / Fly / zz1 / zz2 / zz3 / Auto-Reflect / Auto-Shell / Auto-Protect [MSB]
 +
|-
 +
| 248
 +
| 3 bytes
 +
| Cards (low/med/high)
 +
|-
 +
| 251
 +
| 3 bytes
 +
| Devour (low/med/high)
 +
|-
 +
| 254
 +
| 1 byte
 +
| [LSB] zz1 / zz2 / unused / unused / unused / unused / Diablos missed / Always obtains card [MSB]
 +
|-
 +
|style="background:rgb(255,255,204)" | 255
 +
|style="background:rgb(255,255,204)" | 1 byte
 +
|style="background:rgb(255,255,204)" | Unknown (flags, 4 bits used)
 +
|-
 +
| 256
 +
| 2 bytes
 +
| Extra EXP
 +
|-
 +
| 258
 +
| 2 bytes
 +
| EXP
 +
|-
 +
| 260
 +
| 8 bytes
 +
| Draw (low)
 +
|-
 +
| 268
 +
| 8 bytes
 +
| Draw (med)
 +
|-
 +
| 276
 +
| 8 bytes
 +
| Draw (high)
 +
|-
 +
| 284
 +
| 8 bytes
 +
| Mug (low)
 +
|-
 +
| 292
 +
| 8 bytes
 +
| Mug (med)
 +
|-
 +
| 300
 +
| 8 bytes
 +
| Mug (high)
 +
|-
 +
| 308
 +
| 8 bytes
 +
| Drop (low)
 +
|-
 +
| 316
 +
| 8 bytes
 +
| Drop (med)
 +
|-
 +
| 324
 +
| 8 bytes
 +
| Drop (high)
 +
|-
 +
| 332
 +
| 1 byte
 +
| Mug rate
 +
|-
 +
| 333
 +
| 1 byte
 +
| Drop rate
 +
|-
 +
| 334
 +
| 1 byte
 +
| Padding (0x00)
 +
|-
 +
| 335
 +
| 1 byte
 +
| APs
 +
|-
 +
|style="background:rgb(255,255,204)" | 336
 +
|style="background:rgb(255,255,204)" | 16 bytes
 +
|style="background:rgb(255,255,204)" | Unknown
 +
|-
 +
| 352
 +
| 8 bytes
 +
| Elemental resistance<br/>(Fire, Ice, Thunder, Earth, Poison, Wind, Water, Holy)
 +
|-
 +
| 360
 +
| 20 bytes
 +
| Mental resistance<br/>
 +
(Death, Poison, Petrify, Darkness,<br/>
 +
Silence, Beserk, Zombie, Sleep,<br/>
 +
Haste, Slow, Stop, Regen,<br/>
 +
Reflect, Doom, Slow Petrify, Float,<br/>
 +
Confuse, Drain, Expulsion, ???)
 +
|}
 +
 
 +
=== Abilities ===
 +
 
 +
typedef struct {
 +
    uint8 kernel_id;
 +
    uint8 unknown;
 +
    uint16 ability_id;
 +
}
 +
 
 +
kernel_id is the used table in kernel.bin. May be 0x02 (= magic), 0x04 (= item) or 0x08 (= monster ability). ability_id is the ability in the selected kernel table.
 +
 
 +
=== Draw/mug/drop ===
  
== Section 8: Battle scripts ==
+
typedef struct {
 +
    uint8 id_1; // magic_id for draw, item_id for mug & drop
 +
    uint8 qty_1; // quantities are always 0 for draw
 +
    uint8 id_2;
 +
    uint8 qty_2;
 +
    uint8 id_3;
 +
    uint8 qty_3;
 +
    uint8 id_4;
 +
    uint8 qty_4;
 +
}
 +
 
 +
== Section 8: Battle scripts/AI ==
 +
 
 +
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
 +
! style="background:rgb(204,204,204)" | Offset
 +
! style="background:rgb(204,204,204)" | Length
 +
! style="background:rgb(204,204,204)" | Description
 +
|-
 +
| 0
 +
| 4 bytes
 +
| Number of sub-sections
 +
|-
 +
| 4
 +
| 4 bytes
 +
| Offset to AI sub-section
 +
|-
 +
| 8
 +
| 4 bytes
 +
| Offset to text offsets
 +
|-
 +
| 12
 +
| 4 bytes
 +
| Offset to text sub-section
 +
|}
 +
 
 +
=== AI ===
 +
 
 +
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
 +
! style="background:rgb(204,204,204)" | Offset
 +
! style="background:rgb(204,204,204)" | Length
 +
! style="background:rgb(204,204,204)" | Description
 +
|-
 +
| 0
 +
| 4 bytes
 +
| Offset to init code
 +
|-
 +
| 4
 +
| 4 bytes
 +
| Offset to code executed at ennemy's turn
 +
|-
 +
| 8
 +
| 4 bytes
 +
| Offset to counterattack code
 +
|-
 +
| 12
 +
| 4 bytes
 +
| Offset to death code
 +
|-
 +
|style="background:rgb(255,255,204)" | 16
 +
|style="background:rgb(255,255,204)" | 4 bytes
 +
|style="background:rgb(255,255,204)" | Unknown offset
 +
|}
 +
 
 +
=== Texts ===
 +
 
 +
Text offsets is a list of text positions (2 bytes each) in the text sub-section.
  
 
== Section 9: Sounds ==
 
== Section 9: Sounds ==
  
Contains AKAO sequences.
+
Contains AKAO sequences (can be empty).
 +
 
 +
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
 +
! style="background:rgb(204,204,204)" | Offset
 +
! style="background:rgb(204,204,204)" | Length
 +
! style="background:rgb(204,204,204)" | Description
 +
|-
 +
| 0
 +
| 2 bytes
 +
| Number of AKAOs
 +
|-
 +
| 2
 +
| nbAKAOs * 2 bytes
 +
| AKAOs Positions
 +
|-
 +
| 2 + nbAKAOs * 2
 +
| 2 bytes
 +
| End of section 9
 +
|-
 +
| 4 + nbAKAOs * 2
 +
| Varies * nbAKAOs
 +
| AKAOs
 +
|}
 +
 
  
== Section 10: Sounds ==
+
== Section 10: Sounds/Unknown ==
  
Contains AKAO sequences.
+
Contains AKAO sequence + unknown data (can be empty).
  
 
== Section 11: Textures ==
 
== Section 11: Textures ==

Latest revision as of 05:24, 23 May 2019

By Mirex, JWP, random_npc and myst6re. Edit: We now know the animation and skeleton- see https://github.com/MaKiPL/OpenVIII/blob/4ac151daad7cd1475eb0694dd0715bc35d7a4b39/FF8/debug_battleDat.cs

Header

DAT file is divided into 11 sections (except for c0m127.dat, which contains only 2 sections : 7th and 8th).

Offset Length Description
0 4 bytes Number of sections (always =11, except for c0m127.dat)
4 nbSections * 4 bytes Section Positions
4 + nbSections * 4 4 bytes File size

Section 1: Skeleton

Offset Length Description
0 2 bytes Number of bones
2 6 bytes Unknown
8 s16f (divide by 4096f) scaleX
10 s16f (divide by 4096f) scale -Z
12 s16f (divide by 4096f) scale Y
14 2 bytes Unknown
16 Number of bones * 48 bytes Bones

Bone struct

Offset Length Description
0 2 bytes Parent id
2 s16f (divide by 4096f) Bone size (?)
4 s16f (divide by 4096f) unknown, multiplied by 360f
6 s16f (divide by 4096f) unknown, multiplied by 360f
8 s16f (divide by 4096f) unknown, multiplied by 360f
10 s16f (divide by 4096f) unknown
12 s16f (divide by 4096f) unknown
14 s16f (divide by 4096f) unknown
16 28 bytes Unknown (often empty)

Section 2: Model geometry

Header (data sub table)

Offset Length Description
0 4 bytes Number of objects
4 nbObjects * 4 bytes Object Positions
4 + nbObjects * 4 Varies Object Data (see below)
Varies 4 bytes Total count of vertices

Object Data

Offset Length Description
0 2 bytes Number of Vertices Data
2 Varies * NbVerticesData Vertices Data (see below)
Varies 4 - (absolutePosition % 4) Padding (0x00)
Varies 2 bytes Num triangles
Varies 2 bytes Num quads
Varies 8 bytes Always empty
Varies numTriangles * 16 bytes Triangles
Varies numQuads * 20 bytes Quads

Vertice Data

Offset Length Description
0 2 bytes Bone id
2 2 bytes Number of vertices
4 nbVertices * 6 bytes Vertices (nbVertices * 3 shorts)

Useful structures

struct vertice {
     sint16	x, y, z;
};

(sizeof = 6)

struct triangle {
     uint16	vertex_indexes[3]; // vertex_indexes[0] &= 0xFFF, other bits are unknown
     uint8	texCoords1[2];
     uint8	texCoords2[2];
     uint16	textureID_related;
     uint8	texCoords3[2];
     uint16	u; // textureID_related2
};

(sizeof = 16)

struct quad {
     uint16	vertex_indexes[4]; // vertex_indexes[0] &= 0xFFF, other bits are unknown
     uint8	texCoords1[2];
     uint16	textureID_related;
     uint8	texCoords2[2];
     uint16	u; // textureID_related2
     uint8	texCoords3[2];
     uint8	texCoords4[2];
};

(sizeof = 20)

Section 3: Model animation

Header (data sub table)

Offset Length Description
0 4 bytes Number of animations
4 nbAnimations * 4 bytes Animations Positions

Animation

Offset Length Description
0 1 byte Number of frames
1 Varies Unknown

Section 4: Unknown

Optional section, often empty.

Section 5: Unknown

Unknown sequences.

Header

Offset Length Description
0 2 bytes Number of sequences
2 nbSequences * 2 bytes Sequences Positions

Section 6: unknown

Can be empty.

Section 7: Informations & stats

Offset Length Description
0 24 bytes Monster name
24 4 bytes HP values
28 4 bytes Str values
32 4 bytes Vit values
36 4 bytes Mag values
40 4 bytes Spr values
44 4 bytes Spd values
48 4 bytes Eva values
52 16*4 bytes Abilities, low level
116 16*4 bytes Abilities, med level
180 16*4 bytes Abilities, high level
244 1 byte Med level start
245 1 byte High level start
246 1 byte Unknown (flags, 3 bits used)
247 1 byte [LSB] Zombie / Fly / zz1 / zz2 / zz3 / Auto-Reflect / Auto-Shell / Auto-Protect [MSB]
248 3 bytes Cards (low/med/high)
251 3 bytes Devour (low/med/high)
254 1 byte [LSB] zz1 / zz2 / unused / unused / unused / unused / Diablos missed / Always obtains card [MSB]
255 1 byte Unknown (flags, 4 bits used)
256 2 bytes Extra EXP
258 2 bytes EXP
260 8 bytes Draw (low)
268 8 bytes Draw (med)
276 8 bytes Draw (high)
284 8 bytes Mug (low)
292 8 bytes Mug (med)
300 8 bytes Mug (high)
308 8 bytes Drop (low)
316 8 bytes Drop (med)
324 8 bytes Drop (high)
332 1 byte Mug rate
333 1 byte Drop rate
334 1 byte Padding (0x00)
335 1 byte APs
336 16 bytes Unknown
352 8 bytes Elemental resistance
(Fire, Ice, Thunder, Earth, Poison, Wind, Water, Holy)
360 20 bytes Mental resistance

(Death, Poison, Petrify, Darkness,
Silence, Beserk, Zombie, Sleep,
Haste, Slow, Stop, Regen,
Reflect, Doom, Slow Petrify, Float,
Confuse, Drain, Expulsion, ???)

Abilities

typedef struct {
    uint8 kernel_id;
    uint8 unknown;
    uint16 ability_id;
}

kernel_id is the used table in kernel.bin. May be 0x02 (= magic), 0x04 (= item) or 0x08 (= monster ability). ability_id is the ability in the selected kernel table.

Draw/mug/drop

typedef struct {
    uint8 id_1; // magic_id for draw, item_id for mug & drop
    uint8 qty_1; // quantities are always 0 for draw
    uint8 id_2;
    uint8 qty_2;
    uint8 id_3;
    uint8 qty_3;
    uint8 id_4;
    uint8 qty_4;
}

Section 8: Battle scripts/AI

Offset Length Description
0 4 bytes Number of sub-sections
4 4 bytes Offset to AI sub-section
8 4 bytes Offset to text offsets
12 4 bytes Offset to text sub-section

AI

Offset Length Description
0 4 bytes Offset to init code
4 4 bytes Offset to code executed at ennemy's turn
8 4 bytes Offset to counterattack code
12 4 bytes Offset to death code
16 4 bytes Unknown offset

Texts

Text offsets is a list of text positions (2 bytes each) in the text sub-section.

Section 9: Sounds

Contains AKAO sequences (can be empty).

Offset Length Description
0 2 bytes Number of AKAOs
2 nbAKAOs * 2 bytes AKAOs Positions
2 + nbAKAOs * 2 2 bytes End of section 9
4 + nbAKAOs * 2 Varies * nbAKAOs AKAOs


Section 10: Sounds/Unknown

Contains AKAO sequence + unknown data (can be empty).

Section 11: Textures

Contains some TIMs with size 128x128 (8bit paletized).

Offset Length Description
0 4 bytes Number of TIMs
4 nbTIMs * 4 bytes TIMs Positions
4 + nbTIMs * 4 4 bytes End of file
8 + nbTIMs * 4 Varies * nbTIMs TIMs