Retro Modding Wiki - User contributions [en]

MAPA (File Format)

2017-04-27T11:46:56Z

Claris: The Corruption format should actually be correct now

The '''.MAPA file format''' defines the minimap models used in the Metroid Prime series. MAPA or '''MAP A'''rea consists of several sections: The header, Mappable Object entries, Vertices, Primitive Headers, and the primitives.

{{research|2|A few things are unknown in the header and Mappable Object Entries}}

__TOC__
== Format ==
=== Header ===
The header is very straightforward, and has some minor differences depending on version.

{| class="wikitable"
!Type
!Description
!MP1
!MP2
!MP3
|-
|u32
|'''Magic'''; Always 0xDEADD00D
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Version'''; See below
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Type'''; unknown function in MP1/3, specifies whether the area appears on the Light (0) or Dark (1) map in MP2
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Visibility Mode'''; <ol start=0><li>Always Visible (Map Universe Area)</li><li>Visible on Visit or Map Station (most MP1 areas)</li><li>Visible on Visit only (latter areas of Ruins and Phendrana)</li><li>Never Visible</li></ol>
|{{check}}
|{{check}}
|{{check}}
|-
|{{AABox}}
|'''Bounding Box'''
|{{check}}
|{{check}}
|{{check}}
|-
|{{Vector3f}}
|'''Map Adjustment'''
|{{nocheck}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{nocheck}}
|{{check}}
|-
|u32
|'''Mappable Object Count'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Vertex Count'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Primitive Count'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Environment Variable Section Size'''
|{{nocheck}}
|{{nocheck}}
|{{check}}
|-
|u32
|'''Environment Variable Count'''
|{{nocheck}}
|{{nocheck}}
|{{check}}
|-
| colspan=5 {{unknown|End of Header}}
|}

==== Version ====
The version value listed above can have the following values:
{|class="wikitable"
!Game
!Value
|-
|Metroid Prime 1
|2
|-
|Metroid Prime 2: Echoes
|3
|-
|Metroid Prime 3: Corruption
|5
|}

=== Environment Variables ===
Only exists in Corruption; used for some areas with Landing Sites.
{|class="wikitable"
!Type
!Count
!Description
|-
|string
|Environment Variable Count
|'''Environment Variable'''
|-
| colspan=3 {{unknown|Pad to 4 bytes}}
|-
| colspan=3 {{unknown|End of Environment Variables}}
|}

=== Mappable Objects ===
A Mappable Object in the Metroid Prime series can include: Elevators, Doors, and Save/Missile Stations. Each Mappable Object entry consists of the following struct:
{|class="wikitable"
!Type
!Description
!MP1 & MP2
!MP3
|-
|u32
|'''Type'''; See table below for MP1 types
|{{check}}
|{{check}}
|-
|u32
|'''Visibility Mode'''; <ol start=0><li>Always Visible</li><li>Visible on Map Station or Area Visit</li><li>Visible on Door Visit</li><li>Never Visible</li><li>Visible on Map Station or Area Visit</li></ol>
|{{check}}
|{{check}}
|-
|u32
|'''Editor ID'''; Same ID format as SCLY, indicates associated world object
|{{check}}
|{{check}}
|-
|[[Saved State ID]]
|'''Saved State ID'''
|{{nocheck}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{check}}
|{{check}}
|-
|{{Transform4f}}
|'''Transform Matrix''' The Mappable Object's position in '''world''' space.
|{{check}}
|{{check}}
|-
|u32 * 4
|{{unknown|Unknown}}
|{{check}}
|{{check}}
|-
| colspan=4 {{unknown|End of Mappable Object}}
|}

==== MP1 Types ====
{|class="wikitable"
!Type
!Description
|-
|0
|Normal Door
|-
|1
|Shield Door
|-
|2
|Ice Door
|-
|3
|Wave Door
|-
|4
|Plasma Door
|-
|5
|Big Door
|-
|6
|Big Door 2
|-
|7
|Ice Door Ceiling
|-
|8
|Ice Door Floor
|-
|9
|Wave Door Ceiling
|-
|10
|Wave Door Floor
|-
|11
|Plasma Door Ceiling
|-
|12
|Plasma Door Floor
|-
|13
|Ice Door Floor 2
|-
|14
|Wave Door Floor 2
|-
|15
|Plasma Door Floor 2
|-
|27
|Down Arrow Yellow (Maintenance Tunnel)
|-
|28
|Up Arrow Yellow (Phazon Processing Center)
|-
|29
|Down Arrow Green (Elevator A)
|-
|30
|Up Arrow Green (Elite Control Access)
|-
|31
|Down Arrow Red (Elevator B)
|-
|32
|Up Arrow Red (Fungal Hall Access)
|-
|33
|Elevator
|-
|34
|Save Station
|-
|37
|Missile Station
|}

=== Vertices ===

Vertices are a simple array of CVector3f. Geometry in MAPAs is, almost always, centered around the origin (0, 0, 0) and are simplified, full sized, versions of the map they replicate. Each vertex is referenced at least twice: once for the primitive, once for the line border.

=== Primitive Headers ===

The Primitive headers are extremely simple, they merely have a bounding box followed by the primitive table start and end point, relative to the end of the current primitive header. In other words: read in the header, seek to the start of the table from the '''current''' position, then read the primitives tables.

{|class="wikitable"
!Type
!Description
|-
|{{Vector3f}}
|'''Normal'''
|-
|{{Vector3f}}
|'''Center of Mass'''
|-
|u32
|'''Primitive Table Start'''; relative to the end of the header
|-
|u32
|'''Border Table Start'''; relative to the end of the header
|}

=== Primitive Table ===

The Primitive is also fairly simple, each one consists of two parts: The GX Primitive list, and the Border list.
{|class="wikitable"
!Type
!Description
|-
|u32
|'''Primitive Count (PC)'''
|-
|Primitive * PC
|'''Primitives'''
|-
|u32
|'''Border Count (BC)'''
|-
|Border * (BC)
|'''Borders'''
|}

=== Primitive ===

A primitive in a MAPA is a simple 4 byte aligned list of indices into the vertex list, starting with the GX Primitive type, a count, then an array of indices, each index taking up one byte.

=== Border ===

A border in a MAPA is a simple count followed by a 4 byte aligned list indices into the vertex list, each index taking up one byte. A border is simply drawn using GX_LINESTRIP.

[[Category:File Formats]]
[[Category:Metroid Prime]]
[[Category:Metroid Prime 2: Echoes]]
[[Category:Metroid Prime 3: Corruption]]

MAPA (File Format)

2017-04-27T05:37:46Z

Claris: Saved State ID

The '''.MAPA file format''' defines the minimap models used in the Metroid Prime series. MAPA or '''MAP A'''rea consists of several sections: The header, Mappable Object entries, Vertices, Primitive Headers, and the primitives.

{{research|2|A few things are unknown in the header and Mappable Object Entries}}

__TOC__
== Format ==
=== Header ===
The header is very straight forward, and has some minor differences depending on version, the unknown values don't seem to do anything, however not much research has been put into them.

{| class="wikitable"
!Type
!Description
!MP1
!MP2
!MP3
|-
|u32
|'''Magic'''; Always 0xDEADD00D
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Version'''; See below
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Type'''; unknown function in MP1/3, specifies whether the area appears on the Light (0) or Dark (1) map in MP2
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Visibility Mode'''; <ol start=0><li>Always Visible (Map Universe Area)</li><li>Visible on Visit or Map Station (most MP1 areas)</li><li>Visible on Visit only (latter areas of Ruins and Phendrana)</li><li>Never Visible</li></ol>
|{{check}}
|{{check}}
|{{check}}
|-
|{{AABox}}
|'''Bounding Box'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{nocheck}}
|{{check}}
|-
|u32
|'''Mappable Object Count'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Vertex Count'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Primitive Count'''
|{{check}}
|{{check}}
|{{check}}
|}

==== Version ====
The version value listed above can have the following values:
{|class="wikitable"
!Game
!Value
|-
|Metroid Prime 1
|2
|-
|Metroid Prime 2: Echoes
|3
|-
|Metroid Prime 3: Corruption
|5
|}

=== Mappable Objects ===
A Mappable Object in the Metroid Prime series can include: Elevators, Doors, and Save/Missile Stations. Each Mappable Object entry consists of the following struct:
{|class="wikitable"
!Type
!Description
!MP1 & MP2
!MP3
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|-
|u32
|'''Type'''; See table below for MP1 types
|{{check}}
|{{check}}
|-
|u32
|'''Visibility Mode'''; <ol start=0><li>Always Visible</li><li>Visible on Map Station or Area Visit</li><li>Visible on Door Visit</li><li>Never Visible</li><li>Visible on Map Station or Area Visit</li></ol>
|{{check}}
|{{check}}
|-
|u32
|'''Editor ID'''; Same ID format as SCLY, indicates associated world object
|{{check}}
|{{nocheck}}
|-
|[[Saved State ID]]
|'''Saved State ID'''
|{{nocheck}}
|{{check}}
|-
|u32
|'''Padding'''; always -1
|{{check}}
|{{check}}
|-
|{{Transform4f}}
|'''Transform Matrix''' The Mappable Object's position in '''world''' space.
|{{check}}
|{{check}}
|-
|u32 * 4
|'''Padding'''; four values of -1
|{{check}}
|{{check}}
|}

==== MP1 Types ====
{|class="wikitable"
!Type
!Description
|-
|0
|Normal Door
|-
|1
|Shield Door
|-
|2
|Ice Door
|-
|3
|Wave Door
|-
|4
|Plasma Door
|-
|5
|Big Door
|-
|6
|Big Door 2
|-
|7
|Ice Door Ceiling
|-
|8
|Ice Door Floor
|-
|9
|Wave Door Ceiling
|-
|10
|Wave Door Floor
|-
|11
|Plasma Door Ceiling
|-
|12
|Plasma Door Floor
|-
|13
|Ice Door Floor 2
|-
|14
|Wave Door Floor 2
|-
|15
|Plasma Door Floor 2
|-
|27
|Down Arrow Yellow (Maintenance Tunnel)
|-
|28
|Up Arrow Yellow (Phazon Processing Center)
|-
|29
|Down Arrow Green (Elevator A)
|-
|30
|Up Arrow Green (Elite Control Access)
|-
|31
|Down Arrow Red (Elevator B)
|-
|32
|Up Arrow Red (Fungal Hall Access)
|-
|33
|Elevator
|-
|34
|Save Station
|-
|37
|Missile Station
|}

=== Vertices ===

Vertices are a simple array of CVector3f. Geometry in MAPAs is, almost always, centered around the origin (0, 0, 0) and are simplified, full sized, versions of the map they replicate. Each vertex is referenced at least twice: once for the primitive, once for the line border.

=== Primitive Headers ===

The Primitive headers are extremely simple, they merely have a bounding box followed by the primitive table start and end point, relative to the end of the current primitive header. In other words: read in the header, seek to the start of the table from the '''current''' position, then read the primitives tables.

{|class="wikitable"
!Type
!Description
|-
|{{Vector3f}}
|'''Normal'''
|-
|{{Vector3f}}
|'''Center of Mass'''
|-
|u32
|'''Primitive Table Start'''; relative to the end of the header
|-
|u32
|'''Border Table Start'''; relative to the end of the header
|}

=== Primitive Table ===

The Primitive is also fairly simple, each one consists of two parts: The GX Primitive list, and the Border list.
{|class="wikitable"
!Type
!Description
|-
|u32
|'''Primitive Count (PC)'''
|-
|Primitive * PC
|'''Primitives'''
|-
|u32
|'''Border Count (BC)'''
|-
|Border * (BC)
|'''Borders'''
|}

=== Primitive ===

A primitive in a MAPA is a simple 4 byte aligned list of indices into the vertex list, starting with the GX Primitive type, a count, then an array of indices, each index taking up one byte.

=== Border ===

A border in a MAPA is a simple count followed by a 4 byte aligned list indices into the vertex list, each index taking up one byte. A border is simply drawn using GX_LINESTRIP.

[[Category:File Formats]]
[[Category:Metroid Prime]]
[[Category:Metroid Prime 2: Echoes]]
[[Category:Metroid Prime 3: Corruption]]

MAPA (File Format)

2017-04-27T05:19:11Z

Claris: Consistent naming

The '''.MAPA file format''' defines the minimap models used in the Metroid Prime series. MAPA or '''MAP A'''rea consists of several sections: The header, Mappable Object entries, Vertices, Primitive Headers, and the primitives.

{{research|2|A few things are unknown in the header and Mappable Object Entries}}

__TOC__
== Format ==
=== Header ===
The header is very straight forward, and has some minor differences depending on version, the unknown values don't seem to do anything, however not much research has been put into them.

{| class="wikitable"
!Type
!Description
!MP1
!MP2
!MP3
|-
|u32
|'''Magic'''; Always 0xDEADD00D
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Version'''; See below
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Type'''; unknown function in MP1/3, specifies whether the area appears on the Light (0) or Dark (1) map in MP2
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Visibility Mode'''; <ol start=0><li>Always Visible (Map Universe Area)</li><li>Visible on Visit or Map Station (most MP1 areas)</li><li>Visible on Visit only (latter areas of Ruins and Phendrana)</li><li>Never Visible</li></ol>
|{{check}}
|{{check}}
|{{check}}
|-
|{{AABox}}
|'''Bounding Box'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|{{check}}
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{nocheck}}
|{{check}}
|-
|u32
|'''Mappable Object Count'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Vertex Count'''
|{{check}}
|{{check}}
|{{check}}
|-
|u32
|'''Primitive Count'''
|{{check}}
|{{check}}
|{{check}}
|}

