View source for Formats/SSXTricky:MPF(PS2 Model)

== Overview ==
An MPF file contains model names, bones, UV maps, normals, vertices and other model data.

Here is the structure made in programming languages for easy code implementation:

- [SSX Tricky mpf C# handler by GlitcherOG](<nowiki>https://github.com/GlitcherOG/SSX-PS2-Collection-Modder/blob/main/FileHandlers/Models/TrickyMPFModelHandler.cs</nowiki>)

- [SSX Tricky mpf GO struct by Erick](<nowiki>https://github.com/Erickson400/TheTrickyModels/blob/main/mpf/MpfStructure.go</nowiki>)

== Structure ==

=== File Header ===
Section 0 - Bytes[12]
{| class="wikitable"
|+
!Type
!Description
|-
|Byte[4]
|Unknown (Possibly version or magic)
|-
|UInt16
|Model Header Count
|-
|UInt16
|Offset To Model Headers
|-
|UInt32
|Offset To Model Data List Start
|}

=== Model Header ===
All Offsets Within the file are relative to the start of the Model Data
{| class="wikitable"
!Type
!Description
|-
|Bytes[16]
|Name of Model (ASCII string with a max length of 16 bytes)
|-
|UInt32 
|Offset to Model Data which is relative to Model Data List Start Offset
|-
|UInt32 
|Size of model in bytes
|-
|UInt32 
|Offset of **Bone Data List**
|-
|UInt32 
|Offset of **IK Point List**
|-
|UInt32 
|Offset of **Mesh Group Offset**
|-
|UInt32 
|Offset of **Mesh Data**
|-
|UInt32 
|Offset Of **Material Data**
|-
|UInt32 
|Offset of Weight List Reference
|-
|UInt32 
|Offset of Bone Weights
|-
|UInt32 
|Unknown (Unused/Filler)
|-
|UInt32 
|Unknown (Unused/Filler)
|-
|UInt16
|Num of Bone Weights
|-
|UInt16
|Num of Weight List Refrence
|-
|UInt16
|Num Of Mesh Groups
|-
|UInt16
|Num Of Bone Data
|-
|UInt16
|Num Of Materials
|-
|UInt16
|Num Of IK Points
|-
|UInt16
|Num Of Morph Keys
|-
|UInt16
|Internal File ID. This is used in conjunction with weights so that it can access bones within another file
|-
|UInt32
|Filler/Padding
|}

=== Model Data ===
All Offsets Unless Stated Otherwise are relative to the start of model data

==== <u>Material Data</u> ====
Unused Slots use 0x00202020 as a place holder
{| class="wikitable"
!Type
!Description
|-
|Bytes[4]
|Name of Main Texture map/file
|-
|Bytes[4]
|Name/Type of Texture (Unused In PS2)
|-
|Bytes[4]
|Name/Type of Texture (Unused In PS2)
|-
|Bytes[4]
|Name/Type of Texture (Unused In PS2)
|-
|Bytes[4]
|Name/Type of Texture (Unused In PS2)
|-
|Float32
|Unknown float value
|-
|Float32  
|Unknown float value
|-
|Float32
|Unknown float value
|}

==== <u>Bone Data</u> ====
Location and Rotation are relative to parent
{| class="wikitable"
!Type
!Description
|-
|Bytes[16]
|Name of Bone (ASCII string with a maximum length of 16 bytes)
|-
|UInt16
|Internal File ID of Parent Bone(First bone always has 0xFFFF)
|-
|UInt16
|ID of Parent Bone (First bone always has 0xFFFF)
|-
|UInt16
|Bone ID (?)
|-
|UInt16
|Unknown
|-
|Vector 3 (3 Float32s)
|XYZ Position Of the Bone
|-
|Vector 3 (3 Float32s)
|XYZ Radian Rotation of the bone
|-
|Vector 3 (3 Float32s)
|XYZ Radian 2
|-
|6 Float32s
|6 Floats either being -1 or 1
|}

==== <u>IK Points</u> ====
{| class="wikitable"
!Type
!Description
|-
|Vector 3 (3 Float32s)
|Location XYZ
|-
|UInt32
|Unknown (Filler) 
|}

==== <u>Group Main</u> ====

===== Group Main Header =====
{| class="wikitable"
!Type
!Description
|-
|UInt32
|Group Type (1 Standard, 17 Shadow, 256 Morph)
|-
|UInt32
|Material ID
|-
|UInt32
|Unknown (Always -1)
|-
|UInt32
|Sub Group Offset
|-
|UInt32
|Sub Group Count
|}

==== Sub Group ====
{| class="wikitable"
!Type
!Description
|-
|UInt32
|Mesh Group Offset
|-
|UInt32
|Mesh Group Count
|}
==== Mesh/Morph Data Group ====
Each one of these in order references a Weight Reference and all points within it will use that weight reference  
{| class="wikitable"
!Type
!Description
|-
|UInt32
|Model Offset
|-
|UInt32
|Morph Target Offset Relative to Model Offset
|-
|UInt32
|Morph Target Entry Size
|}

==== <u>Bone Weight</u> ====

===== Bone Weight Header =====
{| class="wikitable"
!Type
!Description
|-
|UInt32
|Length of array/list
|-
|UInt32
|Offset to Bone weight list
|-
|UInt32
|Unknown (Always 36)
|}

===== Bone Weight =====
{| class="wikitable"
!Type
!Description
|-
|UInt16
|Bone weight (0 to 100)
|-
|UInt16
|Bone ID
|-
|UInt16
|Bone Internal File ID
|}

==== <u>Weight List Ref</u> ====
{| class="wikitable"
!Type
!Description
|-
|UInt32
|Weight Reference Count
|-
|UInt32
|Weight Reference Offset
|-
|Int32 List
|WeightIDs
|}

==== <u>Mesh Data</u> ====
The mesh data within the mpf can be very complex and is chunked meaning there can be multiple data chunks within a Mesh/Morph Data Group

Depending on the group type (Located in the mesh group) can effect what information is in here. 

* If Group Type is Standard there will be UV/Weight Block, Normal Block and, Vertex Block. 
* If Group Type is Shadow There will be Shadow Vertex Block
* If Group Type is Morph the data will be the same as standard however there will be no data chunking

Bytes[48] Unimportant Data for Exporting
{| class="wikitable"
!Type
!Description
|-
|UInt32
|Strip Count
|-
|UInt32
|Unknown1
|-
|UInt32
|Unknown2 (If group type is shadow this will be 0)
|-
|UInt32
|Vertex Count
|}

===== Tristrip Data =====
{| class="wikitable"
!Type
!Description
|-
|UInt32
|Count of vertices
|-
|Bytes[12]
|Padding
|}

==== UV/Weight Block ====
{| class="wikitable"
!Type
!Description
|-
|Bytes[16]
|Header of UV Block (Hex: 00100000 00100000 00000020 50505050)
|-
|Bytes[12]
|Unknown
|-
|Byte 
|Unknown
|-
|Byte
|Prefix List Start (0x80)
|-
|Byte
|Count of UVs
|-
|Byte
|Suffix of UV count (0x6D)
|-
|List of '''''UV value'''''
|List Of UV/Weights Values
|}
'''''UV value'''''
{| class="wikitable"
!Type
!Description
|-
|UInt16
|UV map U (X translation) (In order to get the float value you do Number / 4096)
|-
|UInt16
|UV map V (Y translation) (In order to get the float value you do Number / 4096)
|-
|UInt16
|Bone Weight Ref ID (In order to get ID you do (Number - 14)/4)
|-
|Uint16
|Bone Weight Ref ID (In order to get ID you do ???)
|}

===== Normal Block =====
{| class="wikitable"
!Type
!Description
|-
|Bytes[16]
|Header of normal Block (Hex: 00000000 00800000 00000020 40404040)
|-
|Bytes[12]
|Unknown
|-
|Byte 
|Unknown
|-
|Byte
|Prefix List Start (0x80)
|-
|Byte
|Count of Normals
|-
|Byte
|Suffix of Normal count (??)
|-
|List of Vector 3 (3 Int16s)
|List of normals (In order to get the float value you do Number / 4096(???))
|}

==== Vertex Block ====
{| class="wikitable"
!Type
!Description
|-
|Bytes[16]
|Header of Vertex Block (Hex: 00000000 0000803F 00000020 40404040)
|-
|Bytes[12]
|Unknown
|-
|Byte 
|Unknown
|-
|Byte
|Prefix List Start (0x80)
|-
|Byte
|Count of Vertices
|-
|Byte
|Suffix of Vertex count (0x78)
|-
|List of Vector 3 (3 Float32)
|List Of Vertex values
|}

==== Shadow Vertex Block ====
{| class="wikitable"
!Type
!Description
|-
|Bytes[16]
|Header of Vertex Block (Hex: 00000000 0000803F 00000020 40404040)
|-
|Bytes[12]
|Unknown
|-
|Byte 
|Unknown
|-
|Byte
|Prefix List Start (0x80)
|-
|Byte
|Count of Vertices
|-
|Byte
|Suffix of Vertex count (??)
|-
|List of '''''Shadow Vertex'''''
|List Of Shadow Vertex values
|}
'''''Shadow Vertex value'''''
{| class="wikitable"
!Type
!Description
|-
|Vector 3 (3 Float32)
|Location XYZ
|-
|Uint16
|Bone Weight Ref ID (In order to get ID you do (Number - 14)/4)
|}