Data Toolbox - Revision history

End User at 23:43, 29 October 2025

2025-10-29T23:43:44Z

← Older revision		Revision as of 23:43, 29 October 2025
Line 315:		Line 315:
	\|Snowboard animations (Sonic)		\|Snowboard animations (Sonic)
	\|}		\|}

			{{SAToolsNavbox}}
	[[Category:SA1 tools]]		[[Category:SA1 tools]]
	[[Category:SA2 tools]]		[[Category:SA2 tools]]
	[[Category:General tools]]		[[Category:General tools]]

PkR at 07:11, 3 October 2025

2025-10-03T07:11:20Z

← Older revision		Revision as of 07:11, 3 October 2025
Line 3:		Line 3:
	= Using Data Toolbox =		= Using Data Toolbox =
	The main window has a tab control, with each tab being a different tool. The following settings are shared across multiple tools:		The main window has a tab control, with each tab being a different tool. The following settings are shared across multiple tools:
	* ''Offset'' or ''Data Offset'' is the number of bytes trimmed from the beginning of the binary file. At the moment it is only needed for the [[SADX X360 prototype with symbols\|X360 version with symbols]], where the offset is 0xC800.		* <code>Offset</code> or <code>Data Offset</code> is the number of bytes trimmed from the beginning of the binary file. At the moment it is only needed for the [[SADX X360 prototype with symbols\|X360 version with symbols]], where the offset is <code>0xC800</code>.
	* [[Ninja ASCII]] is an alternative way to export models and animations (motions and actions) as C structs. It outputs NJA/NAM files like in the [[Dreamcast SDK]].		* [[Ninja ASCII]] is an alternative way to export models and animations (motions and actions) as C structs. It outputs NJA/NAM files like in the [[Dreamcast SDK]].

PkR at 03:22, 3 October 2025

2025-10-03T03:22:03Z

← Older revision		Revision as of 03:22, 3 October 2025
Line 315:		Line 315:
	\|Snowboard animations (Sonic)		\|Snowboard animations (Sonic)
	\|}		\|}
			[[Category:SA1 tools]]
			[[Category:SA2 tools]]
			[[Category:General tools]]

PkR at 14:40, 2 October 2025

2025-10-02T14:40:58Z

PkR at 12:37, 2 October 2025

2025-10-02T12:37:58Z

← Older revision		Revision as of 12:37, 2 October 2025
Line 23:		Line 23:
	The <code>Labels</code> combo box lets you configure labels in [[SAModel]] files:		The <code>Labels</code> combo box lets you configure labels in [[SAModel]] files:

	* <code>Address-based labels</code> will name items by their address, e.g. <code>~~object''0014AC3C''~~</code>'' for an <code>~~NJS''OBJECT</code>~~ located at 0x0014AC3C.		* <code>Address-based labels</code> will name items by their address, e.g. <code>object_0014AC3C</code> for an <code>NJS_OBJECT located at 0x0014AC3C.
	* <code>Full labels</code> will name items using a label database. We have labels for the X360 prototype (<code>SonicApp.exe</code> only) and partial labels for <code>sonic.exe</code> in the 2004 PC port. When labels aren't found in the database, address-based labels will be used instead.		* <code>Full labels</code> will name items using a label database. We have labels for the X360 prototype (<code>SonicApp.exe</code> only) and partial labels for <code>sonic.exe</code> in the 2004 PC port. When labels aren't found in the database, address-based labels will be used instead.
	* <code>No labels</code> will strip all metadata from the files. This will reduce their size but item names will be based on the item's location in the model file, not the original binary file.		* <code>No labels</code> will strip all metadata from the files. This will reduce their size but item names will be based on the item's location in the model file, not the original binary file.
Line 72:		Line 72:
	\|-		\|-
	\| <code>ADV01MODELS.DLL</code>		\| <code>ADV01MODELS.DLL</code>
	\| Egg Carrier \(outside\) level models and objects		\| Egg Carrier (outside) level models and objects
	\|-		\|-
	\| <code>ADV01CMODELS.DLL</code>		\| <code>ADV01CMODELS.DLL</code>
	\| Egg Carrier \(inside\) level models and objects		\| Egg Carrier (inside) level models and objects
	\|-		\|-
	\| <code>ADV02MODELS.DLL</code>		\| <code>ADV02MODELS.DLL</code>
