Retro Modding Wiki - User contributions [en]

MAPA (File Format)

2026-05-05T12:35:59Z

Duncathan: correct info about the offsets in the primitive headers

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 tables below for MP1/MP2 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}}
|-
|[[GUID]]
|'''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
|}

==== MP2 Types ====
{| class="wikitable"
!Type
!Description
|-
|0
|Normal Door
|-
|1
|Missile Door
|-
|2
|Dark Door
|-
|3
|Annihilator Door
|-
|4
|Light Door
|-
|5
|Super Missile Door
|-
|6
|Seeker Missile Door
|-
|7
|Power Bomb Door
|-
|16
|Elevator
|-
|17
|Save Station
|-
|20
|Ammo Station
|-
|21
|Portal
|-
|22
|Light Teleporter
|-
|23
|Translator Gate
|-
|24
|Up Arrow
|-
|25
|Down Arrow
|}

=== 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 file header.

{|class="wikitable"
!Type
!Description
|-
|{{Vector3f}}
|'''Normal'''
|-
|{{Vector3f}}
|'''Center of Mass'''
|-
|u32
|'''Primitive Table Start'''; relative to the end of the file header
|-
|u32
|'''Border Table Start'''; relative to the end of the file 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]]

HIER (File Format)

2025-09-20T15:06:55Z

Duncathan: create page

The '''HIER format''' is used to group logbook scans in Echoes into hierarchal categories, which are displayed while scanning objects. There is only one HIER file in Echoes, <code>DUMB_ScanHierarchy</code> in <code>NoARAM.pak</code> (asset ID <code>0xDD79DC2A</code>). The hierarchy described in this file matches that in [[TREE (File Format)|TREE]], but is optimized for in-game scanning rather than pause menu navigation.

{{research|1|What are Options used for?}}

__TOC__

== Format ==

=== Header ===

{| class="wikitable"
! Offset
! Type
!Count
! Name
!Notes
|-
| 0x0
| FourCC
|1
| '''Magic'''
|Always <code>HIER</code>
|-
| 0x4
| u32
|1
| '''Node Count'''
|
|-
| 0x8
|[[HIER (File Format)#Node|Node]]
|''Node Count''
|Nodes
|}

=== Node ===
Each node represents either a Category, a Scan, or an Option. When scanning a logbook scan, the game locates its node and all its parents, and displays up to 5 Categories as well as the Scan node.
{| class="wikitable"
! Type
! Count
! Name
!Notes
|-
| STRG Asset ID
| 1
| '''Name String Table'''
|Asset ID of the [[STRG (File Format)|STRG]] file with this node's name.
|-
| string
| 1
| '''Name String Name'''
|The named string in the Name String Table with this node's name.
|-
| SCAN Asset ID
| 1
| '''Scan Asset'''
|Asset ID of the [[SCAN (File Format)|SCAN]] asset associated with this node. Always 0xFFFFFFFF for Categories and Options.
|-
| u32
| 1
| '''Parent'''
|Index into the Nodes table. Top-level nodes have a parent of 0xFFFFFFFF.
|}

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

Metroid Prime 2: Echoes

2025-09-20T14:27:26Z

Duncathan: add HIER to format list

'''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
|-
| v0.227
| 9/21/2004 10:45:09
| Multi-Game Demo Disc v20, v23-26
|-
| v0.237
| 9/29/2004 14:51:17
| EUR Interactive Multi-Game Demo Disc: November 2004
|-
| 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.561
| 2008/06/30 14:13
| Wii de Asobu
|-
| v3.593
| 2008/08/21 17:09
| Metroid Prime: Trilogy NTSC
|-
| v3.629
| 2009/01/15 14:08
| Metroid Prime: Trilogy PAL
|}

== 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 (Metroid Prime)|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
|-
|[[HIER (File Format)|HIER]]
|Scan Hierarchy
|-
| [[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
|-
| [[Scriptable_Layers_(Metroid_Prime_2)|SCLY]]
| Scriptable Layers
|-
| [[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
|-
| [[TREE (File Format)|TREE]]
| Pause Menu Hierarchy
|-
| [[TXTR (Metroid Prime)|TXTR]]
| Texture
|-
| [[WPSC (File Format)|WPSC]]
| Weapon Particle System
|}

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

ScriptLayerController (Metroid Prime 2)

2023-07-01T19:43:20Z

Duncathan: /* States */

=== Properties ===

=== States ===
{| class="wikitable"
|+
!State
!Description
|-
|Arrived
|Sent by dynamic controllers when they finish loading.
It can be useful to send a Play message from the controller to itself using this state, to activate the layer as soon as it's finished loading.
|}

=== Messages ===
{| class="wikitable"
|+
!Message
!Description
|-
|Increment
|Activates the target layer for the next time the area is loaded.
'''Dynamic controllers:''' begins loading the layer asynchronously. ''Does not activate the layer immediately.''
|-
|Decrement
|Deactivates the target layer for the next time the area is loaded.
'''Dynamic controllers:''' unloads and deactivates the layer immediately.
|-
|Play
|'''Dynamic controllers''': activates the target layer if it isn't yet active.
If the layer has not yet finished loading, it will load ''synchronously'', blacking out the screen until finished.
|-
|Load
|Alias for Increment.
|-
|Unload
|Alias for Decrement.
|}

ScriptLayerController (Metroid Prime 2)

2023-07-01T19:42:46Z

Duncathan: Created page with "=== Properties === === States === {| class="wikitable" |+ !State !Description |- |Arrived |Sent by dynamic controllers when they finish loading. It can be useful to send a Pl..."

=== Properties ===

=== States ===
{| class="wikitable"
|+
!State
!Description
|-
|Arrived
|Sent by dynamic controllers when they finish loading.
It can be useful to send a Play message from the controller to itself, to activate the layer as soon as it's finished loading.
|}

=== Messages ===
{| class="wikitable"
|+
!Message
!Description
|-
|Increment
|Activates the target layer for the next time the area is loaded.
'''Dynamic controllers:''' begins loading the layer asynchronously. ''Does not activate the layer immediately.''
|-
|Decrement
|Deactivates the target layer for the next time the area is loaded.
'''Dynamic controllers:''' unloads and deactivates the layer immediately.
|-
|Play
|'''Dynamic controllers''': activates the target layer if it isn't yet active.
If the layer has not yet finished loading, it will load ''synchronously'', blacking out the screen until finished.
|-
|Load
|Alias for Increment.
|-
|Unload
|Alias for Decrement.
|}

RubiksPuzzle (Metroid Prime 2)

2023-06-24T04:51:12Z

Duncathan: /* States */

==Properties==

==States==
{| class="wikitable"
|-
!State!!Description
|-
|InternalState00||Attaching red holocubes
|-
|InternalState01||Attaching green holocubes
|-
|InternalState02||Attaching blue holocubes
|-
|InternalState03
|Attaching red input laser
|-
|InternalState04
|Attaching green input laser
|-
|InternalState05
|Attaching blue input laser
|-
|InternalState06
|Attaching left red laser segment
|-
|InternalState07
|Attaching right red laser segment
|-
|InternalState08
|Attaching left green laser segment
|-
|InternalState09
|Attaching right green laser segment
|-
|InternalState10
|Attaching left blue laser segment
|-
|InternalState11
|Attaching right blue laser segment
|-
|InternalState12
|Attaching red output laser
|-
|InternalState13
|Attaching green output laser
|-
|InternalState14
|Attaching blue output laser
|-
|InternalState15
|Attaching axis reference
The rotation of this instance is applied to the axis around which holocubes are rotated.
|-
|InternalState16
|Attaching top buttons
|-
|InternalState17
|Attaching bottom buttons
|-
|InternalState18
|Puzzle complete
|}

==Messages==
{| class="wikitable"
|-
!Header text!!Header text
|-
|IntermalMessage00||Rotate top left
|-
|InternalMessage01||Rotate top right
|-
|InternalMessage02||Rotate bottom left
|-
|InternalMessage03||Rotate bottom right
|}

RubiksPuzzle (Metroid Prime 2)

2023-06-24T04:50:47Z

Duncathan: Created page with "==Properties== ==States== {| class="wikitable" |- !State!!Description |- |InternalState00||Attaching red holocubes |- |InternalState01||Attaching green holocubes |- |Internal..."

==Properties==

==States==
{| class="wikitable"
|-
!State!!Description
|-
|InternalState00||Attaching red holocubes
|-
|InternalState01||Attaching green holocubes
|-
|InternalState02||Attaching blue holocubes
|-
|InternalState03
|Attaching red input laser
|-
|InternalState04
|Attaching green input laser
|-
|InternalState05
|Attaching blue input laser
|-
|InternalState06
|Attaching left red laser segment
|-
|InternalState07
|Attaching right red laser segment
|-
|InternalState08
|Attaching left green laser segment
|-
|InternalState09
|Attaching right green laser segment
|-
|InternalState10
|Attaching left blue laser segment
|-
|InternalState11
|Attaching right blue laser segment
|-
|InternalState12
|Attaching red output laser
|-
|InternalState13
|Attaching green output laser
|-
|InternalState14
|Attaching blue output laser
|-
|InternalState15
|Attaching axis reference (the rotation of this instance is applied to the axis around which holocubes are rotated)
|-
|InternalState16
|Attaching top buttons
|-
|InternalState17
|Attaching bottom buttons
|-
|InternalState18
|Puzzle complete
|}

==Messages==
{| class="wikitable"
|-
!Header text!!Header text
|-
|IntermalMessage00||Rotate top left
|-
|InternalMessage01||Rotate top right
|-
|InternalMessage02||Rotate bottom left
|-
|InternalMessage03||Rotate bottom right
|}

MLVL (File Format)

2023-06-20T19:58:22Z

Duncathan: /* Area Dependencies */ Updates this section with the results of my research into recreating MP2's dependencies as accurately as possible. I've overwritten the previous note about ANCS per-character dependencies - I'm assuming that it works the same way in MP1, but I haven't confirmed that. I have confirmed the behavior for MP2.

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 GUID Count'''
| Count of layer GUIDs in the next array.
| {{nocheck}}
| {{nocheck}}
| {{check}}
| {{check}}
|-
| [[GUID]]
| ''Layer GUID Count''
| '''Layer GUID Array'''
| Array of GUIDs for each layer. These GUIDs 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.
|-
| 0xA
| bool
| '''Active'''
| Whether this Memory Relay object is active by default; almost always 0.
|-
| 0xB
| 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. This name will be used ingame on the map screen if no ''Area Name ID'' is specified, 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):

* Some [[AGSC (File Format)|AGSC]] files are not included in MP2. The game has specific DGRP files which include the "global" sound effects for that type of world. Any files inside that DGRP are excluded from the list. These are:
** Single-player worlds: ''AudioGrp/audio_groups_single_player_DGRP.DGRP''
** Multiplayer worlds: ''AudioGrp/audio_groups_multi_player_DGRP.DGRP''
** Frontend: ''AudioGrp/audio_groups_front_end_DGRP.DGRP''
* [[SCAN (File Format)|SCAN]] files and their dependencies are not included in the list in MP1. These are loaded dynamically after the area itself is finished loading, presumably so that scan dependencies are not kept in memory when the scan isn't actually in use. In MP2, SCANs are actually included in the list but their dependencies aren't. Make sure to update the dependency list inside the SCAN file if you change them - the game may crash when scanning otherwise.
* Script instances with an AnimationParameters property only include the dependencies from their [[ANCS (File Format)|ANCS]] which are used by their character index. This includes:
** Any dependencies in the CharacterSet for that character
** Any [[ANIM (Metroid Prime)|ANIM]]s (and [[EVNT (File Format)|EVNT]]s, for MP1) used by that character's animations
** Any valid [[AGSC (File Format)|AGSC]] dependencies in any animation events used by that character, '''including''' events with a character index of -1.
** Any [[Particle Script|Particle Script]] dependencies in any animation events used by that character, '''not including''' events with a character index of -1.
** Any dependencies of '''all''' [[Meta-Transition|Meta-Transition]]s in the ANCS. '''This includes transitions not used by that character!'''
* 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
| {{unknown|Unknown}}
| Always 0?
|-
| 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. These include dependencies of the world geometry, as well as the PATH, PTLA, and EGMC dependencies from their respective sections. Note that the area name STRG is not included (at least in MP2).
|}

===== Dependency =====

{| class="wikitable"
! Offset
! Type
! Count
! Name
|-
| 0x0
| Asset ID
| 1
| '''Dependency Asset ID'''
|-
| 0x4
| {{FourCC}}
| 1
| '''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
| u16
| '''Dock Index'''
| Index of this dock within its area.
|-
| 0x6
| u16
| '''Load other'''
| TODO
|}

==== 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]]

