MLVL (File Format) - Revision history

Aruki: /* Area Dependencies */

2019-08-10T16:13:53Z

‎Area Dependencies

Aruki: /* Memory Relay */

2019-08-09T20:28:46Z

‎Memory Relay

Aruki: /* Format */

2019-02-05T07:16:46Z

‎Format

Aruki: /* Format */

2019-02-05T07:16:24Z

‎Format

Aruki: /* Area Dependencies */

2016-08-19T10:05:25Z

‎Area Dependencies

Aruki: /* Area */

2016-08-15T03:39:33Z

‎Area

Claris: Dock Count

2016-08-14T23:49:54Z

Dock Count

Claris: Internal Area Name

2016-08-14T23:29:38Z

Internal Area Name

Aruki: /* Connecting Dock */

2016-08-14T20:44:56Z

‎Connecting Dock

Aruki: /* Area */

2016-08-14T20:30:29Z

‎Area

@@ Line 522: / Line 522: @@
 ! Name
 ! Notes
 |-
 | u32

@@ Line 362: / Line 362: @@
 | Script message sent to the receiver object.
 |-
-| 0x10
+| 0xA
 | bool
 | '''Active'''
 | Whether this Memory Relay object is active by default; almost always 0.
 |-
-| 0x11
+| 0xB
 | colspan=3 {{unknown|End of Memory Relay connection}}
 |}

@@ Line 273: / Line 273: @@
 | u32
 | 1
-| '''Layer State ID Count'''
+| '''Layer GUID Count'''
-| Count of layer state IDs in the next array.
+| Count of layer GUIDs in the next array.
 | {{nocheck}}
 | {{nocheck}}
@@ Line 283: / Line 283: @@
 | ''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.
+| 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}}

@@ Line 280: / Line 280: @@
 | {{check}}
 |-
-| [[Saved State ID]]
+| [[GUID]]
-| ''Layer State ID Count''
+| ''Layer GUID Count''
-| '''Layer State ID Array'''
+| '''Layer GUID Array'''
-| Array of saved state IDs for each layer. These IDs are responsible for storing the layer's active state in the save file and are referenced by ScriptLayerController objects.
+| 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}}

@@ Line 509: / Line 509: @@
 This is a data chunk appearing in the area definition in Metroid Prime 1 and 2 that lists all assets needed to load the area. It's extremely important that this list be optimized and complete, as all assets listed here will be perpetually kept in memory as long as the area itself is in memory; the list also specifies the order that assets are loaded in, so '''it must be grouped by load order to roughly match the [[PAK (File Format)|PAK]] file for optimized load times'''. Assets that are missing will still be dynamically loaded after the area itself is loaded, but this will cause the game to freeze up until the load is finished. There are a few exceptions that are excluded from this list in the original game files (and should be excluded in custom MLVLs as well to avoid out-of-memory crashes):
-* [[SCAN (File Format)|SCAN]] files and their dependencies are not included in the list. These are loaded dynamically after the area itself is finished loading.
+* [[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.
-* [[ANCS (File Format)|ANCS]] per-character dependencies for PlayerActor script instances are not included; this allows the game to avoid keeping assets in memory for suits that the player doesn't have. The exception is the Empty Suit character (character index 5), which is a low-memory-overhead character that allows for the list to include all common assets that are stored in the file per-character (such as particle effects).
+* [[ANCS (File Format)|ANCS]] per-character dependencies for PlayerActor script instances are not included; this allows the game to avoid keeping assets in memory for suits that the player doesn't have. The exception is the Empty Suit character (character index 5 in MP1, and index 3 in MP2), which is a low-memory-overhead character that allows for the list to include all common assets that are stored in the file per-character (such as particle effects).
 * The skybox model and its dependencies are not included.

@@ Line 496: / Line 496: @@
 | 1
 | '''Internal Area Name'''
-| Internal name of this area. Only appears ingame if no Area Name ID is specified (although it will be prefixed with "!!").
+| 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}}

@@ Line 460: / Line 460: @@
 | 1
 | '''Dock Count'''
-| Count of Dock instances in this area. Should be equal to the attached area count.
+| Count of Dock instances in this area.
 | {{check}}
 | {{check}}

@@ Line 604: / Line 604: @@
 | '''Area Index'''
 | Index of the area this dock is in.
 |-
 | 0x4

@@ Line 397: / Line 397: @@
 | 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 array.
+| 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}}