==== Version ====
The version value listed above can have the following values:
{|class="wikitable"
!Game
!Value
|-
|Metroid Prime 1
|2
|-
|Metroid Prime 2: Echoes
|3
|-
|Metroid Prime 3: Corruption
|5
|}

=== Mappable Objects ===
A Mappable Object in the Metroid Prime series can include: Elevators, Doors, and Save/Missile Stations. Each Mappable Object entry consists of the following struct:
{|class="wikitable"
!Type
!Description
!MP1 & MP2
!MP3
|-
|u32
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|-
|u32
|'''Type'''; See table below for MP1 types
|{{check}}
|{{check}}
|-
|u32
|'''Visibility Mode'''; <ol start=0><li>Always Visible</li><li>Visible on Map Station or Area Visit</li><li>Visible on Door Visit</li><li>Never Visible</li><li>Visible on Map Station or Area Visit</li></ol>
|{{check}}
|{{check}}
|-
|u32
|'''Editor ID'''; Same ID format as SCLY, indicates associated world object
|{{check}}
|{{nocheck}}
|-
|{{Vector4f}}
|{{unknown|Unknown}}
|{{nocheck}}
|{{check}}
|-
|u32
|'''Padding'''; always -1
|{{check}}
|{{check}}
|-
|{{Transform4f}}
|'''Transform Matrix''' The Mappable Object's position in '''world''' space.
|{{check}}
|{{check}}
|-
|u32 * 4
|'''Padding'''; four values of -1
|{{check}}
|{{check}}
|}

==== MP1 Types ====
{|class="wikitable"
!Type
!Description
|-
|0
|Normal Door
|-
|1
|Shield Door
|-
|2
|Ice Door
|-
|3
|Wave Door
|-
|4
|Plasma Door
|-
|5
|Big Door
|-
|6
|Big Door 2
|-
|7
|Ice Door Ceiling
|-
|8
|Ice Door Floor
|-
|9
|Wave Door Ceiling
|-
|10
|Wave Door Floor
|-
|11
|Plasma Door Ceiling
|-
|12
|Plasma Door Floor
|-
|13
|Ice Door Floor 2
|-
|14
|Wave Door Floor 2
|-
|15
|Plasma Door Floor 2
|-
|27
|Down Arrow Yellow (Maintenance Tunnel)
|-
|28
|Up Arrow Yellow (Phazon Processing Center)
|-
|29
|Down Arrow Green (Elevator A)
|-
|30
|Up Arrow Green (Elite Control Access)
|-
|31
|Down Arrow Red (Elevator B)
|-
|32
|Up Arrow Red (Fungal Hall Access)
|-
|33
|Elevator
|-
|34
|Save Station
|-
|37
|Missile Station
|}

=== Vertices ===

Vertices are a simple array of CVector3f. Geometry in MAPAs is, almost always, centered around the origin (0, 0, 0) and are simplified, full sized, versions of the map they replicate. Each vertex is referenced at least twice: once for the primitive, once for the line border.

=== Primitive Headers ===

The Primitive headers are extremely simple, they merely have a bounding box followed by the primitive table start and end point, relative to the end of the current primitive header. In other words: read in the header, seek to the start of the table from the '''current''' position, then read the primitives tables.

{|class="wikitable"
!Type
!Description
|-
|{{Vector3f}}
|'''Normal'''
|-
|{{Vector3f}}
|'''Center of Mass'''
|-
|u32
|'''Primitive Table Start'''; relative to the end of the header
|-
|u32
|'''Border Table Start'''; relative to the end of the header
|}

=== Primitive Table ===

The Primitive is also fairly simple, each one consists of two parts: The GX Primitive list, and the Border list.
{|class="wikitable"
!Type
!Description
|-
|u32
|'''Primitive Count (PC)'''
|-
|Primitive * PC
|'''Primitives'''
|-
|u32
|'''Border Count (BC)'''
|-
|Border * (BC)
|'''Borders'''
|}

=== Primitive ===

A primitive in a MAPA is a simple 4 byte aligned list of indices into the vertex list, starting with the GX Primitive type, a count, then an array of indices, each index taking up one byte.

=== Border ===

A border in a MAPA is a simple count followed by a 4 byte aligned list indices into the vertex list, each index taking up one byte. A border is simply drawn using GX_LINESTRIP.

[[Category:File Formats]]
[[Category:Metroid Prime]]
[[Category:Metroid Prime 2: Echoes]]
[[Category:Metroid Prime 3: Corruption]]

Metroid Prime 2: Echoes

2016-12-11T19:54:27Z

Claris:

'''Metroid Prime 2: Echoes''' is the sequel to the critically acclaimed [[Metroid Prime]], and the second game developed by Retro.

__TOC__

== Builds ==

{| class="wikitable"
! Build
! Date/Time
! Version
|-
| v0.160
| 6/29/2004 18:53:25
| Metroid Prime 2: Echoes Bonus Disc
|-
| v1.028
| 10/18/2004 10:44:32
| GameCube 0-00 NTSC (Original Release)
|-
| v1.035
| 10/27/2004 19:48:17
| GameCube 0-00 PAL
|-
| v1.036
| 12/20/2004 11:53:11
| GameCube 0-00 NTSC-J
|-
| v3.593
| 2008/08/21 17:09
| Metroid Prime: Trilogy
|}

== Formats ==

{| class="wikitable"
! Format
! Contents
|-
| [[AFSM (File Format)|AFSM]]
| AI Finite State Machine
|-
| [[AGSC (File Format)|AGSC]]
| Audio Group Set
|-
| [[ANCS (File Format)|ANCS]]
| Animation/Character Set
|-
| [[ANIM (File Format)|ANIM]]
| Animation
|-
| [[ATBL (File Format)|ATBL]]
| Audio Lookup Table
|-
| [[CINF (File Format)|CINF]]
| Skeleton
|-
| [[CMDL (Metroid Prime)|CMDL]]
| Model
|-
| [[CRSC (File Format)|CRSC]]
| Collision Response Particle System
|-
| [[CSKR (File Format)|CSKR]]
| Skin Rules
|-
| [[CSNG (File Format)|CSNG]]
| MusyX MIDI File
|-
| [[CSPP (File Format)|CSPP]]
| Spatial Primitive
|-
| [[DCLN (File Format)|DCLN]]
| Dynamic Collision
|-
| [[DGRP (File Format)|DGRP]]
| Dependency Group
|-
| [[DPSC (File Format)|DPSC]]
| Decal Particle System
|-
| [[DSP (File Format)|DSP]]
| Music
|-
| [[DUMB (File Format)|DUMB]]
| Binary Data
|-
| [[EGMC (File Format)|EGMC]]
| Editor Object to Static Geometry Map
|-
| [[ELSC (File Format)|ELSC]]
| Electric Particle System
|-
| [[FONT (File Format)|FONT]]
| Font
|-
| [[FRME (File Format)|FRME]]
| GUI Frame
|-
| [[FSM2 (File Format)|FSM2]]
| Finite State Machine 2
|-
| [[HINT (File Format)|HINT]]
| Hint System
|-
| [[MAPA (File Format)|MAPA]]
| Area Map
|-
| [[MAPU (File Format)|MAPU]]
| Universe Map
|-
| [[MAPW (File Format)|MAPW]]
| World Map
|-
| [[MLVL (File Format)|MLVL]]
| World
|-
| [[MREA (File Format)|MREA]]
| Area
|-
| [[NTWK (File Format)|NTWK]]
| Tweaks
|-
| [[PAK (Metroid Prime)|PAK]]
| Package
|-
| [[PART (File Format)|PART]]
| Particle System
|-
| [[PATH (File Format)|PATH]]
| Pathfinding
|-
| [[PTLA (File Format)|PTLA]]
| Portal Area
|-
| [[REL (File Format)|REL]]
| Relocatable Module
|-
| [[RULE (File Format)|RULE]]
| Rule Set
|-
| [[SAVW (File Format)|SAVW]]
| World Save Info
|-
| [[SCAN (Metroid Prime 2)|SCAN]]
| Scannable Object Info
|-
| [[SPSC (File Format)|SPSC]]
| Spawn Particle System
|-
| [[SRSC (File Format)|SRSC]]
| Sorted Particle System
|-
| [[STLC (File Format)|STLC]]
| String List
|-
| [[STRG (File Format)|STRG]]
| String Table
|-
| [[SWHC (File Format)|SWHC]]
| Swoosh Particle System
|-
| [[THP (File Format)|THP]]
| Video
|-
| [[TXTR (Metroid Prime)|TXTR]]
| Texture
|-
| [[WPSC (File Format)|WPSC]]
| Weapon Particle System
|}

[[Category:Games]]
[[Category:Metroid Prime 2: Echoes]]

MLVL (File Format)

2016-08-14T23:49:54Z

Claris: Dock Count

The '''MLVL format''' defines worlds in the Metroid Prime trilogy and Donkey Kong Country Returns. While the [[MREA (File Format)|MREA format]] defines individual areas, the MLVL is what links together all the areas to create a single cohesive world.

{{research|minor|There's a couple unknown values in this format, but they all seem to have constant values.}}

__TOC__

== Format ==

The format largely defines properties related to each area in general and how they link together, as well as things that apply to the world on a global scale across all areas, such as the skybox.

{| class="wikitable"
! Type
! Count
! Name
! Notes
! MP1
! MP2
! MP3
! DKCR
|-
| u32
| 1
| '''Magic'''
| Always <code>0xDEAFBABE</code>
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Version'''
| [[#Version|See below]]
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[STRG (File Format)|STRG]])
| 1
| '''World Name ID'''
| [[STRG (File Format)|STRG]] file for the world name.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[STRG (File Format)|STRG]])
| 1
| '''Dark World Name ID'''
| [[STRG (File Format)|STRG]] file for the Dark World name.
| {{nocheck}}
| {{check}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Temple Key World Index'''
| Controls which temple key icons appear on the map screen. Appears in Prime 3 but always 0.
| {{nocheck}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| bool
| 1
| '''Has Time Attack'''
| Indicates whether this world has a Time Attack mode. '''If false, the next five values are not present.'''
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| string
| 1
| '''Level Number'''
| String of the world/level number; for example, "1-1". Purpose unknown.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| float
| 1
| '''Time Attack Bronze Time'''
| Target time for a bronze medal in Time Attack.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| float
| 1
| '''Time Attack Silver Time'''
| Target time for a silver medal in Time Attack.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| float
| 1
| '''Time Attack Gold Time'''
| Target time for a gold medal in Time Attack.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| float
| 1
| '''Time Attack Shiny Gold Time'''
| Target time for a shiny gold medal in Time Attack.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| Asset ID ([[SAVW (File Format)|SAVW]])
| 1
| '''World Save Info ID'''
| Asset ID for this world's [[SAVW (File Format)|SAVW]] file.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[CMDL (File Format)|CMDL]])
| 1
| '''Default Skybox ID'''
| [[CMDL (File Format)|CMDL]] file for this world's default skybox model. This can be overridden per-area by AreaAttributes objects.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Memory Relay Count'''
| Count of all outgoing connections from Memory Relay instances in this world.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| [[#Memory Relay|Memory Relay]]
| ''Memory Relay Count''
| '''Memory Relay Array'''
| Array describing all outgoing Memory Relay connections in this world. Memory Relays connected to multiple objects are listed multiple times.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Area Count'''
| Count of areas in this world.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| {{unknown|Unknown}}
| Always 1?
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| [[#Area|Area]]
| ''Area Count''
| '''Area Array'''
| Array defining all areas that appear in this world.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[MAPW (File Format)|MAPW]])
| 1
| '''World Map ID'''
| ID of this world's [[MAPW (File Format)|MAPW]] file.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u8
| 1
| {{unknown|Unknown}}
| This is presumably the same unknown value as at the beginning of the [[Scriptable Layers (Metroid Prime)|SCLY]] format. Always 0.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u32
| 1
| '''Script Instance Count'''
| The MLVL format embeds a script layer. This script layer is used in the MP1 demo for storing Dock instances, but it's unused in all retail builds, so this is always 0.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u32
| 1
| '''Audio Group Count'''
| Count of all audio groups used in this world.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| [[#Audio Group|Audio Group]]
| ''Audio Group Count''
| '''Audio Group Array'''
| Array describing all audio groups used in this world.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| string
| 1
| {{unknown|Unknown}}
| Always empty, so the only value that ever appears here is the terminating 0.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Area Count'''
| Will be equal to the earlier area count.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| [[#Area Layer Flags|Area Layer Flags]]
| ''Area Count''
| '''Area Layer Flags'''
| This array initializes the default active state for all script layers in each area.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Layer Name Count'''
| Count of layer names in the next array.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| string
| ''Layer Name Count''
| '''Layer Name Array'''
| Array of all layer names in the world.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Layer State ID Count'''
| Count of layer state IDs in the next array.
| {{nocheck}}
| {{nocheck}}
| {{check}}
| {{check}}
|-
| [[Saved State ID]]
| ''Layer State ID Count''
| '''Layer State ID Array'''
| Array of saved state IDs for each layer. These IDs are responsible for storing the layer's active state in the save file and are referenced by ScriptLayerController objects.
| {{nocheck}}
| {{nocheck}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Area Count'''
| Identical to the previous two area counts.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| ''Area Count''
| '''Area Layer Name Offset Array'''
| Each value is an offset into the layer name array and points to where the layer names for each area begins.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| colspan=8 {{unknown|End of file}}
|}

=== Version ===

These are the known version numbers:

{| class="wikitable"
! ID
! Game
|-
| 0xD
| Metroid Prime Demo
|-
| 0x11
| Metroid Prime
|-
| 0x14
| Metroid Prime 2 Demo
|-
| 0x17
| Metroid Prime 2
|-
| 0x19
| Metroid Prime 3
|-
| 0x1B
| Donkey Kong Country Returns
|}

=== Memory Relay ===

This structure only appears in Prime 1. It describes an outgoing connection from a Memory Relay to another script instance. Any Memory Relays connected to multiple objects will appear in the array multiple times.

{| class="wikitable"
! Offset
! Type
! Name
! Notes
|-
| 0x0
| u32
| '''Memory Relay Instance ID'''
| Instance ID of the sender Memory Relay.
|-
| 0x4
| u32
| '''Target Instance ID'''
| Instance ID of the receiver object.
|-
| 0x8
| u16
| '''Message'''
| Script message sent to the receiver object.
|-
| 0x10
| bool
| '''Active'''
| Whether this Memory Relay object is active by default; almost always 0.
|-
| 0x11
| colspan=3 {{unknown|End of Memory Relay connection}}
|}

=== Area ===

This structure defines a single area and describes its position in the world and how it connects to other areas.

{| class="wikitable"
! Type
! Count
! Name
! Notes
! MP1
! MP2
! MP3
! DKCR
|-
| Asset ID ([[STRG (File Format)|STRG]])
| 1
| '''Area Name ID'''
| [[STRG (File Format)|STRG]] ID for the area name.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| float
| 12
| '''Area Transform'''
| Area's transform matrix. Most area data is pre-transformed, but there are a few things that need to be transformed by this matrix.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| float
| 6
| '''Area Bounding Box'''
| This is the bounding box of the area's collision mesh and is equivalent to the bounding box found in the [[MREA (File Format)|MREA]] collision section.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[MREA (File Format)|MREA]])
| 1
| '''Area MREA ID'''
| ID of this area's [[MREA (File Format)|MREA]] file.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID
| 1
| '''Internal Area ID'''
| Doesn't actually refer to an asset, but has the same length as an asset ID. This ID is used internally by some things to refer to this area, such as Script Layer Controllers.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Attached Area Count'''
| Count of areas attached to this one.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u16
| ''Attached Area Count''
| '''Attached Area Index Array'''
| Array of area indices attached to this one.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| [[#Area Dependencies|Area Dependencies]]
| 1
| '''Dependencies'''
| Asset dependencies in this area. See below for details. Starting in Prime 3, this section has been moved inside the [[MREA (File Format)|MREA]] file.
| {{check}}
| {{check}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Dock Count'''
| Count of Dock instances in this area.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| [[#Dock|Dock]]
| ''Dock Count''
| '''Dock Array'''
| Array describing all docks in this area.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| [[#Area Module Dependencies|Area Module Dependencies]]
| 1
| '''Module Dependencies'''
| REL module dependencies in this area. See below for details. The equivalent section in Prime 3 and DKCR describing RSO modules has been moved inside the [[MREA (File Format)|MREA]] format.
| {{nocheck}}
| {{check}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| {{unknown|Unknown}}
| Always 0?
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| string
| 1
| '''Internal Area Name'''
| Internal name of this area. Only appears ingame if no Area Name ID is specified (although it will be prefixed with "!!").
| {{nocheck}}
| {{check}}
| {{check}}
| {{check}}
|-
| colspan=8 {{unknown|End of area}}
|}

==== Area Dependencies ====

This is a data chunk appearing in the area definition in Metroid Prime 1 and 2 that lists all assets needed to load the area. It's extremely important that this list be optimized and complete, as all assets listed here will be perpetually kept in memory as long as the area itself is in memory; the list also specifies the order that assets are loaded in, so '''it must be grouped by load order to roughly match the [[PAK (File Format)|PAK]] file for optimized load times'''. Assets that are missing will still be dynamically loaded after the area itself is loaded, but this will cause the game to freeze up until the load is finished. There are a few exceptions that are excluded from this list in the original game files (and should be excluded in custom MLVLs as well to avoid out-of-memory crashes):

* [[SCAN (File Format)|SCAN]] files and their dependencies are not included in the list. These are loaded dynamically after the area itself is finished loading.
* [[ANCS (File Format)|ANCS]] per-character dependencies for PlayerActor script instances are not included; this allows the game to avoid keeping assets in memory for suits that the player doesn't have. The exception is the Empty Suit character (character index 5), which is a low-memory-overhead character that allows for the list to include all common assets that are stored in the file per-character (such as particle effects).
* The skybox model and its dependencies are not included.

The dependency list is split by layer; after the dependencies itself, an array of offsets into the dependency list is provided that allows the game to only load assets for layers that are currently active. The last offset points to all common resources used by the area that aren't layer-specific. With that in mind, every layer needs to have a full list of its required assets even if they're also used by other layers. There's no harm in including an asset multiple times, as if an asset is already in memory then it'll simply be skipped over.

This data chunk still exists in Prime 3 and DKCR, but it's been moved inside the [[MREA (File Format)|MREA]] format.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Dependency Count'''
| Count of dependencies.
|-
| [[#Dependency|Dependency]]
| ''Dependency Count''
| '''Dependency Array'''
| Array of all asset dependencies in this area.
|-
| u32
| 1
| '''Dependency Offset Count'''
| Count of dependency offsets. This will be equal to the area script layer count + 1.
|-
| u32
| ''Dependency Offset Count''
| '''Dependency Offset Array'''
| Array of offsets into the dependency array. There is one offset per script layer, with the offset referring to the index of that layer's first dependency. There is a final extra offset that points to area dependencies that are not layer-specific.
|}

===== Dependency =====

{| class="wikitable"
! Offset
! Type
! Count
! Name
|-
| 0x0
| Asset ID
| 1
| '''Dependency Asset ID'''
|-
| 0x4
| char
| 4
| '''Dependency Asset Type'''
|}

==== Dock ====

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Connecting Dock Count'''
| Count of docks connecting to this one. Typically 1 (but there are docks in Prime 3 that connect to multiple areas).
|-
| [[#Connecting Dock|Connecting Dock]]
| ''Connecting Dock Count''
| '''Connecting Dock Array'''
| Array describing all docks connected to this one.
|-
| u32
| 1
| '''Dock Coordinate Count'''
| Array of dock coordinates in the next array.
|-
| Vector3
| ''Dock Coordinate Count''
| '''Dock Coordinates'''
| Exact purpose/function of this is not known yet.
|}

===== Connecting Dock =====

{| class="wikitable"
! Offset
! Type
! Name
! Notes
|-
| 0x0
| u32
| '''Area Index'''
| Index of the area this dock is in.
|-
| 0x4
| u32
| '''Dock Index'''
| Index of this dock within its area.
|}

==== Area Module Dependencies ====

This is a data chunk appearing in the area definitions that describes all REL modules that must be linked in for this area to run. These are tied to script objects. The list is split per-layer so that only modules being used by the active layer are linked in; modules will appear once in the list for each layer that uses it. After the REL list, there is an array of offsets that points to the starting index in the list for each script layer, similar to the regular area dependencies list. For an unknown reason, the offsets list contains two offsets per layer. The first one refers to the layer's start index while the second one is usually empty, which effectively makes it an end index.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''REL Module Count'''
| Count of REL modules in the next array.
|-
| string
| ''REL Module Count''
| '''REL Module Array'''
| REL modules used by this area. Each array entry is the filename of a .REL module.
|-
| u32
| 1
| '''REL Offset Count'''
| Count of REL offsets in the next array. Should be equal to the area script layer count * 2.
|-
| u32
| ''REL Offset Count''
| '''REL Offset Array'''
| Array of offsets into the ''REL Module Array''. There are two offsets per script layer, with the first one being that layer's start index and the second one effectively being that layer's end index.
|}

=== Audio Group ===

This structure is only present in Prime 1 and describes an [[AGSC (File Format)|AGSC]] file being used in this world.

{| class="wikitable"
! Offset
! Type
! Name
! Notes
|-
| 0x0
| u32
| '''Group ID'''
| Group ID for this audio group. This is the same value that can be found in the Project chunk in the referenced [[AGSC (File Format)|AGSC]] file.
|-
| 0x4
| Asset ID ([[AGSC (File Format)|AGSC]])
| '''AGSC ID'''
| The [[AGSC (File Format)|AGSC]] file for this audio group.
|-
| 0x8
| colspan=3 {{unknown|End of audio group definition}}
|}

=== Area Layer Flags ===

This is a small structure that determines which areas are active by default. It contains a layer count and then a 64-bit flag, with each bit corresponding to a particular layer; if the bit is set, then the layer will be active on a new save file. The low-order bits correspond to the lower layer indices. Bits for layers that don't exist are defaulted to on.

Note that due to the size of these flags as well as a few other pieces of data in other formats, the maximum number of layers that can be contained in a single area is 64.

{| class="wikitable"
! Offset
! Type
! Name
! Notes
|-
| 0x0
| u32
| '''Layer Count'''
| Count of layers in this area.
|-
| 0x4
| u64
| '''Layer Flags'''
| See above for a description of how these work.
|-
| 0x8
| colspan=3 {{unknown|End of area layer flags}}
|}

[[Category:File Formats]]
[[Category:Metroid Prime]]
[[Category:Metroid Prime 2: Echoes]]
[[Category:Metroid Prime 3: Corruption]]
[[Category:Donkey Kong Country Returns]]

MLVL (File Format)

2016-08-14T23:29:38Z

Claris: Internal Area Name

The '''MLVL format''' defines worlds in the Metroid Prime trilogy and Donkey Kong Country Returns. While the [[MREA (File Format)|MREA format]] defines individual areas, the MLVL is what links together all the areas to create a single cohesive world.

{{research|minor|There's a couple unknown values in this format, but they all seem to have constant values.}}

__TOC__

== Format ==

The format largely defines properties related to each area in general and how they link together, as well as things that apply to the world on a global scale across all areas, such as the skybox.

{| class="wikitable"
! Type
! Count
! Name
! Notes
! MP1
! MP2
! MP3
! DKCR
|-
| u32
| 1
| '''Magic'''
| Always <code>0xDEAFBABE</code>
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Version'''
| [[#Version|See below]]
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[STRG (File Format)|STRG]])
| 1
| '''World Name ID'''
| [[STRG (File Format)|STRG]] file for the world name.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[STRG (File Format)|STRG]])
| 1
| '''Dark World Name ID'''
| [[STRG (File Format)|STRG]] file for the Dark World name.
| {{nocheck}}
| {{check}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Temple Key World Index'''
| Controls which temple key icons appear on the map screen. Appears in Prime 3 but always 0.
| {{nocheck}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| bool
| 1
| '''Has Time Attack'''
| Indicates whether this world has a Time Attack mode. '''If false, the next five values are not present.'''
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| string
| 1
| '''Level Number'''
| String of the world/level number; for example, "1-1". Purpose unknown.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| float
| 1
| '''Time Attack Bronze Time'''
| Target time for a bronze medal in Time Attack.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| float
| 1
| '''Time Attack Silver Time'''
| Target time for a silver medal in Time Attack.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| float
| 1
| '''Time Attack Gold Time'''
| Target time for a gold medal in Time Attack.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| float
| 1
| '''Time Attack Shiny Gold Time'''
| Target time for a shiny gold medal in Time Attack.
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| Asset ID ([[SAVW (File Format)|SAVW]])
| 1
| '''World Save Info ID'''
| Asset ID for this world's [[SAVW (File Format)|SAVW]] file.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[CMDL (File Format)|CMDL]])
| 1
| '''Default Skybox ID'''
| [[CMDL (File Format)|CMDL]] file for this world's default skybox model. This can be overridden per-area by AreaAttributes objects.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Memory Relay Count'''
| Count of all outgoing connections from Memory Relay instances in this world.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| [[#Memory Relay|Memory Relay]]
| ''Memory Relay Count''
| '''Memory Relay Array'''
| Array describing all outgoing Memory Relay connections in this world. Memory Relays connected to multiple objects are listed multiple times.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Area Count'''
| Count of areas in this world.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| {{unknown|Unknown}}
| Always 1?
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| [[#Area|Area]]
| ''Area Count''
| '''Area Array'''
| Array defining all areas that appear in this world.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[MAPW (File Format)|MAPW]])
| 1
| '''World Map ID'''
| ID of this world's [[MAPW (File Format)|MAPW]] file.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u8
| 1
| {{unknown|Unknown}}
| This is presumably the same unknown value as at the beginning of the [[Scriptable Layers (Metroid Prime)|SCLY]] format. Always 0.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u32
| 1
| '''Script Instance Count'''
| The MLVL format embeds a script layer. This script layer is used in the MP1 demo for storing Dock instances, but it's unused in all retail builds, so this is always 0.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u32
| 1
| '''Audio Group Count'''
| Count of all audio groups used in this world.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| [[#Audio Group|Audio Group]]
| ''Audio Group Count''
| '''Audio Group Array'''
| Array describing all audio groups used in this world.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| string
| 1
| {{unknown|Unknown}}
| Always empty, so the only value that ever appears here is the terminating 0.
| {{check}}
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Area Count'''
| Will be equal to the earlier area count.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| [[#Area Layer Flags|Area Layer Flags]]
| ''Area Count''
| '''Area Layer Flags'''
| This array initializes the default active state for all script layers in each area.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Layer Name Count'''
| Count of layer names in the next array.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| string
| ''Layer Name Count''
| '''Layer Name Array'''
| Array of all layer names in the world.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Layer State ID Count'''
| Count of layer state IDs in the next array.
| {{nocheck}}
| {{nocheck}}
| {{check}}
| {{check}}
|-
| [[Saved State ID]]
| ''Layer State ID Count''
| '''Layer State ID Array'''
| Array of saved state IDs for each layer. These IDs are responsible for storing the layer's active state in the save file and are referenced by ScriptLayerController objects.
| {{nocheck}}
| {{nocheck}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Area Count'''
| Identical to the previous two area counts.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| ''Area Count''
| '''Area Layer Name Offset Array'''
| Each value is an offset into the layer name array and points to where the layer names for each area begins.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| colspan=8 {{unknown|End of file}}
|}

=== Version ===

These are the known version numbers:

{| class="wikitable"
! ID
! Game
|-
| 0xD
| Metroid Prime Demo
|-
| 0x11
| Metroid Prime
|-
| 0x14
| Metroid Prime 2 Demo
|-
| 0x17
| Metroid Prime 2
|-
| 0x19
| Metroid Prime 3
|-
| 0x1B
| Donkey Kong Country Returns
|}

=== Memory Relay ===

This structure only appears in Prime 1. It describes an outgoing connection from a Memory Relay to another script instance. Any Memory Relays connected to multiple objects will appear in the array multiple times.

{| class="wikitable"
! Offset
! Type
! Name
! Notes
|-
| 0x0
| u32
| '''Memory Relay Instance ID'''
| Instance ID of the sender Memory Relay.
|-
| 0x4
| u32
| '''Target Instance ID'''
| Instance ID of the receiver object.
|-
| 0x8
| u16
| '''Message'''
| Script message sent to the receiver object.
|-
| 0x10
| bool
| '''Active'''
| Whether this Memory Relay object is active by default; almost always 0.
|-
| 0x11
| colspan=3 {{unknown|End of Memory Relay connection}}
|}

=== Area ===

This structure defines a single area and describes its position in the world and how it connects to other areas.

{| class="wikitable"
! Type
! Count
! Name
! Notes
! MP1
! MP2
! MP3
! DKCR
|-
| Asset ID ([[STRG (File Format)|STRG]])
| 1
| '''Area Name ID'''
| [[STRG (File Format)|STRG]] ID for the area name.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| float
| 12
| '''Area Transform'''
| Area's transform matrix. Most area data is pre-transformed, but there are a few things that need to be transformed by this matrix.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| float
| 6
| '''Area Bounding Box'''
| This is the bounding box of the area's collision mesh and is equivalent to the bounding box found in the [[MREA (File Format)|MREA]] collision section.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID ([[MREA (File Format)|MREA]])
| 1
| '''Area MREA ID'''
| ID of this area's [[MREA (File Format)|MREA]] file.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID
| 1
| '''Internal Area ID'''
| Doesn't actually refer to an asset, but has the same length as an asset ID. This ID is used internally by some things to refer to this area, such as Script Layer Controllers.
| {{check}}
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Attached Area Count'''
| Count of areas attached to this one.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u16
| ''Attached Area Count''
| '''Attached Area Index Array'''
| Array of area indices attached to this one.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| [[#Area Dependencies|Area Dependencies]]
| 1
| '''Dependencies'''
| Asset dependencies in this area. See below for details. Starting in Prime 3, this section has been moved inside the [[MREA (File Format)|MREA]] file.
| {{check}}
| {{check}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Dock Count'''
| Count of Dock instances in this area. Should be equal to the attached area count.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| [[#Dock|Dock]]
| ''Dock Count''
| '''Dock Array'''
| Array describing all docks in this area.
| {{check}}
| {{check}}
| {{check}}
| {{nocheck}}
|-
| [[#Area Module Dependencies|Area Module Dependencies]]
| 1
| '''Module Dependencies'''
| REL module dependencies in this area. See below for details. The equivalent section in Prime 3 and DKCR describing RSO modules has been moved inside the [[MREA (File Format)|MREA]] format.
| {{nocheck}}
| {{check}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| {{unknown|Unknown}}
| Always 0?
| {{nocheck}}
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| string
| 1
| '''Internal Area Name'''
| Internal name of this area. Only appears ingame if no Area Name ID is specified (although it will be prefixed with "!!").
| {{nocheck}}
| {{check}}
| {{check}}
| {{check}}
|-
| colspan=8 {{unknown|End of area}}
|}

==== Area Dependencies ====

This is a data chunk appearing in the area definition in Metroid Prime 1 and 2 that lists all assets needed to load the area. It's extremely important that this list be optimized and complete, as all assets listed here will be perpetually kept in memory as long as the area itself is in memory; the list also specifies the order that assets are loaded in, so '''it must be grouped by load order to roughly match the [[PAK (File Format)|PAK]] file for optimized load times'''. Assets that are missing will still be dynamically loaded after the area itself is loaded, but this will cause the game to freeze up until the load is finished. There are a few exceptions that are excluded from this list in the original game files (and should be excluded in custom MLVLs as well to avoid out-of-memory crashes):

* [[SCAN (File Format)|SCAN]] files and their dependencies are not included in the list. These are loaded dynamically after the area itself is finished loading.
* [[ANCS (File Format)|ANCS]] per-character dependencies for PlayerActor script instances are not included; this allows the game to avoid keeping assets in memory for suits that the player doesn't have. The exception is the Empty Suit character (character index 5), which is a low-memory-overhead character that allows for the list to include all common assets that are stored in the file per-character (such as particle effects).
* The skybox model and its dependencies are not included.

The dependency list is split by layer; after the dependencies itself, an array of offsets into the dependency list is provided that allows the game to only load assets for layers that are currently active. The last offset points to all common resources used by the area that aren't layer-specific. With that in mind, every layer needs to have a full list of its required assets even if they're also used by other layers. There's no harm in including an asset multiple times, as if an asset is already in memory then it'll simply be skipped over.

This data chunk still exists in Prime 3 and DKCR, but it's been moved inside the [[MREA (File Format)|MREA]] format.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Dependency Count'''
| Count of dependencies.
|-
| [[#Dependency|Dependency]]
| ''Dependency Count''
| '''Dependency Array'''
| Array of all asset dependencies in this area.
|-
| u32
| 1
| '''Dependency Offset Count'''
| Count of dependency offsets. This will be equal to the area script layer count + 1.
|-
| u32
| ''Dependency Offset Count''
| '''Dependency Offset Array'''
| Array of offsets into the dependency array. There is one offset per script layer, with the offset referring to the index of that layer's first dependency. There is a final extra offset that points to area dependencies that are not layer-specific.
|}

===== Dependency =====

{| class="wikitable"
! Offset
! Type
! Count
! Name
|-
| 0x0
| Asset ID
| 1
| '''Dependency Asset ID'''
|-
| 0x4
| char
| 4
| '''Dependency Asset Type'''
|}

==== Dock ====

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Connecting Dock Count'''
| Count of docks connecting to this one. Typically 1 (but there are docks in Prime 3 that connect to multiple areas).
|-
| [[#Connecting Dock|Connecting Dock]]
| ''Connecting Dock Count''
| '''Connecting Dock Array'''
| Array describing all docks connected to this one.
|-
| u32
| 1
| '''Dock Coordinate Count'''
| Array of dock coordinates in the next array.
|-
| Vector3
| ''Dock Coordinate Count''
| '''Dock Coordinates'''
| Exact purpose/function of this is not known yet.
|}

===== Connecting Dock =====

{| class="wikitable"
! Offset
! Type
! Name
! Notes
|-
| 0x0
| u32
| '''Area Index'''
| Index of the area this dock is in.
|-
| 0x4
| u32
| '''Dock Index'''
| Index of this dock within its area.
|}

==== Area Module Dependencies ====

This is a data chunk appearing in the area definitions that describes all REL modules that must be linked in for this area to run. These are tied to script objects. The list is split per-layer so that only modules being used by the active layer are linked in; modules will appear once in the list for each layer that uses it. After the REL list, there is an array of offsets that points to the starting index in the list for each script layer, similar to the regular area dependencies list. For an unknown reason, the offsets list contains two offsets per layer. The first one refers to the layer's start index while the second one is usually empty, which effectively makes it an end index.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''REL Module Count'''
| Count of REL modules in the next array.
|-
| string
| ''REL Module Count''
| '''REL Module Array'''
| REL modules used by this area. Each array entry is the filename of a .REL module.
|-
| u32
| 1
| '''REL Offset Count'''
| Count of REL offsets in the next array. Should be equal to the area script layer count * 2.
|-
| u32
| ''REL Offset Count''
| '''REL Offset Array'''
| Array of offsets into the ''REL Module Array''. There are two offsets per script layer, with the first one being that layer's start index and the second one effectively being that layer's end index.
|}

=== Audio Group ===

This structure is only present in Prime 1 and describes an [[AGSC (File Format)|AGSC]] file being used in this world.

{| class="wikitable"
! Offset
! Type
! Name
! Notes
|-
| 0x0
| u32
| '''Group ID'''
| Group ID for this audio group. This is the same value that can be found in the Project chunk in the referenced [[AGSC (File Format)|AGSC]] file.
|-
| 0x4
| Asset ID ([[AGSC (File Format)|AGSC]])
| '''AGSC ID'''
| The [[AGSC (File Format)|AGSC]] file for this audio group.
|-
| 0x8
| colspan=3 {{unknown|End of audio group definition}}
|}

=== Area Layer Flags ===

This is a small structure that determines which areas are active by default. It contains a layer count and then a 64-bit flag, with each bit corresponding to a particular layer; if the bit is set, then the layer will be active on a new save file. The low-order bits correspond to the lower layer indices. Bits for layers that don't exist are defaulted to on.

Note that due to the size of these flags as well as a few other pieces of data in other formats, the maximum number of layers that can be contained in a single area is 64.

{| class="wikitable"
! Offset
! Type
! Name
! Notes
|-
| 0x0
| u32
| '''Layer Count'''
| Count of layers in this area.
|-
| 0x4
| u64
| '''Layer Flags'''
| See above for a description of how these work.
|-
| 0x8
| colspan=3 {{unknown|End of area layer flags}}
|}

[[Category:File Formats]]
[[Category:Metroid Prime]]
[[Category:Metroid Prime 2: Echoes]]
[[Category:Metroid Prime 3: Corruption]]
[[Category:Donkey Kong Country Returns]]

MLVL (File Format)

2015-06-06T05:42:12Z

Claris:

User:MrSinistar/Sandbox

2015-05-22T09:20:51Z

Claris: I'm sorry.

AGSC uses MusyX data for the audio engine. Each sound has it's own "SoundMacro" and properties. The '''pool chunk''' is where the soundmacros are located. SoundMacros are small scripts that control how sounds are played in game, like pitch or vibrato or fade outs. Here's a description of the pool chunk:

{|class="wikitable"
! Offset
! Size
! Description
|-
| 0x0
| 4
| '''Header size''' Looks like it's always 10
|-
| 0x10
| 4
| '''Macro size'''
|-
| 0x14
| 2
| '''Macro ID'''
|-
| 0x18
| colspan=2 {{unknown|Macro data, needs more research}}
|}

----

STRG Commands are similar to CSS syntax. A ; terminates the command. & begins the command, so for example, &just=center;
{| class="wikitable"
! Command
! Value
! Description
|-
| just
| center
| Justifies text
|-
| image
| SI,0.70,0.68,[[TXTR (File Format)|TXTR]] ID
| Displays an image. SI = Single Image? S,T and finally TXTR ID. Animation = SA, Animation Speed, S,T, TXTR ID, TXTR ID
|-
| main-color
| Hex Color Code
| Changes color of text.
|}

----
===SCLY Audio Object===

{|class="wikitable"
! Offset
! Size
! Description
|-
| 0x0
| 4
| '''Property Count''' (always 0x14 for sound)
|-
| 0x4
| N
| '''Sound name'''; zero-terminated
|}

{|class="wikitable"
! Offset
! Size
! Description
|-
| 0x0
| 4
| '''Position (float)'''
|-
| 0x4
| 4
| '''Position (float)'''
|-
| 0x8
| 4
| '''Position (float)'''
|-
| 0xC
| 4
| '''Rotation (float)'''
|-
| 0x10
| 4
| '''Rotation (float)'''
|-
| 0x14
| 4
| '''Rotation (float)'''
|-
| 0x18
| 4
| '''Sound Effects ID''' index number for [[ATBL]]
|-
| 0x1C
| 1
| '''Play Automatically'''; If this bool is turned on, but the active bool is not on, the corresponding trigger must send a Play message (0x14) to turn on the sound.
|-
| 0x1D
| 4
| '''Maximum Distance (float)'''; the bigger the float, the farther you can hear it!
|-
| 0x21
| 4
| '''Minimum Distance (float)'''; usually set to 0.2
|-
| 0x25
| 4
| '''Padding'''
|-
| 0x29
| 4
| '''Priority'''
|-
| 0x2D
| 4
| '''Max. Volume'''; 127 is loudest
|-
| 0x31
| 4
| '''Min. Volume'''
|-
| 0x35
| 4
| '''Panning''' 0=Left, 64=Center, 127=Right
|-
| 0x39
| 1
| '''Play endlessly'''
|-
| 0x3A
| 1
| '''Play everywhere'''
|-
| 0x3B
| 1
| '''Active/Accepts Trigger Activations'''; this must be on and it's corresponding trigger has to activate/deactivate the sound object in order to play/stop sound. Triggers sending a Play message (0x14) won't turn on the sound.
|-
| 0x3C
| 1
| {{unknown|'''Unknown'''}}
|-
| 0x3D
| 1
| '''Is sound affected by RoomAcoustics?'''; 1=yes, 0=no
|-
| 0x3E
| 1
| {{unknown|'''Unknown'''}}
|-
| 0x3F
| 1
| {{unknown|'''Unknown'''}}; Is On for Health pickups (ITD or Surround flag?)
|-
| 0x40
| 4
| {{unknown|'''Unknown'''}}; (FF FF FF FF, usually descending...seen on cinematic sounds)
|}

so, if what we are assuming are the play automatically bool and the active bool are both on, then the sound plays immediately on spawn and never plays again, even when the trigger is suppose to activate it.

atbl bool = 0, 3rd bool = 1...sound doesn't play automatically but activates when going through trigger.

atbl bool = 1, 3rd bool = 1...sound plays automatically and deactives/activates correctly when going through trigger.

atbl bool = 1, 3rd bool = 0, nothing plays

===SCLY RoomAcoustics===

{|class="wikitable"
! Offset
! Size (h)
! Description
|-
| 0x0
| 2
| '''Active flag'''; 1 = on, 0 = off
|-
| 0x2
| 4
| {{unknown|'''Unknown'''}}; always 0x75
|-
| 0x6
| 27
| '''Padding'''
|-
| 0x2D
| 1
| {{unknown|'''Unknown'''}}; always 0x1
|-
| 0x2E
| 1
| '''Padding'''
|-
| 0x2F
| 4
| '''Decay (float)'''; Reverb decay length (in seconds). Value must be between 0.01 and 10.0. Can make it sound like small room to a large cathedral.
|-
| 0x33
| 4
| '''Predelay (float)'''; Length of time before reverb starts (in seconds). Value must be between 0.0 and 0.1. Simulates latency for reflected sound waves over long distances.
|-
| 0x37
| 4
| '''Damping (float)'''; Dampens the high-frequencies. Value must be between 0.0 and 1.0. Sort of like a filter, 0.0 has lots of bass, 1.0 has lots of high end.
|-
| 0x3B
| 4
| '''Color (float)'''; Basically, an equalizer. Value must be between 0.0 and 1.0. Balances out frequencies to simulate the acoustic properties of different surfaces in a room.
|-
| 0x3F
| 4
| '''Mix (float)'''; Value must be between 0.0 and 1.0. 0.0 means that only the original sound will be audible, whereas 1.0 will only make the reverberated signal be heard.
|-
| 0x43
| 25
| '''Padding'''
|}

{|cellpadding="5" cellspacing="3" align="center" style="text-align:center; margin-bottom:20px; float:center; border:1px solid; box-shadow: 0 0 5px #6DBACD; border-radius:6px; border-color:#6dbacd;" ! width="45%"
|[[File:Powercannon_render3.png|200px]]
|'''Help us research and document! Join the discussion at: [https://m2k2.taigaforum.com/post/metroid_prime_hacking_research.html Metroid Prime Hacking Research thread @ Metroid2002.com]'''
{|align="center" style="text-align:center;"
|[[File:Morphball_wire.png|50px|link=Category:Major research needed]]
|[[File:Morphball_wirerender.png|50px|link=Category:Moderate research needed]]
|[[File:Morphball_render.png|50px|link=Category:Minor research needed]]
|-
|[[:Category:Major research needed|'''File formats that need major research''']]
|[[:Category:Moderate research needed|'''File formats that need moderate research''']]
|[[:Category:Minor research needed|'''File formats that need minor research''']]
|}

MLVL (File Format)

2015-04-23T23:42:24Z

Claris:

MLVL (File Format)

2015-04-22T13:00:18Z

Claris:

Tweaks (Metroid Prime)

2015-03-02T04:55:26Z

Claris:

The tweaks system allows for easy modification of different game values that would normally be hardcoded. In Metroid Prime, this is handled by the CTWK files located in Tweaks.Pak. The tweaks are loaded on startup. Things that can be modified through the tweaks includes:

* The amount and type of damage done by each weapon
* The Hard Mode damage multiplier
* The field of view
* The world pak prefix

...and a lot more.

__TOC__

== CTWK List ==

These are all the CTWK files:

{| class="wikitable"
! File
! Name
|-
| 1d180d7c.CTWK
| Particle
|-
| 264a4972.CTWK
| Player
|-
| 33b3323a.CTWK
| GunRes
|-
| 39ad28d3.CTWK
| CameraBob
|-
| 3faec012.CTWK
| PlayerControls2
|-
| 5ed56350.CTWK
| Ball
|-
| 5f24eff8.CTWK
| SlideShow
|-
| 6907a32d.CTWK
| PlayerGun
|-
| 85ca11e9.CTWK
| PlayerRes
|-
| 94c76ecd.CTWK
| Targeting
|-
| 953a7c63.CTWK
| Game
|-
| c9954e56.CTWK
| GuiColors
|-
| e66a4f86.CTWK
| AutoMapper
|-
| ed2e48a9.CTWK
| Gui
|-
| f1ed8fd7.CTWK
| PlayerControls
|}

== Game ==

{| class="wikitable"
! Offset
! Type
! Description
! Value
|-
| 0x0
| string
| '''World pak prefix'''
| "Metroid"
|-
| 0x8
| string
| {{unknown|'''Unknown'''}}
| "ruin_area22"
|-
| 0x14
| float
| '''Field of View'''
| 55.0
|-
| 0x18
| bool
| {{unknown|'''Unknown'''}}
| true
|-
| 0x19
| bool
| {{unknown|'''Unknown'''}}
| false
|-
| 0x1A
| bool
| {{unknown|'''Unknown'''}}
| true
|-
| 0x1B
| bool
| {{unknown|'''Unknown'''}}
| true
|-
| 0x1C
| float
| {{unknown|'''Unknown'''}}
| 25.0
|-
| 0x20
| float
| {{unknown|'''Unknown'''}}
| 1.0
|-
| 0x24
| float
| {{unknown|'''Unknown'''}}
| 450.0
|-
| 0x28
| float
| {{unknown|'''Unknown'''}}
| 400.0
|-
| 0x2C
| float
| {{unknown|'''Unknown'''}}
| 1750.0
|-
| 0x30
| float
| {{unknown|'''Unknown'''}}
| 1.0
|-
| 0x34
| float
| {{unknown|'''Unknown'''}}
| 1.2
|-
| 0x38
| float
| {{unknown|'''Unknown'''}}
| 0.5
|-
| 0x3C
| float
| {{unknown|'''Unknown'''}}
| 0.25
|-
| 0x40
| float
| {{unknown|'''Unknown'''}}
| 30.0
|-
| 0x44
| float
| {{unknown|'''Unknown'''}}
| 125.0
|-
| 0x48
| float
| {{unknown|'''Unknown'''}}
| 150.0
|-
| 0x4C
| float
| {{unknown|'''Unknown'''}}
| 300.0
|-
| 0x50
| float
| '''Hard Mode damage multiplier'''
| 1.53
|-
| 0x54
| float
| '''Hard Mode weapons multiplier'''
| 0.5
|}

Tweaks (Metroid Prime)

2015-03-02T04:54:12Z

Claris:

The tweaks system allows for easy modification of different game values that would normally be hardcoded. In Metroid Prime, this is handled by the CTWK files located in Tweaks.Pak. The tweaks are loaded on startup. Things that can be modified through the tweaks includes:

* The amount and type of damage done by each weapon
* The Hard Mode damage multiplier
* The field of view
* The world pak prefix

...and a lot more.

__TOC__

== CTWK List ==

These are all the CTWK files:

{| class="wikitable"
! File
! Name
|-
| 1d180d7c.CTWK
| Particle
|-
| 264a4972.CTWK
| Player
|-
| 33b3323a.CTWK
| GunRes
|-
| 39ad28d3.CTWK
| CameraBob
|-
| 3faec012.CTWK
| PlayerControls2
|-
| 5ed56350.CTWK
| Ball
|-
| 5f24eff8.CTWK
| SlideShow
|-
| 6907a32d.CTWK
| PlayerGun
|-
| 85ca11e9.CTWK
| PlayerRes
|-
| 94c76ecd.CTWK
| Targeting
|-
| 953a7c63.CTWK
| Game
|-
| c9954e56.CTWK
| GuiColors
|-
| e66a4f86.CTWK
| AutoMapper
|-
| ed2e48a9.CTWK
| Gui
|-
| f1ed8fd7.CTWK
| PlayerControls
|}

== Game ==

{| class="wikitable"
! Offset
! Type
! Description
! Value
|-
| 0x0
| string
| '''World pak prefix'''
| "Metroid"
|-
| 0x8
| string
| {{unknown|'''Unknown'''}}
| "ruin_area22"
|-
| 0x14
| float
| '''Field of View'''
| 55.0
|-
| 0x18
| bool
| {{unknown|'''Unknown'''}}
| true
|-
| 0x19
| bool
| {{unknown|'''Unknown'''}}
| false
|-
| 0x1A
| bool
| {{unknown|'''Unknown'''}}
| true
|-
| 0x1B
| bool
| {{unknown|'''Unknown'''}}
| true
|-
| 0x1C
| float
| {{unknown|'''Unknown'''}}
| 25.0
|-
| 0x20
| float
| {{unknown|'''Unknown'''}}
| 1.0
|-
| 0x24
| float
| {{unknown|'''Unknown'''}}
| 450.0
|-
| 0x28
| float
| {{unknown|'''Unknown'''}}
| 400.0
|-
| 0x2C
| float
| {{unknown|'''Unknown'''}}
| 1750.0
|-
| 0x30
| float
| {{unknown|'''Unknown'''}}
| 1.0
|-
| 0x34
| float
| {{unknown|'''Unknown'''}}
| 1.2
|-
| 0x38
| float
| {{unknown|'''Unknown'''}}
| 0.5
|-
| 0x3C
| float
| {{unknown|'''Unknown'''}}
| 0.25
|-
| 0x40
| float
| {{unknown|'''Unknown'''}}
| 30.0
|-
| 0x44
| float
| {{unknown|'''Unknown'''}}
| 125.0
|-
| 0x48
| float
| {{unknown|'''Unknown'''}}
| 150.0
|-
| 0x4C
| float
| {{unknown|'''Unknown'''}}
| 300.0
|-
| 0x50
| float
| {{Hard Mode damage multiplier|'''Unknown'''}}
| 1.53
|-
| 0x54
| float
| {{Hard Mode weapons multiplier|'''Unknown'''}}
| 0.5
|}

MLVL (File Format)

2015-02-14T15:18:03Z

Claris: Layer IDs. Because using the layer's number is just too complicated, you really need a 16 byte ID for it instead.

ROOM (File Format)

2015-02-13T16:54:11Z

Claris: LGEN

The '''ROOM format''' is used to store object layout data in Tropical Freeze.

{{research|major|Most of this format hasn't been researched yet.}}

__TOC__

== Format ==

=== RMHD ===

{| class="wikitable"
! Type
! Size
! Description
|-
| [[Section Header (Tropical Freeze)|Section Header]]
| 0x18
| '''"RMHD" section header'''
|-
| u16
| 2
| {{unknown|'''Unknown''' (Always 3?)}}
|}

=== PGRP ===

PGRP likely stands for Performance Group, a term referenced by a few objects.

{| class="wikitable"
! Type
! Size
! Description
|-
| [[Section Header (Tropical Freeze)|Section Header]]
| 0x18
| '''"PGRP" section header'''
|-
| u16
| 2
| '''Count'''
|}

For count:

{| class="wikitable"
! Type
! Size
! Description
|-
| u32
| 4
| '''Name length'''
|-
| string
| -
| '''Name''' (not zero-terminated)
|-
| u128
| 0x10
| '''ID'''
|-
| u8
| 1
| {{unknown|'''Unknown'''}}
|-
| u16
| 2
| '''ID count''' (IC)
|-
| u128
| 0x10 * IC
| '''IDs'''
|}

=== LGEN ===

{| class="wikitable"
! Type
! Size
! Description
|-
| [[Section Header (Tropical Freeze)|Section Header]]
| 0x18
| '''"LGEN" section header'''
|-
| u16
| 2
| '''Count'''
|}

For count:

{| class="wikitable"
! Type
! Size
! Description
|-
| u128
| 0x10
| '''ID'''
|-
| u128
| 0x10
| '''ID'''
|}

=== COMP ===

{| class="wikitable"
! Type
! Size
! Description
|-
| [[Section Header (Tropical Freeze)|Section Header]]
| 0x18
| '''"COMP" section header'''
|-
| u32
| 4
| '''Object type'''
|-
| u128
| 0x10
| '''Instance ID'''
|-
| u32
| 4
| '''Instance name length'''
|-
| string
| -
| '''Instance name''' (not zero-terminated)
|-
| u16
| 2
| '''Connection count'''
|}

Each connection is structured as:

{| class="wikitable"
! Offset
! Type
! Size
! Description
|-
| 0x0
| char[4]
| 4
| '''State'''
|-
| 0x4
| char[4]
| 4
| '''Message'''
|-
| 0x8
| u128
| 0x10
| '''Target Instance ID'''
|-
| 0x18
| u32
| 4
| {{unknown|'''Unknown'''}}
|}

Following is property data; size and contents vary by object type.

==== Object Types ====

{| class="wikitable"
! ID
! Object
|-
| 0x2BE8BC19
| LightStatic
|-
| 0x9EE5541D
| LightDynamic
|-
| 0x73AECD92
| FogVolume
|-
| 0x7DCAF170
| BloomEffect
|-
| 0x655C5175
| AudioBusController
|-
| 0x24D9D323
| AudioEffect
|-
| 0x8FE0BFC9
| Relay
|-
| 0x97E65DDD
| TouchableTrigger
|-
| 0xC49D730E
| TriggerLogic
|-
| 0x3175DF36
| ApplyDamage
|-
| 0x06E89BE7
| Health
|-
| 0xBDE4AB05
| TakeDamage
|-
| 0x6C5D597D
| NearVisible
|-
| 0x749749F1
| Everything
|}

[[Category:File Formats]]
[[Category:Donkey Kong Country: Tropical Freeze]]

User:Claris

2015-02-13T03:30:32Z

Claris: Created page with "I don't like my name being red on the Recent Changes list."

I don't like my name being red on the Recent Changes list.

ROOM (File Format)

2015-02-13T03:20:57Z

Claris: PGRP

The '''ROOM format''' is used to store object layout data in Tropical Freeze.

{{research|major|Most of this format hasn't been researched yet.}}

__TOC__

== Format ==

=== RMHD ===

{| class="wikitable"
! Type
! Size
! Description
|-
| [[Section Header (Tropical Freeze)|Section Header]]
| 0x18
| '''"RMHD" section header'''
|-
| u16
| 2
| {{unknown|'''Unknown''' (Always 3?)}}
|}

=== PGRP ===

{| class="wikitable"
! Type
! Size
! Description
|-
| [[Section Header (Tropical Freeze)|Section Header]]
| 0x18
| '''"PGRP" section header'''
|-
| u16
| 2
| '''Count'''
|}

For count:

{| class="wikitable"
! Type
! Size
! Description
|-
| u32
| 4
| '''Name length'''
|-
| string
| -
| '''Name''' (not zero-terminated)
|-
| u128
| 0x10
| ID?
|-
| u8
| 1
| {{unknown|'''Unknown'''}}
|-
| u16
| 2
| '''ID count''' (IC)
|-
| u128
| 0x10 * IC
| '''IDs'''
|}

=== COMP ===

{| class="wikitable"
! Type
! Size
! Description
|-
| [[Section Header (Tropical Freeze)|Section Header]]
| 0x18
| '''"COMP" section header'''
|-
| u32
| 4
| '''Object type'''
|-
| u128
| 0x10
| '''Instance ID'''
|-
| u32
| 4
| '''Instance name length'''
|-
| string
| -
| '''Instance name''' (not zero-terminated)
|-
| u16
| 2
| '''Connection count'''
|}

Each connection is structured as:

{| class="wikitable"
! Offset
! Type
! Size
! Description
|-
| 0x0
| char[4]
| 4
| '''State'''
|-
| 0x4
| char[4]
| 4
| '''Message'''
|-
| 0x8
| u128
| 0x10
| '''Target Instance ID'''
|-
| 0x18
| u32
| 4
| {{unknown|'''Unknown'''}}
|}

Following is property data; size and contents vary by object type.

=== Object Types ===

{| class="wikitable"
! ID
! Object
|-
| 0x2BE8BC19
| LightStatic
|-
| 0x9EE5541D
| LightDynamic
|-
| 0x73AECD92
| FogVolume
|-
| 0x7DCAF170
| BloomEffect
|-
| 0x655C5175
| AudioBusController
|-
| 0x24D9D323
| AudioEffect
|-
| 0x8FE0BFC9
| Relay
|-
| 0x97E65DDD
| TouchableTrigger
|-
| 0xC49D730E
| TriggerLogic
|-
| 0x3175DF36
| ApplyDamage
|-
| 0x06E89BE7
| Health
|-
| 0xBDE4AB05
| TakeDamage
|-
| 0x6C5D597D
| NearVisible
|-
| 0x749749F1
| Everything
|}

[[Category:File Formats]]
[[Category:Donkey Kong Country: Tropical Freeze]]

ROOM (File Format)

2015-02-13T02:47:10Z

Claris: RMHD, really complicated format

MLVL (File Format)

2015-02-04T09:38:15Z

Claris:

User:Claris/Sandbox

2015-02-04T00:26:49Z

Claris:

'''.MLVL''' description here.

Note that file IDs are 4 bytes in Prime/Echoes and 8 bytes in Corruption/Returns.

{{researchmoderate
|reason=Reason
}}
__TOC__

=Header=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Magic''' 0xDEAFBABE
|All
|-
|0x4
|'''File Version'''
|All
|-
|0x4/0x8
|'''World Name .STRG'''
|All
|-
|0x4
|'''Dark World Name .STRG'''
|Echoes
|-
|0x4
|?
|Echoes/Corruption
|-
|0x1
|Boolean, checks whether the next two values exist
|Returns
|-
|?
|'''Level Number''' string (zero-terminated)
|Returns
|-
|0x10
|4 floats
|Returns
|-
|0x4/0x8
|'''World .SAVW'''
|All
|-
|0x4/0x8
|'''World Skybox .CMDL'''
|All
|}

=Memory Relays (Prime only)=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Memory Relay count'''
|Prime
|}

For each memory relay:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Memory Relay Instance ID'''
|Prime
|-
|0x4
|'''Connected Instance ID'''
|Prime
|-
|0x2
|'''Message'''
|Prime
|-
|0x1
|? (Always 0)
|Prime
|}

=Areas=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Area count'''
|All
|-
|0x4
|?
|Prime
|}

For each area:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4/0x8
|'''Area Name .STRG'''
|All
|-
|0x30
|'''Transformation Matrix'''
|All
|-
|0x18
|'''Axis-Aligned Bounding Box'''
|All
|-
|0x4/0x8
|'''Area .MREA'''
|All
|-
|0x4/0x8
|'''Area ID''' (used by layer-switching objects)
|All
|-
|0x4
|'''Connected area count''' (CC)
|Prime/Echoes/Corruption
|-
|0x2 x CC
|'''Connected area numbers'''
|Prime/Echoes/Corruption
|-
|0x4
|? (always 0)
|Prime/Echoes
|}

===Dependency List (Prime/Echoes)===

Starts with [[DGRP_(File_Format)|DGRP]].

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Dependency Offset Count''' (OC)
|Prime/Echoes
|-
|0x4 x OC
|'''Dependency Offsets'''
|Prime/Echoes
|}

===Docks===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Dock count'''
|Prime/Echoes/Corruption
|}

For each dock:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Connection Count'''
|Prime/Echoes/Corruption
|}

For each connection:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Area Number'''
|Prime/Echoes/Corruption
|-
|0x4
|'''Dock Number'''
|Prime/Echoes/Corruption
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|? (Always 4, could be a count for the dock coordinates)
|Prime/Echoes/Corruption
|-
|0x30
|4 sets of dock coordinates
|Prime/Echoes/Corruption
|}

===.rel list (Echoes)===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''.rel Count''' (RC)
|Echoes
|-
|? x RC
|'''.rels''' (zero-terminated)
|Echoes
|-
|0x4
|'''.rel Offset Count''' (OC)
|Echoes
|-
|0x4 x OC
|'''.rel Offsets'''
|Echoes
|}

===Remainder===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|Always 0; could be something in previous games, such as the dock count, but I have no way of knowing for sure
|Returns
|-
|?
|'''Code Name''' (zero-terminated)
|Echoes, Corruption, Returns
|}

=After Areas=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4/0x8
|'''World .MAPW'''
|Prime/Echoes/Corruption
|-
|0x5
|? (Always 0)
|Prime/Echoes/Corruption
|-
|0x4
|'''.AGSC count''' (AC)
|Prime
|}

For each AGSC:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|?
|Prime
|-
|0x4
|'''.AGSC ID'''
|Prime
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x1
|? (Always 0)
|Prime
|-
|0x4
|'''Area Layer Info Count''' (should be identical to Area Count)
|All
|}

For each layer info:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Layer Count'''
|All
|-
|0x8
|'''Layer Bit Flags''' (1 if a layer should be turned on in a new file)
|All
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Layer Name Count''' (LC)
|All
|-
|? x LC
|'''Layer Names''' (zero-terminated)
|All
|-
|0x4
|(Unknown) Count (UC)
|Corruption/Returns
|-
|0x10 x UC
|?
|Corruption/Returns
|-
|0x4
|'''Layer Name Offset Count''' (OC)
|All
|-
|0x4 x OC
|'''Layer Name Offsets'''
|All
|}

User:Claris/Sandbox

2015-02-04T00:12:11Z

Claris:

'''.MLVL''' description here.

Note that file IDs are 4 bytes in Prime/Echoes and 8 bytes in Corruption/Returns.

{{researchmoderate
|reason=Reason
}}
__TOC__

=Header=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Magic''' 0xDEAFBABE
|All
|-
|0x4
|'''File Version'''
|All
|-
|0x4/0x8
|'''World Name .STRG'''
|All
|-
|0x4
|'''Dark World Name .STRG'''
|Echoes
|-
|0x4
|?
|Echoes/Corruption
|-
|0x1
|Boolean, checks whether the next two values exist
|Returns
|-
|?
|'''Level Number''' string (zero-terminated)
|Returns
|-
|0x10
|4 floats
|Returns
|-
|0x4/0x8
|'''World .SAVW'''
|All
|-
|0x4/0x8
|'''World Skybox .CMDL'''
|All
|}

=Memory Relays (Prime only)=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Memory Relay count'''
|Prime
|}

For each memory relay:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Memory Relay Instance ID'''
|Prime
|-
|0x4
|'''Connected Instance ID'''
|Prime
|-
|0x2
|'''Message'''
|Prime
|-
|0x1
|? (Always 0)
|Prime
|}

=Areas=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Area count'''
|All
|-
|0x4
|?
|Prime
|}

For each area:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4/0x8
|'''Area Name .STRG'''
|All
|-
|0x30
|'''Transformation Matrix'''
|All
|-
|0x18
|'''Axis-Aligned Bounding Box'''
|All
|-
|0x4/0x8
|'''Area .MREA'''
|All
|-
|0x4/0x8
|'''Area ID''' (used by layer-switching objects)
|All
|-
|0x4
|'''Connected area count''' (CC)
|Prime/Echoes/Corruption
|-
|0x2 x CC
|'''Connected area numbers'''
|Prime/Echoes/Corruption
|-
|0x4
|? (always 0)
|Prime/Echoes
|}

===Dependency List (Prime/Echoes)===

Starts with [[DGRP_(File_Format)|DGRP]].

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Dependency Offset Count''' (OC)
|Prime/Echoes
|-
|0x4 x OC
|'''Dependency Offsets'''
|Prime/Echoes
|}

===Docks===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Dock count'''
|Prime/Echoes/Corruption
|}

For each dock:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Connection Count'''
|Prime/Echoes/Corruption
|}

For each connection:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Area Number'''
|Prime/Echoes/Corruption
|-
|0x4
|'''Dock Number'''
|Prime/Echoes/Corruption
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|? (Always 4, could be a count for the dock coordinates)
|Prime/Echoes/Corruption
|-
|0x30
|4 sets of dock coordinates
|Prime/Echoes/Corruption
|}

===.rel list (Echoes)===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''.rel Count''' (RC)
|Echoes
|-
|? x RC
|'''.rels''' (zero-terminated)
|Echoes
|-
|0x4
|'''.rel Offset Count''' (OC)
|Echoes
|-
|0x4 x OC
|'''.rel Offsets'''
|Echoes
|}

===Remainder===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|Always 0; could be something in previous games, such as the dock count, but I have no way of knowing for sure
|Returns
|-
|?
|'''Code Name''' (zero-terminated)
|Echoes, Corruption, Returns
|}

=After Areas=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4/0x8
|'''World .MAPW'''
|Prime/Echoes/Corruption
|-
|0x5
|?
|Prime/Echoes/Corruption
|-
|0x4
|'''.AGSC count''' (AC)
|Prime
|}

For each AGSC:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|?
|Prime
|-
|0x4
|'''.AGSC ID'''
|Prime
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x1
|?
|Prime
|-
|0x4
|'''Area Layer Info Count''' (should be identical to Area Count)
|All
|}

For each layer info:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Layer Count'''
|All
|-
|0x8
|'''Layer Bit Flags''' (1 if a layer should be turned on in a new file)
|All
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Layer Name Count''' (LC)
|All
|-
|? x LC
|'''Layer Names''' (zero-terminated)
|All
|-
|0x4
|(Unknown) Count (UC)
|Corruption/Returns
|-
|0x10 x UC
|?
|Corruption/Returns
|-
|0x4
|'''Layer Name Offset Count''' (OC)
|All
|-
|0x4 x OC
|'''Layer Name Offsets'''
|All
|}

User:Claris/Sandbox

2015-02-03T23:40:01Z

Claris:

'''.MLVL''' description here.

Note that file IDs are 4 bytes in Prime/Echoes and 8 bytes in Corruption/Returns.

{{researchmoderate
|reason=Reason
}}
__TOC__

=Header=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Magic''' 0xDEAFBABE
|All
|-
|0x4
|'''File Version'''
|All
|-
|0x4/0x8
|'''World Name .STRG'''
|All
|-
|0x4
|'''Dark World Name .STRG'''
|Echoes
|-
|0x4
|?
|Echoes/Corruption
|-
|0x1
|Boolean, checks whether the next two values exist
|Returns
|-
|?
|'''Level Number''' string (zero-terminated)
|Returns
|-
|0x10
|4 floats
|Returns
|-
|0x4/0x8
|'''World .SAVW'''
|All
|-
|0x4/0x8
|'''World Skybox .CMDL'''
|All
|}

=Memory Relays (Prime only)=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Memory Relay count'''
|Prime
|}

For each memory relay:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Memory Relay Instance ID'''
|Prime
|-
|0x4
|'''Connected Instance ID'''
|Prime
|-
|0x2
|'''Message'''
|Prime
|-
|0x1
|? (Always 0)
|Prime
|}

=Areas=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Area count'''
|All
|-
|0x4
|?
|Prime
|}

For each area:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4/0x8
|'''Area Name .STRG'''
|All
|-
|0x30
|'''Transformation Matrix'''
|All
|-
|0x18
|'''Axis-Aligned Bounding Box'''
|All
|-
|0x4/0x8
|'''Area .MREA'''
|All
|-
|0x4/0x8
|'''Area ID''' (used by layer-switching objects)
|All
|-
|0x4
|'''Connected area count''' (CC)
|Prime/Echoes/Corruption
|-
|0x2 x CC
|'''Connected area numbers'''
|Prime/Echoes/Corruption
|-
|0x4
|? (always 0)
|Prime/Echoes
|}

===Dependency List (Prime/Echoes)===

Identical to [[DGRP_(File_Format)|DGRP]].

(DGRP should be updated as it doesn't mention the dependency count or the offset list)

===Docks===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Dock count'''
|Prime/Echoes/Corruption
|}

For each dock:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Connection Count'''
|Prime/Echoes/Corruption
|}

For each connection:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Area Number'''
|Prime/Echoes/Corruption
|-
|0x4
|'''Dock Number'''
|Prime/Echoes/Corruption
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|? (Always 4, could be a count for the dock coordinates)
|Prime/Echoes/Corruption
|-
|0x30
|4 sets of dock coordinates
|Prime/Echoes/Corruption
|}

===.rel list (Echoes)===

Identical to [[RSOS]], except with .rel files instead of .rso files.

(Page needs to be created)

===Remainder===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|Always 0; could be something in previous games, such as the dock count, but I have no way of knowing for sure
|Returns
|-
|?
|'''Code Name''' (zero-terminated)
|Echoes, Corruption, Returns
|}

=After Areas=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4/0x8
|'''World .MAPW'''
|Prime/Echoes/Corruption
|-
|0x5
|?
|Prime/Echoes/Corruption
|-
|0x4
|'''.AGSC count''' (AC)
|Prime
|}

For each AGSC:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|?
|Prime
|-
|0x4
|'''.AGSC ID'''
|Prime
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x1
|?
|Prime
|-
|0x4
|'''Area Layer Info Count''' (should be identical to Area Count)
|All
|}

For each layer info:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Layer Count'''
|All
|-
|0x8
|'''Layer Bit Flags''' (1 if a layer should be turned on in a new file)
|All
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Layer Name Count''' (LC)
|All
|-
|? x LC
|'''Layer Names''' (zero-terminated)
|All
|-
|0x4
|(Unknown) Count (UC)
|Corruption/Returns
|-
|0x10 x UC
|?
|Corruption/Returns
|-
|0x4
|'''Layer Name Offset Count''' (OC)
|All
|-
|0x4 x OC
|'''Layer Name Offsets'''
|All
|}

User:Claris/Sandbox

2015-02-03T21:32:43Z

Claris:

'''.MLVL''' description here.

Note that file IDs are 4 bytes in Prime/Echoes and 8 bytes in Corruption/Returns.

{{researchmoderate
|reason=Reason
}}
__TOC__

=Header=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Magic''' 0xDEAFBABE
|All
|-
|0x4
|'''File Version'''
|All
|-
|0x4/0x8
|'''World Name .STRG'''
|All
|-
|0x4
|'''Dark World Name .STRG'''
|Echoes
|-
|0x4
|?
|Echoes/Corruption
|-
|0x1
|Boolean, checks whether the next two values exist
|Returns
|-
|?
|'''Level Number''' string (zero-terminated)
|Returns
|-
|0x10
|4 floats
|Returns
|-
|0x4/0x8
|'''World .SAVW'''
|All
|-
|0x4/0x8
|'''World Skybox .CMDL'''
|All
|}

=Memory Relays (Prime only)=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Memory Relay count'''
|Prime
|}

For each memory relay:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Memory Relay Instance ID'''
|Prime
|-
|0x4
|'''Connected Instance ID'''
|Prime
|-
|0x3
|?
|Prime
|}

=Areas=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Area count'''
|All
|-
|0x4
|?
|Prime
|}

For each area:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4/0x8
|'''Area Name .STRG'''
|All
|-
|0x30
|'''Transformation Matrix'''
|All
|-
|0x18
|'''Axis-Aligned Bounding Box'''
|All
|-
|0x4/0x8
|'''Area .MREA'''
|All
|-
|0x4/0x8
|'''Area ID''' (used by layer-switching objects)
|All
|-
|0x4
|'''Connected area count''' (CC)
|Prime/Echoes/Corruption
|-
|0x2 x CC
|'''Connected area numbers'''
|Prime/Echoes/Corruption
|-
|0x4
|? (always 0)
|Prime/Echoes
|}

===Dependency List (Prime/Echoes)===

Identical to [[DGRP_(File_Format)|DGRP]].

(DGRP should be updated as it doesn't mention the dependency count or the offset list)

===Docks===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Dock count'''
|Prime/Echoes/Corruption
|}

For each dock:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Connection Count'''
|Prime/Echoes/Corruption
|}

For each connection:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Area Number'''
|Prime/Echoes/Corruption
|-
|0x4
|'''Dock Number'''
|Prime/Echoes/Corruption
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|? (Always 4, could be a count for the dock coordinates)
|Prime/Echoes/Corruption
|-
|0x30
|4 sets of dock coordinates
|Prime/Echoes/Corruption
|}

===.rel list (Echoes)===

Identical to [[RSOS]], except with .rel files instead of .rso files.

(Page needs to be created)

===Remainder===

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|Always 0; could be something in previous games, such as the dock count, but I have no way of knowing for sure
|Returns
|-
|?
|'''Code Name''' (zero-terminated)
|Echoes, Corruption, Returns
|}

=After Areas=

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4/0x8
|'''World .MAPW'''
|Prime/Echoes/Corruption
|-
|0x5
|?
|Prime/Echoes/Corruption
|-
|0x4
|'''.AGSC count''' (AC)
|Prime
|}

For each AGSC:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|?
|Prime
|-
|0x4
|'''.AGSC ID'''
|Prime
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x1
|?
|Prime
|-
|0x4
|'''Area Layer Info Count''' (should be identical to Area Count)
|All
|}

For each layer info:

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Layer Count'''
|All
|-
|0x8
|'''Layer Bit Flags''' (1 if a layer should be turned on in a new file)
|All
|}

{| class="wikitable"
!Size
!Description
!Games
|-
|0x4
|'''Layer Name Count''' (LC)
|All
|-
|? x LC
|'''Layer Names''' (zero-terminated)
|All
|-
|0x4
|(Unknown) Count (UC)
|Corruption/Returns
|-
|0x10 x UC
|?
|Corruption/Returns
|-
|0x4
|'''Layer Name Offset Count''' (OC)
|All
|-
|0x4 x OC
|'''Layer Name Offsets'''
|All
|}

User:Claris/Sandbox

2015-01-26T13:33:30Z

Claris:

User:Claris/Sandbox

2015-01-26T13:01:18Z

Claris: Throwing in-progress MLVL stuff here for now