List of Script Objects (Metroid Prime)

2023-06-14T23:11:26Z

Duncathan: add to demo category

This is a list of script objects in Metroid Prime and its demo.

__TOC__

== List of script objects ==

{| class="wikitable"
! ID
! Name
! Demo
! Final
! Notes
|-
| 0x0
| [[Actor (Metroid Prime)|Actor]]
| {{check}}
| {{check}}
|
|-
| 0x1
| [[Enemy (Metroid Prime)|Enemy]]
| {{check}}
| {{nocheck}}
| Unused
|-
| 0x2
| [[Waypoint (Metroid Prime)|Waypoint]]
| {{check}}
| {{check}}
|
|-
| 0x3
| [[DoorArea (Metroid Prime)|DoorArea]]
| {{check}}
| {{check}}
|
|-
| 0x4
| [[Trigger (Metroid Prime)|Trigger]]
| {{check}}
| {{check}}
|
|-
| 0x5
| [[Timer (Metroid Prime)|Timer]]
| {{check}}
| {{check}}
|
|-
| 0x6
| [[Counter (Metroid Prime)|Counter]]
| {{check}}
| {{check}}
|
|-
| 0x7
| [[Effect (Metroid Prime)|Effect]]
| {{check}}
| {{check}}
|
|-
| 0x8
| [[Platform (Metroid Prime)|Platform]]
| {{check}}
| {{check}}
|
|-
| 0x9
| [[Sound (Metroid Prime)|Sound]]
| {{check}}
| {{check}}
|
|-
| 0xA
| [[Generator (Metroid Prime)|Generator]]
| {{check}}
| {{check}}
|
|-
| 0xB
| [[Dock (Metroid Prime)|Dock]]
| {{check}}
| {{check}}
|
|-
| 0xC
| [[Camera (Metroid Prime)|Camera]]
| {{check}}
| {{check}}
|
|-
| 0xD
| [[CameraWaypoint (Metroid Prime)|CameraWaypoint]]
| {{check}}
| {{check}}
|
|-
| 0xE
| [[NewIntroBoss (Metroid Prime)|NewIntroBoss]]
| {{check}}
| {{check}}
| Used for Parasite Queen
|-
| 0xF
| [[SpawnPoint (Metroid Prime)|SpawnPoint]]
| {{check}}
| {{check}}
|
|-
| 0x10
| [[CameraHint (Metroid Prime)|CameraHint]]
| {{check}}
| {{check}}
|
|-
| 0x11
| [[Pickup (Metroid Prime)|Pickup]]
| {{check}}
| {{check}}
|
|-
| 0x12
| [[JumpPoint (Metroid Prime)|JumpPoint]]
| {{check}}
| {{nocheck}}
| Unused
|-
| 0x13
| [[MemoryRelay (Metroid Prime)|MemoryRelay]]
| {{check}}
| {{check}}
|
|-
| 0x14
| [[RandomRelay (Metroid Prime)|RandomRelay]]
| {{check}}
| {{check}}
|
|-
| 0x15
| [[Relay (Metroid Prime)|Relay]]
| {{check}}
| {{check}}
|
|-
| 0x16
| [[Beetle (Metroid Prime)|Beetle]]
| {{check}}
| {{check}}
| Used for Beetle, Plated Beetle
|-
| 0x17
| [[HUDMemo (Metroid Prime)|HUDMemo]]
| {{check}}
| {{check}}
|
|-
| 0x18
| [[CameraFilterKeyframe (Metroid Prime)|CameraFilterKeyframe]]
| {{check}}
| {{check}}
|
|-
| 0x19
| [[CameraBlurKeyframe (Metroid Prime)|CameraBlurKeyframe]]
| {{check}}
| {{check}}
|
|-
| 0x1A
| [[DamageableTrigger (Metroid Prime)|DamageableTrigger]]
| {{check}}
| {{check}}
|
|-
| 0x1B
| [[Debris (Metroid Prime)|Debris]]
| {{check}}
| {{check}}
|
|-
| 0x1C
| [[CameraShaker (Metroid Prime)|CameraShaker]]
| {{check}}
| {{check}}
|
|-
| 0x1D
| [[ActorKeyframe (Metroid Prime)|ActorKeyframe]]
| {{check}}
| {{check}}
|
|-
| 0x20
| [[Water (Metroid Prime)|Water]]
| {{check}}
| {{check}}
|
|-
| 0x21
| [[WarWasp (Metroid Prime)|WarWasp]]
| {{check}}
| {{check}}
| Used for War Wasp, Barbed War Wasp, Ram War Wasp
|-
| 0x22
| [[MapStation (Metroid Prime)|MapStation]]
| {{check}}
| {{nocheck}}
| Deprecated. Use a [[SpecialFunction (Metroid Prime)|SpecialFunction]] instead.
|-
| 0x24
| [[SpacePirate (Metroid Prime)|SpacePirate]]
| {{check}}
| {{check}}
| Used for Space Pirate, Shadow Pirate, Beam Troopers
|-
| 0x25
| [[FlyingPirate (Metroid Prime)|FlyingPirate]]
| {{check}}
| {{check}}
| Used for Flying Pirate, Aqua Pirate
|-
| 0x26
| [[ElitePirate (Metroid Prime)|ElitePirate]]
| {{check}}
| {{check}}
|
|-
| 0x27
| [[MetroidBeta (Metroid Prime)|MetroidBeta]]
| {{check}}
| {{check}}
| Used for Hunter Metroid
|-
| 0x28
| [[ChozoGhost (Metroid Prime)|ChozoGhost]]
| {{check}}
| {{check}}
|
|-
| 0x2A
| [[CoverPoint (Metroid Prime)|CoverPoint]]
| {{check}}
| {{check}}
|
|-
| 0x2C
| [[SpiderBallWaypoint (Metroid Prime)|SpiderBallWaypoint]]
| {{check}}
| {{check}}
|
|-
| 0x2D
| [[BloodFlower (Metroid Prime)|BloodFlower]]
| {{check}}
| {{check}}
|
|-
| 0x2E
| [[FlickerBat (Metroid Prime)|FlickerBat]]
| {{check}}
| {{check}}
|
|-
| 0x2F
| [[PathCamera (Metroid Prime)|PathCamera]]
| {{check}}
| {{check}}
|
|-
| 0x30
| [[GrapplePoint (Metroid Prime)|GrapplePoint]]
| {{check}}
| {{check}}
|
|-
| 0x31
| [[PuddleSpore (Metroid Prime)|PuddleSpore]]
| {{check}}
| {{check}}
|
|-
| 0x32
| [[DebugCameraWaypoint (Metroid Prime)|DebugCameraWaypoint]]
| {{check}}
| {{check}}
| Unused
|-
| 0x33
| [[SpiderBallAttractionSurface (Metroid Prime)|SpiderBallAttractionSurface]]
| {{check}}
| {{check}}
|
|-
| 0x34
| [[PuddleToadGamma (Metroid Prime)|PuddleToadGamma]]
| {{check}}
| {{check}}
| Used for Stone Toad
|-
| 0x35
| [[DistanceFog (Metroid Prime)|DistanceFog]]
| {{check}}
| {{check}}
|
|-
| 0x36
| [[FireFlea (Metroid Prime)|FireFlea]]
| {{check}}
| {{check}}
| Used for Plazmite
|-
| 0x37
| [[MetareeAlpha (Metroid Prime)|MetareeAlpha]]
| {{check}}
| {{check}}
| Used for Shriekbat, Ice Shriekbat
|-
| 0x38
| [[DockAreaChange (Metroid Prime)|DockAreaChange]]
| {{check}}
| {{check}}
| Unused
|-
| 0x39
| [[ActorRotate (Metroid Prime)|ActorRotate]]
| {{check}}
| {{check}}
|
|-
| 0x3A
| [[SpecialFunction (Metroid Prime)|SpecialFunction]]
| {{check}}
| {{check}}
|
|-
| 0x3B
| [[SpankWeed (Metroid Prime)|SpankWeed]]
| {{check}}
| {{check}}
| Used for Reaper Vine, Aqua Vine
|-
| 0x3C
| [[Sova (Metroid Prime)|Sova]]
| {{check}}
| {{nocheck}}
| Unused
|-
| 0x3D
| [[Parasite (Metroid Prime)|Parasite]]
| {{check}}
| {{check}}
| Used for Parasite, Plated Parasite, Ice Parasite, Zoomer, Grizby, Crystallite
|-
| 0x3E
| [[PlayerHint (Metroid Prime)|PlayerHint]]
| {{check}}
| {{check}}
|
|-
| 0x3F
| [[Ripper (Metroid Prime)|Ripper]]
| {{check}}
| {{check}}
| Used for Glider
|-
| 0x40
| [[PickupGenerator (Metroid Prime)|PickupGenerator]]
| {{check}}
| {{check}}
|
|-
| 0x41
| [[AIKeyframe (Metroid Prime)|AIKeyframe]]
| {{check}}
| {{check}}
| Unused
|-
| 0x42
| [[PointOfInterest (Metroid Prime)|PointOfInterest]]
| {{check}}
| {{check}}
|
|-
| 0x43
| [[Drone (Metroid Prime)|Drone]]
| {{check}}
| {{check}}
|
|-
| 0x44
| [[MetroidAlpha (Metroid Prime)|MetroidAlpha]]
| {{check}}
| {{check}}
| Used for Metroid, Fission Metroid
|-
| 0x45
| [[DebrisExtended (Metroid Prime)|DebrisExtended]]
| {{check}}
| {{check}}
|
|-
| 0x46
| [[Steam (Metroid Prime)|Steam]]
| {{check}}
| {{check}}
|
|-
| 0x47
| [[Ripple (Metroid Prime)|Ripple]]
| {{check}}
| {{check}}
|
|-
| 0x48
| [[BallTrigger (Metroid Prime)|BallTrigger]]
| {{check}}
| {{check}}
|
|-
| 0x49
| [[TargetingPoint (Metroid Prime)|TargetingPoint]]
| {{check}}
| {{check}}
|
|-
| 0x4A
| [[ElectroMagneticPulse (Metroid Prime)|ElectroMagneticPulse]]
| {{check}}
| {{check}}
|
|-
| 0x4B
| [[IceSheegoth (Metroid Prime)|IceSheegoth]]
| {{check}}
| {{check}}
|
|-
| 0x4C
| [[PlayerActor (Metroid Prime)|PlayerActor]]
| {{check}}
| {{check}}
|
|-
| 0x4D
| [[Flaahgra (Metroid Prime)|Flaahgra]]
| {{check}}
| {{check}}
|
|-
| 0x4E
| [[AreaAttributes (Metroid Prime)|AreaAttributes]]
| {{check}}
| {{check}}
|
|-
| 0x4F
| [[FishCloud (Metroid Prime)|FishCloud]]
| {{check}}
| {{check}}
|
|-
| 0x50
| [[FishCloudModifier (Metroid Prime)|FishCloudModifier]]
| {{check}}
| {{check}}
|
|-
| 0x51
| [[VisorFlare (Metroid Prime)|VisorFlare]]
| {{check}}
| {{check}}
|
|-
| 0x52
| [[WorldTeleporter (Metroid Prime)|WorldTeleporter]]
| {{check}}
| {{check}}
| Redundant unused slot; 0x62 is the one that the game uses (both are identical)
|-
| 0x53
| [[VisorGoo (Metroid Prime)|VisorGoo]]
| {{check}}
| {{check}}
|
|-
| 0x54
| [[JellyZap (Metroid Prime)|JellyZap]]
| {{check}}
| {{check}}
| Used for Jelzap
|-
| 0x55
| [[ControllerAction (Metroid Prime)|ControllerAction]]
| {{check}}
| {{check}}
|
|-
| 0x56
| [[Switch (Metroid Prime)|Switch]]
| {{check}}
| {{check}}
|
|-
| 0x57
| [[PlayerStateChange (Metroid Prime)|PlayerStateChange]]
| {{check}}
| {{check}}
|
|-
| 0x58
| [[Thardus (Metroid Prime)|Thardus]]
| {{check}}
| {{check}}
|
|-
| 0x59
| [[SaveStation (Metroid Prime)|SaveStation]]
| {{check}}
| {{nocheck}}
| Deprecated. Use a [[SpecialFunction (Metroid Prime)|SpecialFunction]] instead.
|-
| 0x5A
| [[WallCrawlerSwarm (Metroid Prime)|WallCrawlerSwarm]]
| {{check}}
| {{check}}
| Used for Parasite, Scarab, Tallon Crab
|-
| 0x5B
| [[AIJumpPoint (Metroid Prime)|AIJumpPoint]]
| {{check}}
| {{check}}
|
|-
| 0x5C
| [[FlaahgraTentacle (Metroid Prime)|FlaahgraTentacle]]
| {{check}}
| {{check}}
|
|-
| 0x5D
| [[RoomAcoustics (Metroid Prime)|RoomAcoustics]]
| {{check}}
| {{check}}
|
|-
| 0x5E
| [[ColorModulate (Metroid Prime)|ColorModulate]]
| {{check}}
| {{check}}
|
|-
| 0x5F
| [[ThardusRockProjectile (Metroid Prime)|ThardusRockProjectile]]
| {{check}}
| {{check}}
|
|-
| 0x60
| [[Midi (Metroid Prime)|Midi]]
| {{check}}
| {{check}}
|
|-
| 0x61
| [[StreamedAudio (Metroid Prime)|StreamedAudio]]
| {{check}}
| {{check}}
|
|-
| 0x62
| [[WorldTeleporter (Metroid Prime)|WorldTeleporter]]
| {{check}}
| {{check}}
|
|-
| 0x63
| [[Repulsor (Metroid Prime)|Repulsor]]
| {{check}}
| {{check}}
|
|-
| 0x64
| [[GunTurret (Metroid Prime)|GunTurret]]
| {{check}}
| {{check}}
|
|-
| 0x65
| [[FogVolume (Metroid Prime)|FogVolume]]
| {{check}}
| {{check}}
| Unused
|-
| 0x66
| [[Babygoth (Metroid Prime)|Babygoth]]
| {{check}}
| {{check}}
|
|-
| 0x67
| [[Eyeball (Metroid Prime)|Eyeball]]
| {{check}}
| {{check}}
| Used for Eyon
|-
| 0x68
| [[RadialDamage (Metroid Prime)|RadialDamage]]
| {{check}}
| {{check}}
|
|-
| 0x69
| [[CameraPitchVolume (Metroid Prime)|CameraPitchVolume]]
| {{nocheck}}
| {{check}}
|
|-
| 0x6A
| [[EnvFxDensityController (Metroid Prime)|EnvFxDensityController]]
| {{nocheck}}
| {{check}}
|
|-
| 0x6B
| [[Magdolite (Metroid Prime)|Magdolite]]
| {{nocheck}}
| {{check}}
| Used for Magmoor
|-
| 0x6C
| [[TeamAIMgr (Metroid Prime)|TeamAIMgr]]
| {{nocheck}}
| {{check}}
|
|-
| 0x6D
| [[SnakeWeedSwarm (Metroid Prime)|SnakeWeedSwarm]]
| {{nocheck}}
| {{check}}
| Used for Tangle Weed, Venom Weed
|-
| 0x6E
| [[ActorContraption (Metroid Prime)|ActorContraption]]
| {{nocheck}}
| {{check}}
| Used for Incinerator Drone
|-
| 0x6F
| [[Oculus (Metroid Prime)|Oculus]]
| {{nocheck}}
| {{check}}
|
|-
| 0x70
| [[Geemer (Metroid Prime)|Geemer]]
| {{nocheck}}
| {{check}}
|
|-
| 0x71
| [[SpindleCamera (Metroid Prime)|SpindleCamera]]
| {{nocheck}}
| {{check}}
|
|-
| 0x72
| [[AtomicAlpha (Metroid Prime)|AtomicAlpha]]
| {{nocheck}}
| {{check}}
| Used for Pulse Bombu
|-
| 0x73
| [[CameraHintTrigger (Metroid Prime)|CameraHintTrigger]]
| {{nocheck}}
| {{check}}
|
|-
| 0x74
| [[RumbleEffect (Metroid Prime)|RumbleEffect]]
| {{nocheck}}
| {{check}}
|
|-
| 0x75
| [[AmbientAI (Metroid Prime)|AmbientAI]]
| {{nocheck}}
| {{check}}
| Used for Blastcaps and other ambient creatures
|-
| 0x77
| [[AtomicBeta (Metroid Prime)|AtomicBeta]]
| {{nocheck}}
| {{check}}
| Used for Scatter Bombu
|-
| 0x78
| [[IceZoomer (Metroid Prime)|IceZoomer]]
| {{nocheck}}
| {{check}}
| Unused
|-
| 0x79
| [[Puffer (Metroid Prime)|Puffer]]
| {{nocheck}}
| {{check}}
|
|-
| 0x7A
| [[Tryclops (Metroid Prime)|Tryclops]]
| {{nocheck}}
| {{check}}
|
|-
| 0x7B
| [[Ridley (Metroid Prime)|Ridley]]
| {{nocheck}}
| {{check}}
|
|-
| 0x7C
| [[Seedling (Metroid Prime)|Seedling]]
| {{nocheck}}
| {{check}}
|
|-
| 0x7D
| [[ThermalHeatFader (Metroid Prime)|ThermalHeatFader]]
| {{nocheck}}
| {{check}}
|
|-
| 0x7F
| [[Burrower (Metroid Prime)|Burrower]]
| {{nocheck}}
| {{check}}
|
|-
| 0x81
| [[ScriptBeam (Metroid Prime)|ScriptBeam]]
| {{nocheck}}
| {{check}}
|
|-
| 0x82
| [[WorldLightFader (Metroid Prime)|WorldLightFader]]
| {{nocheck}}
| {{check}}
|
|-
| 0x83
| [[MetroidPrimeStage2 (Metroid Prime)|MetroidPrimeStage2]]
| {{nocheck}}
| {{check}}
|
|-
| 0x84
| [[MetroidPrimeRelay (Metroid Prime)|MetroidPrimeRelay]]
| {{nocheck}}
| {{check}}
| Used for Metroid Prime stage 1
|-
| 0x85
| [[MazeNode (Metroid Prime)|MazeNode]]
| {{nocheck}}
| {{check}}
|
|-
| 0x86
| [[OmegaPirate (Metroid Prime)|OmegaPirate]]
| {{nocheck}}
| {{check}}
|
|-
| 0x87
| [[PhazonPool (Metroid Prime)|PhazonPool]]
| {{nocheck}}
| {{check}}
|
|-
| 0x88
| [[PhazonHealingNodule (Metroid Prime)|PhazonHealingNodule]]
| {{nocheck}}
| {{check}}
|
|-
| 0x89
| [[NewCameraShaker (Metroid Prime)|NewCameraShaker]]
| {{nocheck}}
| {{check}}
|
|-
| 0x8A
| [[ShadowProjector (Metroid Prime)|ShadowProjector]]
| {{nocheck}}
| {{check}}
|
|-
| 0x8B
| [[EnergyBall (Metroid Prime)|EnergyBall]]
| {{nocheck}}
| {{check}}
|
|}

