VTXG: Fix luigi entry link

2025-08-13T23:39:49Z

Fix luigi entry link

← Older revision		Revision as of 23:39, 13 August 2025
Line 56:		Line 56:
	\|-		\|-
	\|<code>luigi1</code> - <code>luigi6</code>		\|<code>luigi1</code> - <code>luigi6</code>
	\|[[GameData#~~Player~~ Save Data\|User Save Data]]. (Luigi)		\|[[GameData#User Save Data\|User Save Data]]. (Luigi)
	\|-		\|-
	\|<code>config1</code> - <code>config6</code>		\|<code>config1</code> - <code>config6</code>

VTXG: Add

2025-08-13T23:20:03Z

Add

Show changes

VTXG: Created page with "{{WIP}} In Super Mario Galaxy, save data is stored on the Wii's NAND, inside the file `GameData.bin`. == SMG1 == The file starts with a 16-byte long header. {| class="wikitable" !Offset !Size !Name !Description |- |0x0 |4 |Checksum |A checksum of the file's contents. |- |0x4 |4 |Version |Always 2. |- |0x8 |4 |Save Entry Count |The number of save entries inside this file. In SMG1, this value is 19. |- |0xC |4 |File Size |The size of this file, in bytes. |} Thi..."

2025-08-13T18:47:30Z

Created page with "{{WIP}} In Super Mario Galaxy, save data is stored on the Wii's NAND, inside the file <code>GameData.bin</code>. == SMG1 == The file starts with a 16-byte long header. {| class="wikitable" !Offset !Size !Name !Description |- |0x0 |4 |Checksum |A checksum of the file's contents. |- |0x4 |4 |Version |Always 2. |- |0x8 |4 |Save Entry Count |The number of save entries inside this file. In SMG1, this value is 19. |- |0xC |4 |File Size |The size of this file, in bytes. |} Thi..."

New page

{{WIP}}
In Super Mario Galaxy, save data is stored on the Wii's NAND, inside the file <code>GameData.bin</code>.

== SMG1 ==
The file starts with a 16-byte long header.
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|4
|Checksum
|A checksum of the file's contents.
|-
|0x4
|4
|Version
|Always 2.
|-
|0x8
|4
|Save Entry Count
|The number of save entries inside this file. In SMG1, this value is 19.
|-
|0xC
|4
|File Size
|The size of this file, in bytes.
|}
This is followed up by a list of entry headers, each one with this structure:
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|12
|Name
|The name of this entry.
|-
|0xC
|4
|Offset
|The offset to this entry's data.
|}
In SMG1, the following entries can be found:
{| class="wikitable"
!Name
!Description
|-
|<code>mario1</code> - <code>mario6</code>
|Mario save data.
|-
|<code>luigi1</code> - <code>luigi6</code>
|Luigi save data.
|-
|<code>config1</code> - <code>config6</code>
|Config save data shared between <code>mario</code> and <code>luigi</code> data.
|-
|<code>sysconf</code>
|Game save data shared across all save entries.
|}

== <code>mario</code>/<code>luigi</code> Data ==
The data starts with a '''Binary Chunk Holder Header''' with the following values:
{| class="wikitable"
!Name
!Value
!Notes
|-
|Unknown
|1
|
|-
|Chunk Count
|6
|
|}