Line 90:		Line 90:
	\|-		\|-
	\| <code>CHAOSTGGARDEN02MR_DAYTIME.DLL</code>		\| <code>CHAOSTGGARDEN02MR_DAYTIME.DLL</code>
	\| Mystic Ruins Garden \(Day\) level model		\| Mystic Ruins Garden (Day) level model
	\|-		\|-
	\| <code>CHAOSTGGARDEN02MR_EVENING.DLL</code>		\| <code>CHAOSTGGARDEN02MR_EVENING.DLL</code>
	\| Mystic Ruins Garden \(Evening\) level model		\| Mystic Ruins Garden (Evening) level model
	\|-		\|-
	\| <code>CHAOSTGGARDEN02MR_NIGHT.DLL</code>		\| <code>CHAOSTGGARDEN02MR_NIGHT.DLL</code>
	\| Mystic Ruins Garden \(Night\) level model		\| Mystic Ruins Garden (Night) level model
	\|}		\|}
	Everything else is in <code>sonic.exe</code>.		Everything else is in <code>sonic.exe</code>.
Line 102:		Line 102:
	== Model Locations in SA1 (Dreamcast) ==		== Model Locations in SA1 (Dreamcast) ==
	The Dreamcast version is a little easier to look through than the PC port because each stage is compiled into a separate binary. Character models, common objects, badniks etc. are located in <code>1ST_READ.BIN</code>, key <code>8C010000</code>. Stage-specific objects use the corresponding stage binary.		The Dreamcast version is a little easier to look through than the PC port because each stage is compiled into a separate binary. Character models, common objects, badniks etc. are located in <code>1ST_READ.BIN</code>, key <code>8C010000</code>. Stage-specific objects use the corresponding stage binary.
	All binaries except <code>1ST_READ.BIN</code> are PRS compressed. The following stage files are used:		All binaries except <code>1ST_READ.BIN</code> are [[PRS]] compressed. The following stage files are used:

	=== Action Stages ("STG" Files) ===		=== Action Stages ("STG" Files) ===
Line 172:		Line 172:
	\| ADV0100		\| ADV0100
	\| C920000		\| C920000
	\| Egg Carrier \(outside\)		\| Egg Carrier (outside)
	\|-		\|-
	\| ADV0130		\| ADV0130
	\| C920000		\| C920000
	\| Egg Carrier \(inside\)		\| Egg Carrier (inside)
	\|-		\|-
	\| ADV02		\| ADV02
Line 184:		Line 184:
	\| ADV03		\| ADV03
	\| C900000		\| C900000
	\| Mystic Ruins \(Past\)		\| Mystic Ruins (Past)
	\|}		\|}
	=== Bosses ("B" Files) ===		=== Bosses ("B" Files) ===

PkR at 12:35, 2 October 2025

2025-10-02T12:35:48Z

Show changes

PkR: Created page with "Data Toolbox is a set of tools to work with [https://github.com/X-Hax/sa_tools/wiki/Working-with-Binary-Files binary files]. = Table of Contents = * [#using-data-toolbox Using Data Toolbox] * [#binary-data-extractor Binary Data Extractor] * [#struct-converter Struct Converter] * [#split Split] * [#splitmdl SplitMDL] * [#scanner Scanner] * [#label-tool Label Tool] * [#data-locations Data Locations] * [#model-locations-in-sadx-pc-2004 Model Locations in SADX (PC, 2004)] *..."

2025-10-02T12:22:52Z

Created page with "Data Toolbox is a set of tools to work with [https://github.com/X-Hax/sa_tools/wiki/Working-with-Binary-Files binary files]. = Table of Contents = * [#using-data-toolbox Using Data Toolbox] * [#binary-data-extractor Binary Data Extractor] * [#struct-converter Struct Converter] * [#split Split] * [#splitmdl SplitMDL] * [#scanner Scanner] * [#label-tool Label Tool] * [#data-locations Data Locations] * [#model-locations-in-sadx-pc-2004 Model Locations in SADX (PC, 2004)] *..."

New page