== List of states ==

{| class="wikitable"
! ID
! Name
|-
| 0x0
| Active
|-
| 0x1
| Arrived
|-
| 0x2
| Closed
|-
| 0x3
| Entered
|-
| 0x4
| Exited
|-
| 0x5
| Inactive
|-
| 0x6
| Inside
|-
| 0x7
| MaxReached
|-
| 0x8
| Open
|-
| 0x9
| Zero
|-
| 0xA
| Attack
|-
| 0xB
| {{unknown|Unknown}}
|-
| 0xC
| Retreat
|-
| 0xD
| Patrol
|-
| 0xE
| Dead
|-
| 0xF
| CameraPath
|-
| 0x10
| CameraTarget
|-
| 0x11
| {{unknown|Unknown}}
|-
| 0x12
| Play
|-
| 0x13
| {{unknown|Unknown}}
|-
| 0x14
| DeathRattle
|-
| 0x15
| {{unknown|Unknown}}
|-
| 0x16
| Damage
|-
| 0x17
| {{unknown|Unknown}}
|-
| 0x18
| {{unknown|Unknown}}
|-
| 0x19
| Modify
|-
| 0x1C
| ScanDone
|-
| 0x1E
| {{unknown|Unknown}}
|-
| 0x1F
| ReflectedDamage
|-
| 0x20
| InheritBounds
|}

== List of messages ==

{| class="wikitable"
! ID
! Name
|-
| 0x1
| Activate
|-
| 0x2
| {{unknown|Unknown}}
|-
| 0x3
| Close
|-
| 0x4
| Deactivate
|-
| 0x5
| Decrement
|-
| 0x6
| Follow
|-
| 0x7
| Increment
|-
| 0x8
| Next
|-
| 0x9
| Open
|-
| 0xA
| Reset
|-
| 0xB
| ResetAndStart
|-
| 0xC
| SetToMax
|-
| 0xD
| SetToZero
|-
| 0xE
| Start
|-
| 0xF
| Stop
|-
| 0x10
| StopAndReset
|-
| 0x11
| ToggleActive
|-
| 0x12
| {{unknown|Unknown}}
|-
| 0x13
| Action
|-
| 0x14
| Play
|-
| 0x15
| Alert
|}

[[Category:Metroid Prime]]
[[Category:Metroid Prime Demo]]

List of Script Objects (Metroid Prime 2)

2023-06-14T23:10:43Z

Duncathan: add to echoes category

This is a list of script objects in Metroid Prime 2: Echoes.

__TOC__

== List of script objects ==