=== GameDataPlayerStatus Section ===
This section stores information about the story progress, the star bit count, and the life count. 
This section starts with a '''Binary Chunk Header''' with the following values:
{| class="wikitable"
!Name
!Value
!Notes
|-
|Signature
|<code>PLAY</code>
|
|-
|Hash
|<code>0x27C90F</code>
|Unknown hash.
|-
|Size
|19
|
|}
The actual data is structured as follows:
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|1
|Story Progress
|The story progress value. Corresponds to the <code>progress</code>value of [[Progress checks#Unlabeled Table 1|Unlabeled Table 1]].
|-
|0x1
|4
|Star Bit Count
|The number of star bits owned.
|-
|0x5
|2
|Life Remaining
|The player's life count.
|}
'''NOTE:''' The <code>Life Remaining</code> value is not used to set the mario's life count, but is instead used for 1-Up mail calculation. (This needs more research)

=== GameEventFlagStorage Section ===
This section stores game event flags. A complete list of events can be found in the [[Progress checks#GameEventFlagTable|Progress Checks page]]. 
This section starts with a '''Binary Chunk Header''' with the following values:
{| class="wikitable"
!Name
!Value
!Notes
|-
|Signature
|<code>FLG1</code>
|
|-
|Hash
|<code>0x65020442</code>
|Hash code of the string "2bytes/flag"
|-
|Size
|126
|
|}
This section's data is made up of multiple 2-byte numbers:
{| class="wikitable"
!Offset
!Bit Count
!Name
!Description
|-
|0
|1
|Value
|If this flag is enabled or not.
|-
|1
|15
|Hash
|A shortened hash code of the flag's name.
|}

=== StarPieceAlmsStorage Section ===
This section stores information about hungry lumas. 
This section starts with a '''Binary Chunk Header''' with the following values:
{| class="wikitable"
!Name
!Value
!Notes
|-
|Signature
|<code>PCE1</code>
|
|-
|Hash
|<code>0xF5DE1DC0</code>
|Hash code of the string "StarPieceAlmsStorage" multiplied by 32.
|-
|Size
|44
|
|}
The data is an array of 16 2-byte values, each one corresponding to the amount of star bits fed to hungry lumas. 
<code>TicoFat</code> and <code>TicoGalaxy</code> use their <code>Obj_arg7</code> to indicate what index they get/set their star bit count from, although <code>TicoGalaxy</code> uses <code>Obj_arg7</code> + 8 for the index. 
Due to <code>TicoFat</code> and <code>TicoGalaxy</code> having 7 occurrences each, this means that the values at index 7 and 15 go unused. 
Furthermore, due to the<code>TicoFat</code> in <code>StarEggRoadZone</code> having an <code>Obj_arg7</code> of -1, index 0 also goes unused.

=== SpinDriverPathStorage Section ===
This section stores information about launch star paths. 
This section starts with a '''Binary Chunk Header''' with the following values:
{| class="wikitable"
!Name
!Value
!Notes
|-
|Signature
|<code>SPN1</code>
|
|-
|Hash
|<code>0x12345679</code>
|Unknown hash.
|-
|Size
|998
|
|}
Todo.

=== GameEventValueStorage Section ===
This section stores game event values. A complete list of events can be found in the [[Progress checks#GameEventValueTable|Progress Checks page]]. 
This section starts with a '''Binary Chunk Header''' with the following values:
{| class="wikitable"
!Name
!Value
!Notes
|-
|Signature
|<code>VLE1</code>
|
|-
|Hash
|<code>0x564C4531</code>
|The string "VLE1".
|-
|Size
|112
|
|}
This section's data is made up of key-value pairs:
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|2
|Hash
|The hash of the event's name.
|-
|0x1
|2
|Value
|The value of this event.
|}

=== GameDataAllGalaxyStorage Section ===
This section stores galaxy information, such as the collected power stars. 
This section starts with a '''Binary Chunk Header''' with the following values:
{| class="wikitable"
!Name
!Value
!Notes
|-
|Signature
|<code>GALA</code>
|
|-
|Hash
|<code>0xBF0640EE</code>
|Unknown hash.
|-
|Size
|874
|
|}
This section uses the '''Binary Data Content''' system to write its data. 
This section starts with a galaxy count:
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|2
|Galaxy Count
|The number of galaxies. In SMG1, this value is 42.
|}
Followed by a Binary Data Content header:
{| class="wikitable"
!Name
!Value
!Notes
|-
|Attribute Count
|4
|
|-
|Data Size
|20
|
|}
The Binary Data Content contains the following attributes:
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|2
|<code>mGalaxyName</code>
|The name of the galaxy.
|-
|0x2
|1
|<code>mPowerStarFlag</code>
|The power star collection flags. Each bit corresponds to a power star.
|-
|0x3
|1
|<code>mFirstPlayFlag</code>
|Todo.
|-
|0x4
|16
|<code>mMaxCoinNum</code>
|Todo.
|}

== SMG2 ==
Todo.

== Binary Chunk System ==
To write save entry data, a system was created to read, write, and manage writing sub-sections of the data.

=== Binary Chunk Holder Header ===
A 4-byte header used throughout all save entries.
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|1
|Unknown
|Always 1.
|-
|0x1
|1
|Chunk Count
|The number of chunks in the data.
|-
|0x2
|2
|Padding
|
|}

=== Binary Chunk Header ===
A 12-byte header used for identifying the sub-sections of data.
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|4
|Signature
|A 4-byte long ASCII string
|-
|0x4
|4
|Hash
|An additional identifier for the chunk.
|-
|0x8
|4
|Size
|The size of this chunk, in bytes, from the start of this header.
|}
'''NOTE:''' The <code>Hash</code> value is not always a hash code, as some chunks simply use 1 as the value.

=== Binary Data Content ===
The save file's dynamic data serialization system. The data starts with a 8-byte long header.
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|2
|Attribute Count
|The number of attributes in the data structure.
|-
|0x2
|2
|Data Size
|The size of the data structure.
|}
This is followed by multiple attribute headers.
{| class="wikitable"
!Offset
!Size
!Name
!Description
|-
|0x0
|2
|Hash
|The hash of the attribute's name.
|-
|0x2
|2
|Offset
|The offset from the start of the data structure.
|}
As for the data, its structure is dinamically created by the attributes. Furthermore, multiple data structures can be written to the data buffer.

== Tools ==

* TKSaveEditor - A currently WIP tool by VTXG.

GameData - Revision history

VTXG: Fix luigi entry link

VTXG: Add