View source for MKAGP BIN (File Format)

'''MKAGP BIN''' is a collision format used in [[Mario Kart Arcade GP]] and [[Mario Kart Arcade GP 2]].

= File Format =
The file byte order is always big endian.

== Header ==
The file starts with the following header:

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Int32 || '''Grid width''' ('''W''').
|-
| 0x04 || Int32 || '''Grid length''' ('''L''').
|-
| 0x08 || Float || '''Grid cell X size'''.
|-
| 0x0C || Float || '''Grid cell Y size'''.
|-
| 0x10 || Float[2] || '''AABB minimum coordinate XZ'''. 
|-
| 0x18 || Float[2] || '''AABB maximum coordinate XZ'''.
|-
| 0x20 || Float[2] || '''Negative AABB minimum coordinate XZ'''. Unknown usage.
|-
| 0x28 || UInt32 || '''[[#Grid|Grids]] offset'''.
|}

== Grid ==
At the end of the file, '''W''' * '''L''' grid cell headers are stored in 0x10 byte blocks.

=== Cell ===
All offsets are absolute.

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || UInt32 || '''Triangles offset'''. Garbage data if none for this cell.
|-
| 0x04 || Int32 || '''Number of [[#Triangle|Triangles]]'''.
|-
| 0x08 || UInt32 || '''Cubes offset'''. Garbage data if none for this cell.
|-
| 0x0C || Int32 || '''Number of [[#Wall|Walls]]'''.
|}

==== Triangle ====
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Float[2] || '''Minimal coordinate''' for this triangle.
|-
| 0x08 || Float[2] || '''Maximal coordinate''' for this triangle.
|-
| 0x10 || Float[3][3] || '''Triangle vertices''' XYZ position.
|-
| 0x34 || Float[3][3] || '''Triangle edges''' XYZ position.
|-
| 0x58 || UInt32 || '''Neighbour triangle flag''', used to determine which edges connect to other triangles.
|-
| 0x5C || UInt32 || '''[[MKAGP BIN flag]]'''.
|-
| 0x60 || Float[3] || '''Triangle normal'''.
|-
| 0x6C || Float || '''Negative dot product''' between triangle center and triangle normal.
|}

==== Wall ====
There are '''C''' 0x20 walls, which are used for wall collision detection. The walls are auto-generated from [[#Triangle|all triangles]] by checking which edges are missing neighbour triangles.

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Float[2] || '''Min XZ''' of the triangle edge.
|-
| 0x08 || Float[2] || '''Max XZ''' of the triangle edge.
|-
| 0x10 || Float[2] || '''Position 1 XZ''' of the triangle edge forming the wall.
|-
| 0x18 || Float[2] || '''Position 2 XZ''' of the triangle edge forming the wall.
|}

= Tools =
The following tools can handle MKAGP BIN files:
* (none)

[[Category:Mario Kart Arcade GP File Formats]]