{| class="wikitable"
! ID
! Name
! Notes
|-
| <code>ACTR</code>
| [[Actor (Metroid Prime 2)|Actor]]
|
|-
| <code>ACKF</code>
| [[ActorKeyframe (Metroid Prime 2)|ActorKeyframe]]
|
|-
| <code>AROT</code>
| [[ActorRotate (Metroid Prime 2)|ActorRotate]]
|
|-
| <code>ACNT</code>
| [[AdvancedCounter (Metroid Prime 2)|AdvancedCounter]]
|
|-
| <code>ADMG</code>
| [[AreaDamage (Metroid Prime 2)|AreaDamage]]
|
|-
| <code>AIHT</code>
| [[AIHint (Metroid Prime 2)|AIHint]]
|
|-
| <code>AJMP</code>
| [[AIJumpPoint (Metroid Prime 2)|AIJumpPoint]]
|
|-
| <code>AIKF</code>
| [[AIKeyframe (Metroid Prime 2)|AIKeyframe]]
|
|-
| <code>AIMT</code>
| [[AIMannedTurret (Metroid Prime 2)|AIMannedTurret]]
|
|-
| <code>AIWP</code>
| [[AIWaypoint (Metroid Prime 2)|AIWaypoint]]
|
|-
| <code>AMIA</code>
| [[AmbientAI (Metroid Prime 2)|AmbientAI]]
|
|-
| <code>REAA</code>
| [[AreaAttributes (Metroid Prime 2)|AreaAttributes]]
|
|-
| <code>ATMA</code>
| [[AtomicAlpha (Metroid Prime 2)|AtomicAlpha]]
| Used for Harmony Class Drone
|-
| <code>ATMB</code>
| [[AtomicBeta (Metroid Prime 2)|AtomicBeta]]
| Used for Diligence Class Drone
|-
| <code>BSWM</code>
| [[BacteriaSwarm (Metroid Prime 2)|BacteriaSwarm]]
| Used for Ingstorm
|-
| <code>BALT</code>
| [[BallTrigger (Metroid Prime 2)|BallTrigger]]
|
|-
| <code>BLOG</code>
| [[Blogg (Metroid Prime 2)|Blogg]]
| Used for Blogg, Alpha Blogg
|-
| <code>BRZG</code>
| [[Brizgee (Metroid Prime 2)|Brizgee]]
|
|-
| <code>CAMR</code>
| [[Camera (Metroid Prime 2)|Camera]]
|
|-
| <code>BLUR</code>
| [[CameraBlurKeyframe (Metroid Prime 2)|CameraBlurKeyframe]]
|
|-
| <code>FILT</code>
| [[CameraFilterKeyframe (Metroid Prime 2)|CameraFilterKeyframe]]
|
|-
| <code>CAMH</code>
| [[CameraHint (Metroid Prime 2)|CameraHint]]
|
|-
| <code>CAMP</code>
| [[CameraPitch (Metroid Prime 2)|CameraPitch]]
|
|-
| <code>CAMS</code>
| [[CameraShaker (Metroid Prime 2)|CameraShaker]]
|
|-
| <code>CAMW</code>
| [[CameraWaypoint (Metroid Prime 2)|CameraWaypoint]]
|
|-
| <code>CANB</code>
| [[CannonBall (Metroid Prime 2)|CannonBall]]
|
|-
| <code>CHOG</code>
| [[ChozoGhost (Metroid Prime 2)|ChozoGhost]]
| Unused
|-
| <code>COIN</code>
| [[Coin (Metroid Prime 2)|Coin]]
| Unused; use a [[Pickup (Metroid Prime 2)|Pickup]] instead
|-
| <code>CLRM</code>
| [[ColorModulate (Metroid Prime 2)|ColorModulate]]
|
|-
| <code>CMDO</code>
| [[CommandoPirate (Metroid Prime 2)|CommandoPirate]]
|
|-
| <code>CRLY</code>
| [[ConditionalRelay (Metroid Prime 2)|ConditionalRelay]]
|
|-
| <code>CTLH</code>
| [[ControlHint (Metroid Prime 2)|ControlHint]]
|
|-
| <code>CNTA</code>
| [[ControllerAction (Metroid Prime 2)|ControllerAction]]
|
|-
| <code>CNTR</code>
| [[Counter (Metroid Prime 2)|Counter]]
|
|-
| <code>COVR</code>
| [[CoverPoint (Metroid Prime 2)|CoverPoint]]
|
|-
| <code>CRLT</code>
| [[Crystallite (Metroid Prime 2)|Crystallite]]
|
|-
| <code>DTRG</code>
| [[DamageableTrigger (Metroid Prime 2)|DamageableTrigger]]
|
|-
| <code>DTRO</code>
| [[DamageableTriggerOrientated (Metroid Prime 2)|DamageableTriggerOrientated]]
| Unused
|-
| <code>DMGA</code>
| [[DamageActor (Metroid Prime 2)|DamageActor]]
|
|-
| <code>DRKC</code>
| [[DarkCommando (Metroid Prime 2)|DarkCommando]]
|
|-
| <code>DRKS</code>
| [[DarkSamus (Metroid Prime 2)|DarkSamus]]
|
|-
| <code>DSBS</code>
| [[DarkSamusBattleStage (Metroid Prime 2)|DarkSamusBattleStage]]
|
|-
| <code>DKTR</code>
| [[DarkTrooper (Metroid Prime 2)|DarkTrooper]]
| Used for Dark Trooper, Dark Missile Trooper
|-
| <code>DBR1</code>
| [[Debris (Metroid Prime 2)|Debris]]
| Unused
|-
| <code>DBR2</code>
| [[DebrisExtended (Metroid Prime 2)|DebrisExtended]]
|
|-
| <code>DBAR</code>
| [[DestructibleBarrier (Metroid Prime 2)|DestructibleBarrier]]
| Unused
|-
| <code>DGRD</code>
| [[DigitalGuardian (Metroid Prime 2)|DigitalGuardian]]
| Used for Quadraxis
|-
| <code>DGHD</code>
| [[DigitalGuardianHead (Metroid Prime 2)|DigitalGuardianHead]]
| Used for Quadraxis's head
|-
| <code>DFOG</code>
| [[DistanceFog (Metroid Prime 2)|DistanceFog]]
|
|-
| <code>DOCK</code>
| [[Dock (Metroid Prime 2)|Dock]]
|
|-
| <code>DOOR</code>
| [[Door (Metroid Prime 2)|Door]]
|
|-
| <code>EFCT</code>
| [[Effect (Metroid Prime 2)|Effect]]
|
|-
| <code>EPRT</code>
| [[ElitePirate (Metroid Prime 2)|ElitePirate]]
| Used for Ingsmasher
|-
| <code>EMS1</code>
| [[EmperorIngStage1 (Metroid Prime 2)|EmperorIngStage1]]
|
|-
| <code>EM2T</code>
| [[EmperorIngStage2Tentacle (Metroid Prime 2)|EmperorIngStage2Tentacle]]
|
|-
| <code>EMS3</code>
| [[EmperorIngStage3 (Metroid Prime 2)|EmperorIngStage3]]
|
|-
| <code>EMPU</code>
| [[EMPulse (Metroid Prime 2)|EMPulse]]
| Unused
|-
| <code>FXDC</code>
| [[EnvFxDensityController (Metroid Prime 2)|EnvFxDensityController]]
|
|-
| <code>EYEB</code>
| [[EyeBall (Metroid Prime 2)|EyeBall]]
|
|-
| <code>FISH</code>
| [[FishCloud (Metroid Prime 2)|FishCloud]]
|
|-
| <code>FSHM</code>
| [[FishCloudModifier (Metroid Prime 2)|FishCloudModifier]]
|
|-
| <code>FSWM</code>
| [[FlyerSwarm (Metroid Prime 2)|FlyerSwarm]]
| Used for Sandbat, Nightbarb, Hydling, Chykling, Airthorn
|-
| <code>FPRT</code>
| [[FlyingPirate (Metroid Prime 2)|FlyingPirate]]
|
|-
| <code>FOGO</code>
| [[FogOverlay (Metroid Prime 2)|FogOverlay]]
|
|-
| <code>FOGV</code>
| [[FogVolume (Metroid Prime 2)|FogVolume]]
|
|-
| <code>FGTO</code>
| [[ForgottenObject (Metroid Prime 2)|ForgottenObject]]
|
|-
| <code>FNWK</code>
| [[FrontEndDataNetwork (Metroid Prime 2)|FrontEndDataNetwork]]
|
|-
| <code>GENR</code>
| [[Generator (Metroid Prime 2)|Generator]]
|
|-
| <code>GBUG</code>
| [[Glowbug (Metroid Prime 2)|Glowbug]]
|
|-
| <code>GRAP</code>
| [[GrapplePoint (Metroid Prime 2)|GrapplePoint]]
|
|-
| <code>GRCH</code>
| [[Grenchler (Metroid Prime 2)|Grenchler]]
| Used for Grenchler, Grapple Guardian
|-
| <code>GMNU</code>
| [[GuiMenu (Metroid Prime 2)|GuiMenu]]
|
|-
| <code>GPJN</code>
| [[GuiPlayerJoinManager (Metroid Prime 2)|GuiPlayerJoinManager]]
|
|-
| <code>GSCR</code>
| [[GuiScreen (Metroid Prime 2)|GuiScreen]]
|
|-
| <code>GSLD</code>
| [[GuiSlider (Metroid Prime 2)|GuiSlider]]
|
|-
| <code>GWIG</code>
| [[GuiWidget (Metroid Prime 2)|GuiWidget]]
|
|-
| <code>GNTB</code>
| [[GunTurretBase (Metroid Prime 2)|GunTurretBase]]
|
|-
| <code>GNTT</code>
| [[GunTurretTop (Metroid Prime 2)|GunTurretTop]]
|
|-
| <code>HHNT</code>
| [[HUDHint (Metroid Prime 2)|HUDHint]]
|
|-
| <code>MEMO</code>
| [[HUDMemo (Metroid Prime 2)|HUDMemo]]
|
|-
| <code>INGS</code>
| [[Ing (Metroid Prime 2)|Ing]]
| Used for Warrior Ing
|-
| <code>IBSM</code>
| [[IngBlogSwarm (Metroid Prime 2)|IngBlogSwarm]]
|
|-
| <code>IBBG</code>
| [[IngBoostBallGuardian (Metroid Prime 2)|IngBoostBallGuardian]]
|
|-
| <code>IPUD</code>
| [[IngPuddle (Metroid Prime 2)|IngPuddle]]
|
|-
| <code>ISSW</code>
| [[IngSnatchingSwarm (Metroid Prime 2)|IngSnatchingSwarm]]
|
|-
| <code>ISJG</code>
| [[IngSpaceJumpGuardian (Metroid Prime 2)|IngSpaceJumpGuardian]]
|
|-
| <code>ISBG</code>
| [[IngSpiderballGuardian (Metroid Prime 2)|IngSpiderballGuardian]]
|
|-
| <code>KRAL</code>
| [[Kralee (Metroid Prime 2)|Kralee]]
|
|-
| <code>KROC</code>
| [[Krocuss (Metroid Prime 2)|Krocuss]]
|
|-
| <code>DLHT</code>
| [[DynamicLight (Metroid Prime 2)|DynamicLight]]
|
|-
| <code>LUMI</code>
| [[Lumite (Metroid Prime 2)|Lumite]]
|
|-
| <code>MING</code>
| [[MediumIng (Metroid Prime 2)|MediumIng]]
| Used for Hunter Ing
|-
| <code>MRLY</code>
| [[MemoryRelay (Metroid Prime 2)|MemoryRelay]]
|
|-
| <code>MREE</code>
| [[Metaree (Metroid Prime 2)|Metaree]]
| Used for Shriekbat
|-
| <code>MSWM</code>
| [[MetareeSwarm (Metroid Prime 2)|MetareeSwarm]]
| Used for Serenity Class Drone
|-
| <code>MTDA</code>
| [[MetroidAlpha (Metroid Prime 2)|MetroidAlpha]]
| Used for Tallon Metroid
|-
| <code>MIDI</code>
| [[Midi (Metroid Prime 2)|Midi]]
| Unused
|-
| <code>MNNG</code>
| [[MinorIng (Metroid Prime 2)|MinorIng]]
| Used for Inglet
|-
| <code>MYSF</code>
| [[MysteryFlyer (Metroid Prime 2)|MysteryFlyer]]
| Used for War Wasp
|-
| <code>OCTS</code>
| [[OctapedeSegment (Metroid Prime 2)|OctapedeSegment]]
|
|-
| <code>PARA</code>
| [[Parasite (Metroid Prime 2)|Parasite]]
| Unused
|-
| <code>PCAM</code>
| [[PathCamera (Metroid Prime 2)|PathCamera]]
|
|-
| <code>PMCT</code>
| [[PathMeshCtrl (Metroid Prime 2)|PathMeshCtrl]]
|
|-
| <code>PCKP</code>
| [[Pickup (Metroid Prime 2)|Pickup]]
|
|-
| <code>PKGN</code>
| [[PickupGenerator (Metroid Prime 2)|PickupGenerator]]
|
|-
| <code>PILB</code>
| [[Pillbug (Metroid Prime 2)|Pillbug]]
|
|-
| <code>PLAT</code>
| [[Platform (Metroid Prime 2)|Platform]]
|
|-
| <code>PSSM</code>
| [[PlantScarabSwarm (Metroid Prime 2)|PlantScarabSwarm]]
|
|-
| <code>PLAC</code>
| [[PlayerActor (Metroid Prime 2)|PlayerActor]]
|
|-
| <code>PLCT</code>
| [[PlayerController (Metroid Prime 2)|PlayerController]]
|
|-
| <code>HINT</code>
| [[PlayerHint (Metroid Prime 2)|PlayerHint]]
|
|-
| <code>PSCH</code>
| [[PlayerStateChange (Metroid Prime 2)|PlayerStateChange]]
| Unused
|-
| <code>PLRT</code>
| [[PlayerTurret (Metroid Prime 2)|PlayerTurret]]
|
|-
| <code>POIN</code>
| [[PointOfInterest (Metroid Prime 2)|PointOfInterest]]
|
|-
| <code>PRTT</code>
| [[PortalTransition (Metroid Prime 2)|PortalTransition]]
|
|-
| <code>SPOR</code>
| [[PuddleSpore (Metroid Prime 2)|PuddleSpore]]
|
|-
| <code>PUFR</code>
| [[Puffer (Metroid Prime 2)|Puffer]]
|
|-
| <code>RADD</code>
| [[RadialDamage (Metroid Prime 2)|RadialDamage]]
|
|-
| <code>RRLY</code>
| [[RandomRelay (Metroid Prime 2)|RandomRelay]]
|
|-
| <code>REPL</code>
| [[Repulsor (Metroid Prime 2)|Repulsor]]
|
|-
| <code>REZB</code>
| [[Rezbit (Metroid Prime 2)|Rezbit]]
|
|-
| <code>RPTL</code>
| [[RiftPortal (Metroid Prime 2)|RiftPortal]]
|
|-
| <code>RIPR</code>
| [[Ripper (Metroid Prime 2)|Ripper]]
| Unused
|-
| <code>RIPL</code>
| [[Ripple (Metroid Prime 2)|Ripple]]
| Unused
|-
| <code>RMAC</code>
| [[RoomAcoustics (Metroid Prime 2)|RoomAcoustics]]
|
|-
| <code>RSFA</code>
| [[RsfAudio (Metroid Prime 2)|RsfAudio]]
| Unused
|-
| <code>RBPZ</code>
| [[RubiksPuzzle (Metroid Prime 2)|RubiksPuzzle]]
|
|-
| <code>RUMB</code>
| [[RumbleEffect (Metroid Prime 2)|RumbleEffect]]
|
|-
| <code>SAFE</code>
| [[SafeZone (Metroid Prime 2)|SafeZone]]
|
|-
| <code>SFZC</code>
| [[SafeZoneCrystal (Metroid Prime 2)|SafeZoneCrystal]]
|
|-
| <code>SNDB</code>
| [[SandBoss (Metroid Prime 2)|SandBoss]]
| Used for Amorbis
|-
| <code>WORM</code>
| [[Sandworm (Metroid Prime 2)|Sandworm]]
| Used for Sandigger, Bomb Guardian
|-
| <code>SLCT</code>
| [[ScriptLayerController (Metroid Prime 2)|ScriptLayerController]]
|
|-
| <code>SRLY</code>
| [[Relay (Metroid Prime 2)|Relay]]
|
|-
| <code>SQTR</code>
| [[SequenceTimer (Metroid Prime 2)|SequenceTimer]]
|
|-
| <code>SHDW</code>
| [[ShadowProjector (Metroid Prime 2)|ShadowProjector]]
|
|-
| <code>SHRD</code>
| [[Shredder (Metroid Prime 2)|Shredder]]
|
|-
| <code>SHRK</code>
| [[Shrieker (Metroid Prime 2)|Shrieker]]
|
|-
| <code>SILH</code>
| [[Silhouette (Metroid Prime 2)|Silhouette]]
| Unused
|-
| <code>SKRP</code>
| [[SkyRipple (Metroid Prime 2)|SkyRipple]]
|
|-
| <code>SNAK</code>
| [[SnakeWeedSwarm (Metroid Prime 2)|SnakeWeedSwarm]]
| Used for Venom Weed
|-
| <code>SOND</code>
| [[Sound (Metroid Prime 2)|Sound]]
|
|-
| <code>SNDM</code>
| [[SoundModifier (Metroid Prime 2)|SoundModifier]]
|
|-
| <code>PIRT</code>
| [[SpacePirate (Metroid Prime 2)|SpacePirate]]
|
|-
| <code>SPNK</code>
| [[SpankWeed (Metroid Prime 2)|SpankWeed]]
| Unused
|-
| <code>SPWN</code>
| [[SpawnPoint (Metroid Prime 2)|SpawnPoint]]
|
|-
| <code>SPFN</code>
| [[SpecialFunction (Metroid Prime 2)|SpecialFunction]]
|
|-
| <code>BALS</code>
| [[SpiderBallAttractionSurface (Metroid Prime 2)|SpiderBallAttractionSurface]]
|
|-
| <code>BALW</code>
| [[SpiderBallWaypoint (Metroid Prime 2)|SpiderBallWaypoint]]
|
|-
| <code>SPND</code>
| [[SpindleCamera (Metroid Prime 2)|SpindleCamera]]
|
|-
| <code>SPIN</code>
| [[Spinner (Metroid Prime 2)|Spinner]]
|
|-
| <code>SPTR</code>
| [[Splinter (Metroid Prime 2)|Splinter]]
| Used for Splinter, Alpha Splinter
|-
| <code>SPLU</code>
| [[SplitterCommandModule (Metroid Prime 2)|SplitterCommandModule]]
| Used for Quad MB
|-
| <code>SPLL</code>
| [[SplitterMainChassis (Metroid Prime 2)|SplitterMainChassis]]
| Used for Quad CM
|-
| <code>SPBB</code>
| [[SporbBase (Metroid Prime 2)|SporbBase]]
| Used for Sporb, Power Bomb Guardian
|-
| <code>SPBN</code>
| [[SporbNeedle (Metroid Prime 2)|SporbNeedle]]
|
|-
| <code>SPBT</code>
| [[SporbTop (Metroid Prime 2)|SporbTop]]
|
|-
| <code>SPBP</code>
| [[SporbProjectile (Metroid Prime 2)|SporbProjectile]]
|
|-
| <code>STEM</code>
| [[Steam (Metroid Prime 2)|Steam]]
|
|-
| <code>STOD</code>
| [[StoneToad (Metroid Prime 2)|StoneToad]]
| Used for Watchdrone
|-
| <code>STAU</code>
| [[StreamedAudio (Metroid Prime 2)|StreamedAudio]]
|
|-
| <code>MOVI</code>
| [[StreamedMovie (Metroid Prime 2)|StreamedMovie]]
|
|-
| <code>SUBT</code>
| [[Subtitle (Metroid Prime 2)|Subtitle]]
|
|-
| <code>SURC</code>
| [[SurfaceCamera (Metroid Prime 2)|SurfaceCamera]]
|
|-
| <code>SWTC</code>
| [[Switch (Metroid Prime 2)|Switch]]
|
|-
| <code>SBS1</code>
| [[SwampBossStage1 (Metroid Prime 2)|SwampBossStage1]]
| Used for Chykka Larva
|-
| <code>SBS2</code>
| [[SwampBossStage2 (Metroid Prime 2)|SwampBossStage2]]
| Used for Chykka
|-
| <code>TGPT</code>
| [[TargetingPoint (Metroid Prime 2)|TargetingPoint]]
|
|-
| <code>TMAI</code>
| [[TeamAI (Metroid Prime 2)|TeamAI]]
|
|-
| <code>TXPN</code>
| [[TextPane (Metroid Prime 2)|TextPane]]
|
|-
| <code>TKEY</code>
| [[TimeKeyframe (Metroid Prime 2)|TimeKeyframe]]
|
|-
| <code>TIMR</code>
| [[Timer (Metroid Prime 2)|Timer]]
|
|-
| <code>TRGR</code>
| [[Trigger (Metroid Prime 2)|Trigger]]
|
|-
| <code>TRGE</code>
| [[TriggerEllipsoid (Metroid Prime 2)|TriggerEllipsoid]]
|
|-
| <code>TRGO</code>
| [[TriggerOrientated (Metroid Prime 2)|TriggerOrientated]]
|
|-
| <code>TRYC</code>
| [[Tryclops (Metroid Prime 2)|Tryclops]]
| Used for Mechlops
|-
| <code>FLAR</code>
| [[VisorFlare (Metroid Prime 2)|VisorFlare]]
|
|-
| <code>VGOO</code>
| [[VisorGoo (Metroid Prime 2)|VisorGoo]]
|
|-
| <code>WATR</code>
| [[Water (Metroid Prime 2)|Water]]
|
|-
| <code>WLWK</code>
| [[WallWalker (Metroid Prime 2)|WallWalker]]
| Used for Mekenobite
|-
| <code>WAYP</code>
| [[Waypoint (Metroid Prime 2)|Waypoint]]
|
|-
| <code>WISP</code>
| [[WispTentacle (Metroid Prime 2)|WispTentacle]]
| Used for DarklingTentacle
|-
| <code>WLIT</code>
| [[WorldLightFader (Metroid Prime 2)|WorldLightFader]]
|
|-
| <code>TEL1</code>
| [[WorldTeleporter (Metroid Prime 2)|WorldTeleporter]]
|
|}

