BMD/BDL (File Format) - Revision history

Super Hackio: /* Index Buffer Formats */ Note about the matrix types

2026-06-01T18:44:35Z

Index Buffer Formats: Note about the matrix types

← Older revision		Revision as of 18:44, 1 June 2026
Line 500:		Line 500:
	\| 0x00000000 \|\| POSITION_MATRIX \|\| This is a direct list of indices into the Matrix Group's Weight collection. Required for Shapes that use Multiple Joint skinning.		\| 0x00000000 \|\| POSITION_MATRIX \|\| This is a direct list of indices into the Matrix Group's Weight collection. Required for Shapes that use Multiple Joint skinning.
	\|-		\|-
	\| 0x00000001 \|\| TEXTURE_0_MATRIX \|\| ''~~UNKNOWN~~''		\| 0x00000001 \|\| TEXTURE_0_MATRIX \|\| ''Uses the Direct type. Seems to break models that use it, and no official models in either galaxy game use it.''
	\|-		\|-
	\| 0x00000002 \|\| TEXTURE_1_MATRIX \|\| ''~~UNKNOWN~~''		\| 0x00000002 \|\| TEXTURE_1_MATRIX \|\| ''Uses the Direct type. Seems to break models that use it, and no official models in either galaxy game use it.''
	\|-		\|-
	\| 0x00000003 \|\| TEXTURE_2_MATRIX \|\| ''~~UNKNOWN~~''		\| 0x00000003 \|\| TEXTURE_2_MATRIX \|\| ''Uses the Direct type. Seems to break models that use it, and no official models in either galaxy game use it.''
	\|-		\|-
	\| 0x00000004 \|\| TEXTURE_3_MATRIX \|\| ''~~UNKNOWN~~''		\| 0x00000004 \|\| TEXTURE_3_MATRIX \|\| ''Uses the Direct type. Seems to break models that use it, and no official models in either galaxy game use it.''
	\|-		\|-
	\| 0x00000005 \|\| TEXTURE_4_MATRIX \|\| ''~~UNKNOWN~~''		\| 0x00000005 \|\| TEXTURE_4_MATRIX \|\| ''Uses the Direct type. Seems to break models that use it, and no official models in either galaxy game use it.''
	\|-		\|-
	\| 0x00000006 \|\| TEXTURE_5_MATRIX \|\| ''~~UNKNOWN~~''		\| 0x00000006 \|\| TEXTURE_5_MATRIX \|\| ''Uses the Direct type. Seems to break models that use it, and no official models in either galaxy game use it.''
	\|-		\|-
	\| 0x00000007 \|\| TEXTURE_6_MATRIX \|\| ''~~UNKNOWN~~''		\| 0x00000007 \|\| TEXTURE_6_MATRIX \|\| ''Uses the Direct type. Seems to break models that use it, and no official models in either galaxy game use it.''
	\|-		\|-
	\| 0x00000008 \|\| TEXTURE_7_MATRIX \|\| ''~~UNKNOWN~~''		\| 0x00000008 \|\| TEXTURE_7_MATRIX \|\| ''Uses the Direct type. Seems to break models that use it, and no official models in either galaxy game use it.''
	\|-		\|-
	\| 0x00000009 \|\| POSITION \|\| This indexes into the [[#VTX1_-_Vertex_Data\|VTX1]] "POSITION" buffer. Required.		\| 0x00000009 \|\| POSITION \|\| This indexes into the [[#VTX1_-_Vertex_Data\|VTX1]] "POSITION" buffer. Required.

Super Hackio: Prelimary MAT3 & MDL3 docs

2025-10-26T23:47:02Z

Prelimary MAT3 & MDL3 docs

← Older revision		Revision as of 23:47, 26 October 2025
Line 417:		Line 417:
	\| 0x10 \|\| Int32 \|\| Remap table offset		\| 0x10 \|\| Int32 \|\| Remap table offset
	\|-		\|-
	\| 0x14 \|\| Int32 \|\| Name table offset<br/>~~(Generally~~ not ~~used~~, ~~and thus set to 0)~~		\| 0x14 \|\| Int32 \|\| Name table offset<br/><small>0 if not present, which it usually isn't.</small>
	\|-		\|-
	\| 0x18 \|\| Int32 \|\| Vertex Index Attribute table offset		\| 0x18 \|\| Int32 \|\| Vertex Index Attribute table offset
Line 619:		Line 619:

	== MAT3 - Material List ==		== MAT3 - Material List ==
			Contains information for '''Mat'''erials to fill the rendered geometry with.

	== MDL3 - Display List ==		== MDL3 - Display List ==
			Contains raw material GX opcodes to speed up rendering.

	== TEX1 - Texture Data ==		== TEX1 - Texture Data ==

Super Hackio: EVP1

2025-10-26T21:29:59Z

EVP1

← Older revision		Revision as of 21:29, 26 October 2025
Line 270:		Line 270:
	\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)		\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)
	\|-		\|-
	\| 0x0C \|\| Int32 \|\| ~~"Joint Count" list~~ offset		\| 0x0C \|\| Int32 \|\| Envelope Size Table offset
	\|-		\|-
	\| 0x10 \|\| Int32 \|\| "'Joint ~~Count' list index" list~~ offset		\| 0x10 \|\| Int32 \|\| Envelope Joint Index Table offset
	\|-		\|-
	\| 0x14 \|\| Int32 \|\| ~~"Joint~~ Weight~~" list~~ offset		\| 0x14 \|\| Int32 \|\| Envelope Weight Table offset
	\|-		\|-
	\| 0x18 \|\| Int32 \|\| "Inverse Bind ~~Matrices" list~~ offset		\| 0x18 \|\| Int32 \|\| Inverse Bind Matrix Table offset
	\|}		\|}
			This section is padded to the nearest 32.

			=== Envelope Size Table ===
			This table simply consists of an array of UInt8, where each value dictates how many entries are in a given Envelope.

			=== Envelope Joint Index Table ===
			This table consists of the actual [[#JNT1_-_Joint_Hierarchy\|JNT1]] index values. Each value is a UInt16, and are ordered directly based on the Envelope Size Table. (The first Envelope's values come directly after each other, then the second envelope's values, etc.)

			=== Envelope Weight Table ===
			This table consists of joint weighting values which determine how much of an effect the given Joint Index has on this envelope. Each value is a Float, and are ordered directly based on the Envelope Size Table. (The first Envelope's values come directly after each other, then the second envelope's values, etc.)

			This table ends with padding to the nearest 4th byte so the Floats that come after are aligned correctly.

			=== Inverse Bind Matrix Table ===
			This table contains Inverse Bind Matrices for each joint in [[#JNT1_-_Joint_Hierarchy\|JNT1]]. The EVP1 section itself contains no size of this table, but the number of Inverse Bind Matrices is always equal to the amount of Joints in the model.<br/>Each entry is a 3 Row 4 Column Matrix (Mtx34), and is stored as 3 Vector4 values.

	== DRW1 - Skinning Assignments ==		== DRW1 - Skinning Assignments ==

Super Hackio: Add DRW1

2025-10-26T01:20:08Z

Add DRW1

← Older revision		Revision as of 01:20, 26 October 2025
Line 280:		Line 280:

	== DRW1 - Skinning Assignments ==		== DRW1 - Skinning Assignments ==
			This section contains a map which redirects skinning information to the correct location: either JNT1 (Single Matrix) or EVP1 (Multi-Matrix)<br/>The Destination Type list and Destination ID list must be equal in length.
			{\| class="wikitable"
			\|-
			! Offset !! Type !! Description
			\|-
			\| 0x00 \|\| String \|\| Always '''DRW1''' (ASCII)
			\|-
			\| 0x04 \|\| Int32 \|\| The total size of this chunk
			\|-
			\| 0x08 \|\| Int16 \|\| The number of Entries stored.
			\|-
			\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)
			\|-
			\| 0x0C \|\| Int32 \|\| Destination Type list offset
			\|-
			\| 0x10 \|\| Int32 \|\| Destination ID list offset
			\|}

			=== Destination Type List ===
			This is an array of bytes that dictates the destination type. It is ordered so that all the '''Joint'''s come first, and all the '''Envelope'''s second.
			{\| class="wikitable"
			\|-
			! Value !! Name !! Description
			\|-
			\| 0x00 \|\| Joint \|\| Redirects to a Joint within [[#JNT1_-_Joint_Hierarchy\|JNT1]]
			\|-
			\| 0x01 \|\| Envelope \|\| Redirects to an Envelope in [[#EVP1_-_Skinning_Envelopes\|EVP1]]
			\|}
			It's worth noting that Nintendo's development tools had a bug in it where all the '''Envelope''' entries were duplicated. Some JSystem games do not care about this, but certain games try to explicitly ignore this data, and therefore require the wasteful duplicate data.

			=== Destination ID List ===
			This is an array of UInt16 that simply dictate an index into the provided section.

			DRW1 ends with padding to the nearest 32.

	== JNT1 - Joint Hierarchy ==		== JNT1 - Joint Hierarchy ==

Super Hackio: /* Primitive Data */ Turns out you need to pad the primitive collections

2025-10-26T00:43:51Z

Primitive Data: Turns out you need to pad the primitive collections

← Older revision		Revision as of 00:43, 26 October 2025
Line 537:		Line 537:
	\| 0x04 \|\| Int16 \|\| Vertex Count		\| 0x04 \|\| Int16 \|\| Vertex Count
	\|}		\|}
	Each Matrix Group's ~~primitives are~~ padded to the nearest 32.		Each Matrix Group's primitive collection MUST be padded to the nearest 32. The game dies if you don't.
	~~<small>TODO: Figure out~~ if ~~the padding is allowed to be omitted~~.~~</small>~~

	=== Matrix Group Definition Table ===		=== Matrix Group Definition Table ===

Super Hackio: /* JNT1 - Joint Hierarchy */ Fix formatting on the last minor edit

2025-10-25T23:36:27Z

JNT1 - Joint Hierarchy: Fix formatting on the last minor edit

← Older revision		Revision as of 23:36, 25 October 2025
Line 299:		Line 299:
	\| 0x10 \|\| Int32 \|\| Remap table offset		\| 0x10 \|\| Int32 \|\| Remap table offset
	\|-		\|-
	\| 0x14 \|\| Int32 \|\| Name table offset<b/>0 if not present.		\| 0x14 \|\| Int32 \|\| Name table offset<br/><small>0 if not present.</small>
	\|}		\|}

Super Hackio: Joint Name Table can be excluded from the file

2025-10-25T23:35:32Z

Joint Name Table can be excluded from the file

← Older revision		Revision as of 23:35, 25 October 2025
Line 299:		Line 299:
	\| 0x10 \|\| Int32 \|\| Remap table offset		\| 0x10 \|\| Int32 \|\| Remap table offset
	\|-		\|-
	\| 0x14 \|\| Int32 \|\| Name table offset		\| 0x14 \|\| Int32 \|\| Name table offset<b/>0 if not present.
	\|}		\|}

Super Hackio: INF1 - Fixed notes on the Matrix Group Data count and Vertex count.

2025-10-22T22:54:36Z

INF1 - Fixed notes on the Matrix Group Data count and Vertex count.

← Older revision		Revision as of 22:54, 22 October 2025
Line 45:		Line 45:
	\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)		\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)
	\|-		\|-
	\| 0x0C \|\| Int32 \|\| Matrix Group Data Count<br/>Referring to the Matrix Group Data in [[#SHP1_-_Shape_Information\|SHP1]]<br/><small>~~Ignored~~ by the game~~. Seems~~ to ~~only be informative~~.</small>		\| 0x0C \|\| Int32 \|\| Matrix Group Data Count<br/>Referring to the Matrix Group Data in [[#SHP1_-_Shape_Information\|SHP1]]<br/><small>Stored in a variable by the game, but not used to dictate the actual number of Matrix Groups.</small>
	\|-		\|-
	\| 0x10 \|\| Int32 \|\| Vertex Count<br/>Always equals the number of entries in the [[#VTX1_-_Vertex_Data\|VTX1]] "POSITION" [[#Vertex%20Buffer%20Formats\|data buffer]]<br/><small>~~Ignored~~ by the game. ~~Seems to only be informative~~.</small>		\| 0x10 \|\| Int32 \|\| Vertex Count<br/>Always equals the number of entries in the [[#VTX1_-_Vertex_Data\|VTX1]] "POSITION" [[#Vertex%20Buffer%20Formats\|data buffer]]<br/><small>Stored in a variable by the game, but never used for anything. The game reads Vertex Data directly from the [[#Vertex%20Buffer%20Formats\|data buffer]]s without bounds checking.</small>
	\|-		\|-
	\| 0x14 \|\| Int32 \|\| Relative offset to the [[#Scene%20Hierarchy\|Scene Hierarchy]]		\| 0x14 \|\| Int32 \|\| Relative offset to the [[#Scene%20Hierarchy\|Scene Hierarchy]]

Super Hackio: INF1 - Matrix Group Count and POSITION data buffer sizes are purely informative and ignored by the game upon load.

2025-10-22T22:25:31Z

INF1 - Matrix Group Count and POSITION data buffer sizes are purely informative and ignored by the game upon load.

← Older revision		Revision as of 22:25, 22 October 2025
Line 45:		Line 45:
	\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)		\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)
	\|-		\|-
	\| 0x0C \|\| Int32 \|\| Matrix Group Data Count<br/>Referring to the Matrix Group Data in [[#SHP1_-_Shape_Information\|SHP1]]		\| 0x0C \|\| Int32 \|\| Matrix Group Data Count<br/>Referring to the Matrix Group Data in [[#SHP1_-_Shape_Information\|SHP1]]<br/><small>Ignored by the game. Seems to only be informative.</small>
	\|-		\|-
	\| 0x10 \|\| Int32 \|\| Vertex Count<br/>Always equals the number of entries in the "POSITION" [[#Vertex%20Buffer%20Formats\|data buffer]]		\| 0x10 \|\| Int32 \|\| Vertex Count<br/>Always equals the number of entries in the [[#VTX1_-_Vertex_Data\|VTX1]] "POSITION" [[#Vertex%20Buffer%20Formats\|data buffer]]<br/><small>Ignored by the game. Seems to only be informative.</small>
	\|-		\|-
	\| 0x14 \|\| Int32 \|\| Relative offset to the [[#Scene%20Hierarchy\|Scene Hierarchy]]		\| 0x14 \|\| Int32 \|\| Relative offset to the [[#Scene%20Hierarchy\|Scene Hierarchy]]

Super Hackio: Labelled INF1 section value to be related to SHP1

2025-10-22T21:35:43Z

Labelled INF1 section value to be related to SHP1

← Older revision		Revision as of 21:35, 22 October 2025
Line 45:		Line 45:
	\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)		\| 0x0A \|\| Int16 \|\| Padding (0xFFFF)
	\|-		\|-
	\| 0x0C \|\| Int32 \|\| Matrix Group Count		\| 0x0C \|\| Int32 \|\| Matrix Group Data Count<br/>Referring to the Matrix Group Data in [[#SHP1_-_Shape_Information\|SHP1]]
	\|-		\|-
	\| 0x10 \|\| Int32 \|\| Vertex Count<br/>Always equals the number of entries in the "POSITION" [[#Vertex%20Buffer%20Formats\|data buffer]]		\| 0x10 \|\| Int32 \|\| Vertex Count<br/>Always equals the number of entries in the "POSITION" [[#Vertex%20Buffer%20Formats\|data buffer]]