Data Toolbox is a set of tools to work with [https://github.com/X-Hax/sa_tools/wiki/Working-with-Binary-Files binary files].

= Table of Contents =
* [#using-data-toolbox Using Data Toolbox]
* [#binary-data-extractor Binary Data Extractor]
* [#struct-converter Struct Converter]
* [#split Split]
* [#splitmdl SplitMDL]
* [#scanner Scanner]
* [#label-tool Label Tool]
* [#data-locations Data Locations]
* [#model-locations-in-sadx-pc-2004 Model Locations in SADX (PC, 2004)]
* [#model-locations-in-sa1-dreamcast Model Locations in SA1 (Dreamcast)]

= Using Data Toolbox =
The main window has a tab cotrol. Each tab is a different tool. The following settings are shared across multiple tools:
* Offset/Data Offset is the number of bytes trimmed from the beginning of the binary file. At the moment it is only needed for the X360 version, where the offset is 0xC800.
* Ninja ASCII is an alternative way to export models and animations (motions and actions) as C structs. It outputs NJA/NAM files like in the Dreamcast SDK.

== Binary Data Extractor ==
This tool lets you extract a single data item (level, model or action) from a binary file.

![https://github.com/sonicretro/sa_tools/wiki/images/DataToolbox/binary.png Binary Data Extractor]
* <code>Address</code> is the location of the item in the file. The <code>Memory Address</code> checkbox lets you use the memory pointer (key + actual address in the file) instead.

== Struct Converter ==
This tool lets you convert levels, models and animations to C structs. Models and animations can also be exported as Ninja ASCII, and animations can be exported as JSON. You can use drag-and-drop to add files to the list.

![https://github.com/sonicretro/sa_tools/wiki/images/DataToolbox/struct.png Struct Converter]

== Split ==
This tool lets you extract data from a single binary file based on a template supplied with SA Tools. Select the base template and add files to split. You can use drag-and-drop to add files to the list.

![https://github.com/sonicretro/sa_tools/wiki/images/DataToolbox/split.png Split]
* The <code>Labels</code> combo box lets you configure labels in SAModel files:
1) <code>Address-based labels</code> will name items by their address, e.g. <code>object''0014AC3C</code> for an <code>NJS''OBJECT</code> located at 0x0014AC3C.
2) <code>Full labels</code> will name items using a label database. We have labels for the X360 prototype (<code>SonicApp.exe</code> only) and partial labels for <code>sonic.exe</code> in the 2004 PC port. When labels aren't found in the database, address-based labels will be used instead.
3) <code>No labels</code> will strip all metadata from the files. This will reduce their size but item names will be based on the item's location in the model file, not the original binary file.

== SplitMDL ==
This tool lets you extract data from SA2/SA2B ''MDL and ''MTN files.

![https://github.com/sonicretro/sa_tools/wiki/images/DataToolbox/splitmdl.png SplitMDL]

== Scanner ==
This tool lets you scan through a binary file to find different types of data in it.

![https://github.com/sonicretro/sa_tools/wiki/images/DataToolbox/scanner.png Scanner]
* The <code>Base Game</code> combo box sets game-specific settings such as landtable format, reversed color order for SADX Gamecube or Endianness.
* <code>Start Address</code> and <code>End Address</code> can be used if you want to scan a specific section in the file.
* <code>Skip Metadata</code> will strip all metadata from the files. This will reduce their size but item names will be based on the item's location in the model file, not the original binary file.
* When the <code>Keep Level Models</code> checkbox is checked, the scanner will not delete models found to be part of a Landtable.
* When the <code>Keep Child Models</code> checkbox is checked, the scanner will not delete models found to be part of another model.
* The <code>Basic+ Models</code> checkbox makes the Basic model scanner look for Basic+ models (SADX PC/SADX X360) instead of regular Basic models (SA1 DC, SADX Gamecube).
* <code>Simple Scan</code> uses a less strict check to determine whether model data is valid.
* <code>Short Rotation</code> treats rotation value in Motions as <code>short</code> instead of <code>int</code>. Some Chao animations use this.
* The <code>Nodes</code> numberic box lets you set the minimum number of nodes to scan for in motions. Motions with less nodes will be discarded. Set the value to 0 to find all motions.
* In <code>Find Model</code> mode, the scanner will scan for models similar to the input model. At the moment only Basic and Basic+ models are supported.

See [#data-locations Data Locations] on how to find data in binary files.

== Label Tool ==
This tool lets you import and export labels embedded into SAModel files using external <code>.salabel</code> files.
![https://github.com/sonicretro/sa_tools/wiki/images/DataToolbox/label.png LabelTool]
* The <code>Export Labels</code> radio button makes the tool save all embedded labels to <code>.salabel</code> files.
* Cheking the <code>Erase Internal Labels</code> checkbox will make the tool clear embedded labels after exporting them. This can be used to reduce the size of SAModel files.
* The <code>Import Labels</code> radio button overwrites embedded labels in SAModel files with labels found in <code>.salabel</code> files.
* Checking the <code>Delete Label Files</code> checkbox will make the tool remove the <code>.salabel</code> files after reading labels from them.

= Data Locations =
== Model Locations in SADX (PC, 2004) ==
Unlike many other games that store models in special archives or as separate files, Sonic Adventure has levels and models compiled directly into the game's code. This carried over to the ports too, and the file structure is different depending on the version of the game. In the 2004 PC port, the majority of levels and models are in <code>sonic.exe</code>, but some assets are also stored in DLL files in the <code>system</code> folder. If you're looking for something specific you need to know which file it is, so first let's have a look at the file structure.

=== DLLs in the <code>system</code> Folder ===
{| class="wikitable"
|-
! File
! Contents
|-
| <code>ADV00MODELS.DLL</code>
| Station Square level and NPC models
|-
| <code>ADV01MODELS.DLL</code>
| Egg Carrier \(outside\) level models and objects
|-
| <code>ADV01CMODELS.DLL</code>
| Egg Carrier \(inside\) level models and objects
|-
| <code>ADV02MODELS.DLL</code>
| Mystic Ruins level models and objects
|-
| <code>ADV03MODELS.DLL</code>
| Mystic Ruins Past level models, objects and NPCs
|-
| <code>BOSSCHAOS0MODELS.DLL</code>
| Chaos 0 boss, Chaos 0 level model and some objects
|-
| <code>CHRMODELS_orig.DLL</code>
| Playable characters
|-
| <code>CHAOSTGGARDEN02MR_DAYTIME.DLL</code>
| Mystic Ruins Garden \(Day\) level model
|-
| <code>CHAOSTGGARDEN02MR_EVENING.DLL</code>
| Mystic Ruins Garden \(Evening\) level model
|-
| <code>CHAOSTGGARDEN02MR_NIGHT.DLL</code>
| Mystic Ruins Garden \(Night\) level model
|}
Everything else is in <code>sonic.exe</code>.

== Model Locations in SA1 (Dreamcast) ==
The Dreamcast version is a little easier to look through than the PC port because each stage is compiled into a separate binary. Character models, common objects, badniks etc. are located in <code>1ST_READ.BIN</code>, key <code>8C010000</code>. Stage-specific objects use the corresponding stage binary.
All binaries except <code>1ST_READ.BIN</code> are PRS compressed. The following stage files are used:

=== Action Stages ("STG" Files) ===
{| class="wikitable"
|-
! Filename
! Key
! Description
|-
| STG00
| C900000
| Hedgehog Hammer
|-
| STG01
| C900000
| Emerald Coast
|-
| STG02
| C900000
| Windy Valley
|-
| STG03
| C900000
| Twinkle Park
|-
| STG04
| C900000
| Speed Highway
|-
| STG05
| C900000
| Red Mountain
|-
| STG06
| C900000
| Sky Deck
|-
| STG07
| C900000
| Lost World
|-
| STG08
| C900000
| Ice Cap
|-
| STG09
| C900000
| Casinopolis
|-
| STG10
| C900000
| Final Egg
|-
| STG12
| C900000
| Hot Shelter
|}
=== Adventure Fields ("ADV" Files) ===
{| class="wikitable"
|-
! Filename
! Key
! Description
|-
| ADV00
| C900000
| Station Square
|-
| ADV0100
| C920000
| Egg Carrier \(outside\)
|-
| ADV0130
| C920000
| Egg Carrier \(inside\)
|-
| ADV02
| C900000
| Mystic Ruins
|-
| ADV03
| C900000
| Mystic Ruins \(Past\)
|}
=== Bosses ("B" Files) ===
{| class="wikitable"
|-
! Filename
! Key
! Description
|-
| B\_CHAOS0
| C900000
| Chaos 0
|-
| B\_CHAOS2
| C900000
| Chaos 2
|-
| B\_CHAOS4
| C900000
| Chaos 4
|-
| B\_CHAOS6
| C900000
| Chaos 6
|-
| B\_CHAOS7
| C900000
| Perfect Chaos
|-
| B\_E101
| C900000
| E\-101 Beta
|-
| B\''E101\''R
| C900000
| E\-101 MK II
|-
| B\_EGM1
| C900000
| Egg Hornet
|-
| B\_EGM2
| C900000
| Egg Walker
|-
| B\_EGM3
| C900000
| Egg Viper
|-
| B\_ROBO
| C900000
| ZERO
|}
=== Chao ("AL" files) ===
{| class="wikitable"
|-
! Filename
! Key
! Description
|-
| AL\_MAIN
| C900000
| Chao body and related models
|-
| AL\_RACE
| CB80000
| Chao Stadium and Chao Race
|-
| AL\_GARDEN00
| CB80000
| Station Square Garden
|-
| AL\_GARDEN01
| CB80000
| Egg Carrier Garden
|-
| AL\_GARDEN02
| CB80000
| Mystic Ruins Garden
|}
=== Other files ===
{| class="wikitable"
|-
! Filename
! Key
! Description
|-
| ADVERTISE
| 8C900000
| Title screen, Super Sonic question mark
|-
| MINICART
| C900000
| Twinkle Circuit
|-
| SBOARD
| C900000
| Sand Hill
|-
| SHOOTING
| C900000
| Sky Chase
|-
| EV....
| CB80000
| Cutscenes
|-
| A\_MOT
| CC00000
| Amys animations
|-
| B\_MOT
| CC00000
| Big's animations
|-
| E\_MOT
| CC00000
| Gamma's animations
|-
| K\_MOT
| CC00000
| Knuckles' animations
|-
| S\_MOT
| CC00000
| Sonic's animations
|}
| S\_SBMOT | CB08000 | Snowboard animations \(Sonic\) |

← Older revision		Revision as of 14:40, 2 October 2025
Line 3:		Line 3:
	= Using Data Toolbox =		= Using Data Toolbox =
	The main window has a tab control, with each tab being a different tool. The following settings are shared across multiple tools:		The main window has a tab control, with each tab being a different tool. The following settings are shared across multiple tools:
	* ''Offset''/''Data Offset'' is the number of bytes trimmed from the beginning of the binary file. At the moment it is only needed for the [[SADX X360 prototype with symbols\|X360 version with symbols]], where the offset is 0xC800.		* ''Offset'' or ''Data Offset'' is the number of bytes trimmed from the beginning of the binary file. At the moment it is only needed for the [[SADX X360 prototype with symbols\|X360 version with symbols]], where the offset is 0xC800.
	* [[Ninja ASCII]] is an alternative way to export models and animations (motions and actions) as C structs. It outputs NJA/NAM files like in the [[Dreamcast SDK]].		* [[Ninja ASCII]] is an alternative way to export models and animations (motions and actions) as C structs. It outputs NJA/NAM files like in the [[Dreamcast SDK]].

Line 23:		Line 23:
	The <code>Labels</code> combo box lets you configure labels in [[SAModel]] files:		The <code>Labels</code> combo box lets you configure labels in [[SAModel]] files:

	* ~~<code>~~Address-based labels~~</code>~~ will name items by their address, e.g. <code>object_0014AC3C</code> for an <code>NJS_OBJECT located at 0x0014AC3C.		* Address-based labels will name items by their address, e.g. <code>object_0014AC3C</code> for an <code>NJS_OBJECT</code> located at 0x0014AC3C.
	* ~~<code>~~Full labels~~</code>~~ will name items using a label database. We have labels for the X360 prototype (<code>SonicApp.exe</code> only) and partial labels for <code>sonic.exe</code> in the 2004 PC port. When labels aren't found in the database, address-based labels will be used instead.		* Full labels will name items using a label database. We have labels for the X360 prototype (<code>SonicApp.exe</code> only) and partial labels for <code>sonic.exe</code> in the 2004 PC port. When labels aren't found in the database, address-based labels will be used instead.
	* ~~<code>~~No labels~~</code>~~ will strip all metadata from the files. This will reduce their size but item names will be based on the item's location in the model file, not the original binary file.		* No labels will strip all metadata from the files. This will reduce their size but item names will be based on the item's location in the model file, not the original binary file.

	== SplitMDL ==		== SplitMDL ==
Line 52:		Line 52:
	This tool lets you import and export [[Labels (SA Tools)\|labels]] embedded into [[SAModel]] files using external <code>.salabel</code> files.		This tool lets you import and export [[Labels (SA Tools)\|labels]] embedded into [[SAModel]] files using external <code>.salabel</code> files.

	[[File:Label.png]]☢		[[File:Label.png]]
	* The <code>Export Labels</code> radio button makes the tool save all embedded labels to <code>.salabel</code> files.		* The <code>Export Labels</code> radio button makes the tool save all embedded labels to <code>.salabel</code> files.
	* ~~Cheking~~ the <code>Erase Internal Labels</code> checkbox will make the tool clear embedded labels after exporting them. This can be used to reduce the size of SAModel files.		* Checking the <code>Erase Internal Labels</code> checkbox will make the tool clear embedded labels after exporting them. This can be used to reduce the size of SAModel files.
	* The <code>Import Labels</code> radio button overwrites embedded labels in SAModel files with labels found in <code>.salabel</code> files.		* The <code>Import Labels</code> radio button overwrites embedded labels in SAModel files with labels found in <code>.salabel</code> files.
	* Checking the <code>Delete Label Files</code> checkbox will make the tool remove the <code>.salabel</code> files after reading labels from them.		* Checking the <code>Delete Label Files</code> checkbox will make the tool remove the <code>.salabel</code> files after reading labels from them.