== List of states ==

{| class="wikitable"
! ID
! Name
|-
| <code>!ZER</code>
| NonZero
|-
| <code>ACTV</code>
| Active
|-
| <code>AIS1</code>
| AILogicState1
|-
| <code>AIS2</code>
| AILogicState2
|-
| <code>AIS3</code>
| AILogicState3
|-
| <code>APRC</code>
| Approach
|-
| <code>ARRV</code>
| Arrived
|-
| <code>ATCL</code>
| AttachedCollisionObject
|-
| <code>ATOB</code>
| AttachedAnimatedObject
|-
| <code>ATTK</code>
| Attack
|-
| <code>BIDG</code>
| BallIceXDamage
|-
| <code>BXDG</code>
| BallXDamage
|-
| <code>CLOS</code>
| Closed
|-
| <code>CONN</code>
| Connect
|-
| <code>CPLR</code>
| {{unknown|Unknown}}
|-
| <code>CPTH</code>
| CameraPath
|-
| <code>CTGT</code>
| CameraTarget
|-
| <code>CTIM</code>
| CameraTime
|-
| <code>DAMG</code>
| Damage
|-
| <code>DANN</code>
| {{unknown|Unknown}}
|-
| <code>DBAI</code>
| {{unknown|Unknown}}
|-
| <code>DBAL</code>
| {{unknown|Unknown}}
|-
| <code>DBMB</code>
| {{unknown|Unknown}}
|-
| <code>DCAN</code>
| {{unknown|Unknown}}
|-
| <code>DDRK</code>
| {{unknown|Unknown}}
|-
| <code>DEAD</code>
| Dead
|-
| <code>DFST</code>
| {{unknown|Unknown}}
|-
| <code>DGNR</code>
| DeGenerate
|-
| <code>DLGT</code>
| {{unknown|Unknown}}
|-
| <code>DMIS</code>
| {{unknown|Unknown}}
|-
| <code>DPBM</code>
| {{unknown|Unknown}}
|-
| <code>DPHZ</code>
| {{unknown|Unknown}}
|-
| <code>DPWR</code>
| {{unknown|Unknown}}
|-
| <code>DRKX</code>
| DarkXDamage
|-
| <code>DSCW</code>
| {{unknown|Unknown}}
|-
| <code>ENTR</code>
| Entered
|-
| <code>EXIT</code>
| Exited
|-
| <code>FOOT</code>
| Footstep
|-
| <code>FREZ</code>
| Freeze
|-
| <code>GRNT</code>
| Generate
|-
| <code>IBND</code>
| InheritBounds
|-
| <code>ICTV</code>
| Inactive
|-
| <code>IDMG</code>
| IceXDamage
|-
| <code>INSD</code>
| Inside
|-
| <code>IS00</code>
| InternalState00
|-
| <code>IS01</code>
| InternalState01
|-
| <code>IS02</code>
| InternalState02
|-
| <code>IS03</code>
| InternalState03
|-
| <code>IS04</code>
| InternalState04
|-
| <code>IS05</code>
| InternalState05
|-
| <code>IS06</code>
| InternalState06
|-
| <code>IS07</code>
| InternalState07
|-
| <code>IS08</code>
| InternalState08
|-
| <code>IS09</code>
| InternalState09
|-
| <code>IS10</code>
| InternalState10
|-
| <code>IS11</code>
| InternalState11
|-
| <code>IS12</code>
| InternalState12
|-
| <code>IS13</code>
| InternalState13
|-
| <code>IS14</code>
| InternalState14
|-
| <code>IS15</code>
| InternalState15
|-
| <code>IS16</code>
| InternalState16
|-
| <code>IS17</code>
| InternalState17
|-
| <code>IS18</code>
| InternalState18
|-
| <code>IS19</code>
| InternalState19
|-
| <code>LEFT</code>
| Left
|-
| <code>MAXR</code>
| MaxReached
|-
| <code>MDFY</code>
| Modify
|-
| <code>OPEN</code>
| Open
|-
| <code>PLAY</code>
| Play
|-
| <code>PRSA</code>
| PressA
|-
| <code>PRSB</code>
| PressB
|-
| <code>PRST</code>
| PressStart
|-
| <code>PRSX</code>
| PressX
|-
| <code>PRSY</code>
| PressY
|-
| <code>PRSZ</code>
| PressZ
|-
| <code>PTRL</code>
| Patrol
|-
| <code>RATL</code>
| DeathRattle
|-
| <code>RDUE</code>
| SpawnResidue
|-
| <code>REFD</code>
| ReflectedDamage
|-
| <code>RESD</code>
| ResistedDamage
|-
| <code>RGHT</code>
| Right
|-
| <code>RTRT</code>
| Retreat
|-
| <code>SCND</code>
| ScanDone
|-
| <code>SCNS</code>
| ScanSource
|-
| <code>SQNC</code>
| Sequence
|-
| <code>UFRZ</code>
| UnFreeze
|-
| <code>UP </code>
| Up
|-
| <code>XDMG</code>
| XDamage
|-
| <code>XINB</code>
| InBack
|-
| <code>XINF</code>
| InFront
|-
| <code>ZERO</code>
| Zero
|}

== List of messages ==

{| class="wikitable"
! ID
! Name
|-
| <code>ACTN</code>
| Action
|-
| <code>ACTV</code>
| Activate
|-
| <code>ALRT</code>
| Alert
|-
| <code>ARRV</code>
| Arrive
|-
| <code>ATCH</code>
| Attach
|-
| <code>CLOS</code>
| Close
|-
| <code>CORG</code>
| ClearOriginator
|-
| <code>DCTV</code>
| Deactivate
|-
| <code>DECR</code>
| Decrement
|-
| <code>ESCP</code>
| Escape
|-
| <code>FOLW</code>
| Follow
|-
| <code>IM00</code>
| InternalMessage00
|-
| <code>IM01</code>
| InternalMessage01
|-
| <code>IM02</code>
| InternalMessage02
|-
| <code>IM03</code>
| InternalMessage03
|-
| <code>IM04</code>
| InternalMessage04
|-
| <code>IM05</code>
| InternalMessage05
|-
| <code>IM06</code>
| InternalMessage06
|-
| <code>IM07</code>
| InternalMessage07
|-
| <code>IM08</code>
| InternalMessage08
|-
| <code>IM09</code>
| InternalMessage09
|-
| <code>IM10</code>
| InternalMessage10
|-
| <code>IM11</code>
| InternalMessage11
|-
| <code>IM12</code>
| InternalMessage12
|-
| <code>IM13</code>
| InternalMessage13
|-
| <code>IM14</code>
| InternalMessage14
|-
| <code>INCR</code>
| Increment
|-
| <code>KILL</code>
| Kill
|-
| <code>LEFT</code>
| Left
|-
| <code>LOAD</code>
| Load
|-
| <code>LOCK</code>
| Lock
|-
| <code>NEXT</code>
| Next
|-
| <code>OPEN</code>
| Open
|-
| <code>PLAY</code>
| Play
|-
| <code>RSET</code>
| Reset
|-
| <code>RSTS</code>
| ResetAndStart
|-
| <code>SMAX</code>
| SetToMax
|-
| <code>SORG</code>
| SetOriginator
|-
| <code>STOP</code>
| Stop
|-
| <code>STPR</code>
| StopAndReset
|-
| <code>STRT</code>
| Start
|-
| <code>TCTV</code>
| ToggleActive
|-
| <code>ULCK</code>
| Unlock
|-
| <code>ULOD</code>
| Unload
|-
| <code>XCLR</code>
| Clear
|-
| <code>XDEL</code>
| Delete
|-
| <code>XDMG</code>
| XDamage
|-
| <code>ZERO</code>
| SetToZero
|}

{{category:Metroid Prime 2: Echoes}}
[[Category:Metroid Prime 2: Echoes]]

MAPA (File Format)

2023-05-02T03:00:56Z

Duncathan: added list of mappable object types for echoes

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 tables below for MP1/MP2 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}}
|-
|[[GUID]]
|'''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
|}

==== MP2 Types ====
{| class="wikitable"
!Type
!Description
|-
|0
|Normal Door
|-
|1
|Missile Door
|-
|2
|Dark Door
|-
|3
|Annihilator Door
|-
|4
|Light Door
|-
|5
|Super Missile Door
|-
|6
|Seeker Missile Door
|-
|7
|Power Bomb Door
|-
|16
|Elevator
|-
|17
|Save Station
|-
|20
|Ammo Station
|-
|21
|Portal
|-
|22
|Light Teleporter
|-
|23
|Translator Gate
|-
|24
|Up Arrow
|-
|25
|Down Arrow
|}

=== 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]]

MREA (Metroid Prime 2)

2022-01-24T21:07:30Z

Duncathan: fix and add links in TOC

''See [[MREA (File Format)]] for the other revisions of this format.''

The '''MREA format''' defines areas (rooms) in Metroid Prime 2. It serves the same purpose as the MREA files from Prime 1, but in Echoes it was updated with new features, including some new data sections and the ability to compress most of the data in the file.

{{todo|Rest of the article needs to be written. There's a lot known about this format that should be documented.}}

__TOC__

== Format ==

Like CMDL, MREA files are split up into a number of 32-byte aligned sections. Every section both starts and ends on a 32-byte boundary. These are used to separate different parts of the file; different types of sections typically indicate different sets of data. The header declares the section count and the size of each one; using these is the only way to navigate the file.

These are the sections in each MREA file, in the order they appear in the file:

{| class="wikitable"
! Identifier
! Name
|-
| {{none}}
| [[#World Geometry|World Geometry]]
|-
| {{none}}
| [[#Unknown Section 1|Unknown Section 1]]
|-
| <code>SCLY</code>
| [[Scriptable_Layers_(Metroid_Prime_2)|Script Layers]]
|-
| <code>SCGN</code>
| Generated Script Objects
|-
| <code>0xDEAFBABE</code>
| [[#Collision|Collision]]
|-
| {{none}}
| [[MREA (Metroid Prime)#Unknown Section|Unknown Section 2]]
|-
| <code>0xBABEDEAD</code>
| [[Lights (Metroid Prime)|Lights]]
|-
| <code>VISI</code>
| [[VISI (MREA Section)|Visibility Tree]]
|-
| {{none}}
| [[#Path|Path]]
|-
| {{none}}
| [[#Portal Area|Portal Area]]
|-
| {{none}}
| [[#Static Geometry Map|Static Geometry Map]]
|}

=== Header ===

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Description
|-
| 0x0
| u32
| 1
| '''Magic'''
| Always <code>0xDEADBEEF</code>.
|-
| 0x4
| u32
| 1
| '''Version'''
| See [[MREA (File Format)|hub article]] for a list of possible version numbers.
|-
| 0x8
| float
| 12
| '''Area Transform'''
| Matrix that represents the area's transform from the origin. Most area data is pre-transformed, so this matrix is only used occasionally.
|-
| 0x38
| u32
| 1
| '''World Model Count'''
| Number of world models in this area.
|-
| 0x3C
| u32
| 1
| '''Script Layer Count'''
| Number of script layers in this area.
|-
| 0x40
| u32
| 1
| '''Data Section Count'''
| Number of data sections in the file.
|-
| 0x44
| u32
| 1
| '''Geometry Section'''
| Section index for world geometry data. Always 0; starts on materials.
|-
| 0x48
| u32
| 1
| '''Script Layers Section'''
| Section index for script layer data.
|-
| 0x4C
| u32
| 1
| '''Generated Script Objects Section'''
| Section index for generated script object data.
|-
| 0x50
| u32
| 1
| '''Collision Section'''
| Section index for collision data.
|-
| 0x54
| u32
| 1
| '''Unknown Section 1'''
| Section index for first unknown section.
|-
| 0x58
| u32
| 1
| '''Lights Section'''
| Section index for light data.
|-
| 0x5C
| u32
| 1
| '''Visibility Tree Section'''
| Section index for visibility tree data.
|-
| 0x60
| u32
| 1
| '''Path Section'''
| Section index for path data.
|-
| 0x64
| u32
| 1
| '''Unknown Section 2'''
| Section index for second unknown section.
|-
| 0x68
| u32
| 1
| '''Portal Area Section'''
| Section index for portal area data.
|-
| 0x6C
| u32
| 1
| '''Static Geometry Map Section'''
| Section index for static geometry map data.
|-
| 0x70
| u32
| 1
| '''Compressed Block Count'''
| Number of compressed data blocks in the file.
|-
| 0x74
| u32
| 3
| '''Padding'''
| Padding bytes that align the file with the next multiple-of-32 offset.
|-
| 0x80
| u32
| ''Data Section Count''
| '''Data Section Sizes'''
| Array containing the size of each data section in the file. Every size is always a multiple of 32.
|-
| colspan=5 {{unknown|Pad to 32 bytes before compressed block definitions begins}}
|}

==== Compressed Blocks ====

The MREA format contains compressed blocks that can each contain a number of regular file sections within them. The data defining these blocks is at the end of the MREA header; the beginning and end of the compressed block list is padded to 32 bytes. The decompressed size of a block is capped at 0x20000 bytes; each section contains as many MREA sections as it can fit under that size limit. There are two exceptions:

* If a single section's uncompressed size is larger than 0x20000, then its corresponding compressed block can exceed the size limit.
* Each SCLY and SCGN layer is always in its own block, regardless of how close to the limit it is.

This is the structure of each block definition:

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Notes
|-
| 0x0
| u32
| 1
| '''Buffer Size'''
| This is always 0x120 bytes larger than the uncompressed size on compressed bytes, and the same value as the uncompressed size on uncompressed blocks
|-
| 0x4
| u32
| 1
| '''Uncompressed Size'''
|
|-
| 0x8
| u32
| 1
| '''Compressed Size'''
| This is 0 on uncompressed blocks.
|-
| 0xC
| u32
| 1
| '''Data Section Count'''
| The number of regular data sections contained in this block.
|-
| 0x10
| colspan=5 {{unknown|Block definition end}}
|}

The actual data contained in these blocks is padded to 32 bytes, but their padding is located at the beginning of the block rather than the end, so it's required to account for the padding before you start decompressing. Thee data is compressed using segmented LZO1X-999; the "segmented" part means there's multiple segments of data that are compressed/decompressed separately. Each segment starts with a 16-bit size value. The size value is signed; a negative value indicates the segment is not compressed (this is done when compressing a segment doesn't reduce its size). Each segment is 0x4000 bytes large when decompressed (except the last one).

=== World Geometry ===
''See [[MREA (Metroid Prime)#World Geometry]], [[Materials (Metroid Prime)]] and [[Geometry (Metroid Prime)]]''

Largely [[MREA (Metroid Prime)#World Geometry|the same as Prime 1]]. There are two new sections to watch out for on each world model (described on the [[Geometry (Metroid Prime)]] page). There's two sections that are now grouped under the same section number as world geometry.

==== Area Octree ====

The [[MREA (Metroid Prime)#Area Octree|area octree]] section is back from Prime 1, but no longer has its own section number - it's now grouped under the same section number as world geometry.

==== Surface Group Bounding Boxes ====

This is a new section introduced in Metroid Prime 2, which is grouped under the world geometry section number and appears after the area octree. It contains an array of a structure that provides the bounding box for every surface group. The first entry in the array has the combined bounding box for all of the world geometry in the entire area, then each surface group is listed in order.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Group Bounds Entry Count'''
| Count of elements in the following array.
|-
| [[#Group Bounds|Group Bounds Entry]]
| ''Group Bounds Entry Count''
| '''Group Bounds Entry Array'''
| Array of a struct that provides the bounding box for each surface group in the area.
|}

===== Group Bounds Entry =====

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Notes
|-
| 0x0
| float
| 6
| '''Group Bounding Box'''
| Axis-aligned bounding box of all surfaces contained in the group.
|-
| 0x18
| u16
| 1
| '''World Model Index'''
| Index of the world model that contains this group.
|-
| 0x1A
| u16
| 1
| '''Surface Group Index'''
| Model-relative index of the surface group.
|-
| 0x1C
| u16
| 1
| {{unknown|Unknown}}
| On the first entry, always 1. On other entries, always -1.
|-
| 0x1E
| u16
| 1
| {{unknown|Unknown}}
| On the first entry, always -1. On other entries, always the entry's index position + 1.
|-
| 0x20
| colspan=4 {{unknown|End of bounds entry}}
|}

=== Unknown Section 1 ===

This section appears to be related to world geometry.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Element Count 1'''
| Count of elements in the next array. Always 0 in light world areas.
|-
| u32
| ''Element Count 1''
| {{unknown|Unknown}}
| May also be a pair of u16s?
|-
| u32
| 1
| '''Element Count 2'''
| Count of elements in the next array. Matches the area's surface group count.
|-
| u8
| ''Element Count 2''
| {{unknown|Unknown}}
| Every entry is always 0xFF in light world areas. Dark world appears to include both 0x00 and 0xFF?
|-
| colspan=4 {{unknown|End of section}}
|}

=== Collision ===

''Main article: [[Area Collision (File Format)]]''

=== Path ===

This section only contains a single [[PATH (File Format)|PATH]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area PATH Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

=== Portal Area ===

This section only contains a single [[PTLA (File Format)|PTLA]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area PTLA Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

=== Static Geometry Map ===

This section only contains a single [[EGMC (File Format)|EGMC]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area EGMC Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

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

MREA (Metroid Prime 2)

2022-01-24T20:55:44Z

Duncathan: /* Unknown Section 1 */fixes typo in previous edit

''See [[MREA (File Format)]] for the other revisions of this format.''

The '''MREA format''' defines areas (rooms) in Metroid Prime 2. It serves the same purpose as the MREA files from Prime 1, but in Echoes it was updated with new features, including some new data sections and the ability to compress most of the data in the file.

{{todo|Rest of the article needs to be written. There's a lot known about this format that should be documented.}}

__TOC__

== Format ==

Like CMDL, MREA files are split up into a number of 32-byte aligned sections. Every section both starts and ends on a 32-byte boundary. These are used to separate different parts of the file; different types of sections typically indicate different sets of data. The header declares the section count and the size of each one; using these is the only way to navigate the file.

These are the sections in each MREA file, in the order they appear in the file:

{| class="wikitable"
! Identifier
! Name
|-
| {{none}}
| [[#World Geometry|World Geometry]]
|-
| {{none}}
| [[#Unknown Section 1|Unknown Section 1]]
|-
| <code>SCLY</code>
| [[Scriptable_Layers_(Metroid_Prime_2)|Script Layers]]
|-
| <code>SCGN</code>
| Generated Script Objects
|-
| <code>0xDEAFBABE</code>
| [[#Collision|Collision]]
|-
| {{none}}
| [[#MREA (Metroid Prime)#Unknown Section|Unknown Section 2]]
|-
| <code>0xBABEDEAD</code>
| Lights
|-
| <code>VISI</code>
| Visibility Tree
|-
| {{none}}
| [[#Path|Path]]
|-
| {{none}}
| [[#Portal Area|Portal Area]]
|-
| {{none}}
| [[#Static Geometry Map|Static Geometry Map]]
|}

=== Header ===

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Description
|-
| 0x0
| u32
| 1
| '''Magic'''
| Always <code>0xDEADBEEF</code>.
|-
| 0x4
| u32
| 1
| '''Version'''
| See [[MREA (File Format)|hub article]] for a list of possible version numbers.
|-
| 0x8
| float
| 12
| '''Area Transform'''
| Matrix that represents the area's transform from the origin. Most area data is pre-transformed, so this matrix is only used occasionally.
|-
| 0x38
| u32
| 1
| '''World Model Count'''
| Number of world models in this area.
|-
| 0x3C
| u32
| 1
| '''Script Layer Count'''
| Number of script layers in this area.
|-
| 0x40
| u32
| 1
| '''Data Section Count'''
| Number of data sections in the file.
|-
| 0x44
| u32
| 1
| '''Geometry Section'''
| Section index for world geometry data. Always 0; starts on materials.
|-
| 0x48
| u32
| 1
| '''Script Layers Section'''
| Section index for script layer data.
|-
| 0x4C
| u32
| 1
| '''Generated Script Objects Section'''
| Section index for generated script object data.
|-
| 0x50
| u32
| 1
| '''Collision Section'''
| Section index for collision data.
|-
| 0x54
| u32
| 1
| '''Unknown Section 1'''
| Section index for first unknown section.
|-
| 0x58
| u32
| 1
| '''Lights Section'''
| Section index for light data.
|-
| 0x5C
| u32
| 1
| '''Visibility Tree Section'''
| Section index for visibility tree data.
|-
| 0x60
| u32
| 1
| '''Path Section'''
| Section index for path data.
|-
| 0x64
| u32
| 1
| '''Unknown Section 2'''
| Section index for second unknown section.
|-
| 0x68
| u32
| 1
| '''Portal Area Section'''
| Section index for portal area data.
|-
| 0x6C
| u32
| 1
| '''Static Geometry Map Section'''
| Section index for static geometry map data.
|-
| 0x70
| u32
| 1
| '''Compressed Block Count'''
| Number of compressed data blocks in the file.
|-
| 0x74
| u32
| 3
| '''Padding'''
| Padding bytes that align the file with the next multiple-of-32 offset.
|-
| 0x80
| u32
| ''Data Section Count''
| '''Data Section Sizes'''
| Array containing the size of each data section in the file. Every size is always a multiple of 32.
|-
| colspan=5 {{unknown|Pad to 32 bytes before compressed block definitions begins}}
|}

==== Compressed Blocks ====

The MREA format contains compressed blocks that can each contain a number of regular file sections within them. The data defining these blocks is at the end of the MREA header; the beginning and end of the compressed block list is padded to 32 bytes. The decompressed size of a block is capped at 0x20000 bytes; each section contains as many MREA sections as it can fit under that size limit. There are two exceptions:

* If a single section's uncompressed size is larger than 0x20000, then its corresponding compressed block can exceed the size limit.
* Each SCLY and SCGN layer is always in its own block, regardless of how close to the limit it is.

This is the structure of each block definition:

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Notes
|-
| 0x0
| u32
| 1
| '''Buffer Size'''
| This is always 0x120 bytes larger than the uncompressed size on compressed bytes, and the same value as the uncompressed size on uncompressed blocks
|-
| 0x4
| u32
| 1
| '''Uncompressed Size'''
|
|-
| 0x8
| u32
| 1
| '''Compressed Size'''
| This is 0 on uncompressed blocks.
|-
| 0xC
| u32
| 1
| '''Data Section Count'''
| The number of regular data sections contained in this block.
|-
| 0x10
| colspan=5 {{unknown|Block definition end}}
|}

The actual data contained in these blocks is padded to 32 bytes, but their padding is located at the beginning of the block rather than the end, so it's required to account for the padding before you start decompressing. Thee data is compressed using segmented LZO1X-999; the "segmented" part means there's multiple segments of data that are compressed/decompressed separately. Each segment starts with a 16-bit size value. The size value is signed; a negative value indicates the segment is not compressed (this is done when compressing a segment doesn't reduce its size). Each segment is 0x4000 bytes large when decompressed (except the last one).

=== World Geometry ===
''See [[MREA (Metroid Prime)#World Geometry]], [[Materials (Metroid Prime)]] and [[Geometry (Metroid Prime)]]''

Largely [[MREA (Metroid Prime)#World Geometry|the same as Prime 1]]. There are two new sections to watch out for on each world model (described on the [[Geometry (Metroid Prime)]] page). There's two sections that are now grouped under the same section number as world geometry.

==== Area Octree ====

The [[MREA (Metroid Prime)#Area Octree|area octree]] section is back from Prime 1, but no longer has its own section number - it's now grouped under the same section number as world geometry.

==== Surface Group Bounding Boxes ====

This is a new section introduced in Metroid Prime 2, which is grouped under the world geometry section number and appears after the area octree. It contains an array of a structure that provides the bounding box for every surface group. The first entry in the array has the combined bounding box for all of the world geometry in the entire area, then each surface group is listed in order.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Group Bounds Entry Count'''
| Count of elements in the following array.
|-
| [[#Group Bounds|Group Bounds Entry]]
| ''Group Bounds Entry Count''
| '''Group Bounds Entry Array'''
| Array of a struct that provides the bounding box for each surface group in the area.
|}

===== Group Bounds Entry =====

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Notes
|-
| 0x0
| float
| 6
| '''Group Bounding Box'''
| Axis-aligned bounding box of all surfaces contained in the group.
|-
| 0x18
| u16
| 1
| '''World Model Index'''
| Index of the world model that contains this group.
|-
| 0x1A
| u16
| 1
| '''Surface Group Index'''
| Model-relative index of the surface group.
|-
| 0x1C
| u16
| 1
| {{unknown|Unknown}}
| On the first entry, always 1. On other entries, always -1.
|-
| 0x1E
| u16
| 1
| {{unknown|Unknown}}
| On the first entry, always -1. On other entries, always the entry's index position + 1.
|-
| 0x20
| colspan=4 {{unknown|End of bounds entry}}
|}

=== Unknown Section 1 ===

This section appears to be related to world geometry.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Element Count 1'''
| Count of elements in the next array. Always 0 in light world areas.
|-
| u32
| ''Element Count 1''
| {{unknown|Unknown}}
| May also be a pair of u16s?
|-
| u32
| 1
| '''Element Count 2'''
| Count of elements in the next array. Matches the area's surface group count.
|-
| u8
| ''Element Count 2''
| {{unknown|Unknown}}
| Every entry is always 0xFF in light world areas. Dark world appears to include both 0x00 and 0xFF?
|-
| colspan=4 {{unknown|End of section}}
|}

=== Collision ===

''Main article: [[Area Collision (File Format)]]''

=== Path ===

This section only contains a single [[PATH (File Format)|PATH]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area PATH Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

=== Portal Area ===

This section only contains a single [[PTLA (File Format)|PTLA]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area PTLA Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

=== Static Geometry Map ===

This section only contains a single [[EGMC (File Format)|EGMC]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area EGMC Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

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

MREA (Metroid Prime 2)

2022-01-24T20:52:16Z

Duncathan: /* Unknown Section 2 */adds some missing information to Unknown Section 2

''See [[MREA (File Format)]] for the other revisions of this format.''

The '''MREA format''' defines areas (rooms) in Metroid Prime 2. It serves the same purpose as the MREA files from Prime 1, but in Echoes it was updated with new features, including some new data sections and the ability to compress most of the data in the file.

{{todo|Rest of the article needs to be written. There's a lot known about this format that should be documented.}}

__TOC__

== Format ==

Like CMDL, MREA files are split up into a number of 32-byte aligned sections. Every section both starts and ends on a 32-byte boundary. These are used to separate different parts of the file; different types of sections typically indicate different sets of data. The header declares the section count and the size of each one; using these is the only way to navigate the file.

These are the sections in each MREA file, in the order they appear in the file:

{| class="wikitable"
! Identifier
! Name
|-
| {{none}}
| [[#World Geometry|World Geometry]]
|-
| {{none}}
| [[#Unknown Section 1|Unknown Section 1]]
|-
| <code>SCLY</code>
| [[Scriptable_Layers_(Metroid_Prime_2)|Script Layers]]
|-
| <code>SCGN</code>
| Generated Script Objects
|-
| <code>0xDEAFBABE</code>
| [[#Collision|Collision]]
|-
| {{none}}
| [[#MREA (Metroid Prime)#Unknown Section|Unknown Section 2]]
|-
| <code>0xBABEDEAD</code>
| Lights
|-
| <code>VISI</code>
| Visibility Tree
|-
| {{none}}
| [[#Path|Path]]
|-
| {{none}}
| [[#Portal Area|Portal Area]]
|-
| {{none}}
| [[#Static Geometry Map|Static Geometry Map]]
|}

=== Header ===

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Description
|-
| 0x0
| u32
| 1
| '''Magic'''
| Always <code>0xDEADBEEF</code>.
|-
| 0x4
| u32
| 1
| '''Version'''
| See [[MREA (File Format)|hub article]] for a list of possible version numbers.
|-
| 0x8
| float
| 12
| '''Area Transform'''
| Matrix that represents the area's transform from the origin. Most area data is pre-transformed, so this matrix is only used occasionally.
|-
| 0x38
| u32
| 1
| '''World Model Count'''
| Number of world models in this area.
|-
| 0x3C
| u32
| 1
| '''Script Layer Count'''
| Number of script layers in this area.
|-
| 0x40
| u32
| 1
| '''Data Section Count'''
| Number of data sections in the file.
|-
| 0x44
| u32
| 1
| '''Geometry Section'''
| Section index for world geometry data. Always 0; starts on materials.
|-
| 0x48
| u32
| 1
| '''Script Layers Section'''
| Section index for script layer data.
|-
| 0x4C
| u32
| 1
| '''Generated Script Objects Section'''
| Section index for generated script object data.
|-
| 0x50
| u32
| 1
| '''Collision Section'''
| Section index for collision data.
|-
| 0x54
| u32
| 1
| '''Unknown Section 1'''
| Section index for first unknown section.
|-
| 0x58
| u32
| 1
| '''Lights Section'''
| Section index for light data.
|-
| 0x5C
| u32
| 1
| '''Visibility Tree Section'''
| Section index for visibility tree data.
|-
| 0x60
| u32
| 1
| '''Path Section'''
| Section index for path data.
|-
| 0x64
| u32
| 1
| '''Unknown Section 2'''
| Section index for second unknown section.
|-
| 0x68
| u32
| 1
| '''Portal Area Section'''
| Section index for portal area data.
|-
| 0x6C
| u32
| 1
| '''Static Geometry Map Section'''
| Section index for static geometry map data.
|-
| 0x70
| u32
| 1
| '''Compressed Block Count'''
| Number of compressed data blocks in the file.
|-
| 0x74
| u32
| 3
| '''Padding'''
| Padding bytes that align the file with the next multiple-of-32 offset.
|-
| 0x80
| u32
| ''Data Section Count''
| '''Data Section Sizes'''
| Array containing the size of each data section in the file. Every size is always a multiple of 32.
|-
| colspan=5 {{unknown|Pad to 32 bytes before compressed block definitions begins}}
|}

==== Compressed Blocks ====

The MREA format contains compressed blocks that can each contain a number of regular file sections within them. The data defining these blocks is at the end of the MREA header; the beginning and end of the compressed block list is padded to 32 bytes. The decompressed size of a block is capped at 0x20000 bytes; each section contains as many MREA sections as it can fit under that size limit. There are two exceptions:

* If a single section's uncompressed size is larger than 0x20000, then its corresponding compressed block can exceed the size limit.
* Each SCLY and SCGN layer is always in its own block, regardless of how close to the limit it is.

This is the structure of each block definition:

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Notes
|-
| 0x0
| u32
| 1
| '''Buffer Size'''
| This is always 0x120 bytes larger than the uncompressed size on compressed bytes, and the same value as the uncompressed size on uncompressed blocks
|-
| 0x4
| u32
| 1
| '''Uncompressed Size'''
|
|-
| 0x8
| u32
| 1
| '''Compressed Size'''
| This is 0 on uncompressed blocks.
|-
| 0xC
| u32
| 1
| '''Data Section Count'''
| The number of regular data sections contained in this block.
|-
| 0x10
| colspan=5 {{unknown|Block definition end}}
|}

The actual data contained in these blocks is padded to 32 bytes, but their padding is located at the beginning of the block rather than the end, so it's required to account for the padding before you start decompressing. Thee data is compressed using segmented LZO1X-999; the "segmented" part means there's multiple segments of data that are compressed/decompressed separately. Each segment starts with a 16-bit size value. The size value is signed; a negative value indicates the segment is not compressed (this is done when compressing a segment doesn't reduce its size). Each segment is 0x4000 bytes large when decompressed (except the last one).

=== World Geometry ===
''See [[MREA (Metroid Prime)#World Geometry]], [[Materials (Metroid Prime)]] and [[Geometry (Metroid Prime)]]''

Largely [[MREA (Metroid Prime)#World Geometry|the same as Prime 1]]. There are two new sections to watch out for on each world model (described on the [[Geometry (Metroid Prime)]] page). There's two sections that are now grouped under the same section number as world geometry.

==== Area Octree ====

The [[MREA (Metroid Prime)#Area Octree|area octree]] section is back from Prime 1, but no longer has its own section number - it's now grouped under the same section number as world geometry.

==== Surface Group Bounding Boxes ====

This is a new section introduced in Metroid Prime 2, which is grouped under the world geometry section number and appears after the area octree. It contains an array of a structure that provides the bounding box for every surface group. The first entry in the array has the combined bounding box for all of the world geometry in the entire area, then each surface group is listed in order.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Group Bounds Entry Count'''
| Count of elements in the following array.
|-
| [[#Group Bounds|Group Bounds Entry]]
| ''Group Bounds Entry Count''
| '''Group Bounds Entry Array'''
| Array of a struct that provides the bounding box for each surface group in the area.
|}

===== Group Bounds Entry =====

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Notes
|-
| 0x0
| float
| 6
| '''Group Bounding Box'''
| Axis-aligned bounding box of all surfaces contained in the group.
|-
| 0x18
| u16
| 1
| '''World Model Index'''
| Index of the world model that contains this group.
|-
| 0x1A
| u16
| 1
| '''Surface Group Index'''
| Model-relative index of the surface group.
|-
| 0x1C
| u16
| 1
| {{unknown|Unknown}}
| On the first entry, always 1. On other entries, always -1.
|-
| 0x1E
| u16
| 1
| {{unknown|Unknown}}
| On the first entry, always -1. On other entries, always the entry's index position + 1.
|-
| 0x20
| colspan=4 {{unknown|End of bounds entry}}
|}

=== Unknown Section 2 ===

This section appears to be related to world geometry.

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Element Count 1'''
| Count of elements in the next array. Always 0 in light world areas.
|-
| u32
| ''Element Count 1''
| {{unknown|Unknown}}
| May also be a pair of u16s?
|-
| u32
| 1
| '''Element Count 2'''
| Count of elements in the next array. Matches the area's surface group count.
|-
| u8
| ''Element Count 2''
| {{unknown|Unknown}}
| Every entry is always 0xFF in light world areas. Dark world appears to include both 0x00 and 0xFF?
|-
| colspan=4 {{unknown|End of section}}
|}

=== Collision ===

''Main article: [[Area Collision (File Format)]]''

=== Path ===

This section only contains a single [[PATH (File Format)|PATH]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area PATH Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

=== Portal Area ===

This section only contains a single [[PTLA (File Format)|PTLA]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area PTLA Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

=== Static Geometry Map ===

This section only contains a single [[EGMC (File Format)|EGMC]] asset ID.

{| class="wikitable"
! Type
! Count
! Name
|-
| Asset ID
| 1
| '''Area EGMC Resource'''
|-
| colspan=3 {{unknown|End of section}}
|}

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