Actions

Difference between revisions of "Shadow the Hedgehog (game)/Technical information"

From Sonic Retro

(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{{back}}[[Category:Technical information]]
 +
{{cleanup}}
 +
 
{{SCHG ShTH}}
 
{{SCHG ShTH}}
This is the '''[[Sonic Community Hacking Guide]] for ''[[Shadow the Hedgehog (game)|Shadow the Hedgehog]]'''''.
 
  
== File Formats ==  
+
==File formats==  
 
* '''.ONE:''' the .one files are packages used to hold the textures and individual models.  The header lists the one version compressor format, which is "One Ver 0.60" All the .one files all packages that keep textures and models packaged within them.  
 
* '''.ONE:''' the .one files are packages used to hold the textures and individual models.  The header lists the one version compressor format, which is "One Ver 0.60" All the .one files all packages that keep textures and models packaged within them.  
 
* '''.BSP:''' Inside the multiple .ONE files in the stg0xxx directories are .PRS files, which contain .BSP files; these contain the level geometry. It seems that the level geometry is stored in numerous .ONE files for each level, except for the test levels.
 
* '''.BSP:''' Inside the multiple .ONE files in the stg0xxx directories are .PRS files, which contain .BSP files; these contain the level geometry. It seems that the level geometry is stored in numerous .ONE files for each level, except for the test levels.
 
* '''.GNCP:''' These files store scripts for menus/HUD elements. The exact extension is different depending on the console version; .GNCP for GameCube, .XNCP for Xbox, .SNCP for PS2. Some *NCP's contain embedded .RWTEX format textures that it loads instead of from a .TXD.
 
* '''.GNCP:''' These files store scripts for menus/HUD elements. The exact extension is different depending on the console version; .GNCP for GameCube, .XNCP for Xbox, .SNCP for PS2. Some *NCP's contain embedded .RWTEX format textures that it loads instead of from a .TXD.
 +
* '''.EFD:''' Inside the effect information data has particle effect data and of course parameters for each effect model.
 
* '''.TXD:''' The usual texture pack. They are a different format from Sonic Heroes. All of the textures are kept in this pack.  
 
* '''.TXD:''' The usual texture pack. They are a different format from Sonic Heroes. All of the textures are kept in this pack.  
 
* '''.FOG:''' I'm actually not sure on what these are. I'm assuming create a fog. A .FOG file is usually in each of the stage folders and don't have much in them. Only 1 line has something on it, but even then it's not even full.
 
* '''.FOG:''' I'm actually not sure on what these are. I'm assuming create a fog. A .FOG file is usually in each of the stage folders and don't have much in them. Only 1 line has something on it, but even then it's not even full.
Line 11: Line 14:
 
* '''.PAC:''' Xbox version SFX / voice packs (Thanks to Neo Chaotikal)
 
* '''.PAC:''' Xbox version SFX / voice packs (Thanks to Neo Chaotikal)
 
* '''.INF:''' Text files that contain boot and [[SCHG:Shadow_the_Hedgehog/Stage_Parameters|stage parameters]].
 
* '''.INF:''' Text files that contain boot and [[SCHG:Shadow_the_Hedgehog/Stage_Parameters|stage parameters]].
* '''.SFD:''' CG scenes/cutscenes.
+
* '''.[[sega:Sofdec|SFD]]:''' CG scenes/cutscenes.
 
* '''.AFS:''' Packages to store something, in this case it's voices for the characters.
 
* '''.AFS:''' Packages to store something, in this case it's voices for the characters.
* '''.ADX:''' Sound such as music or cutscene tracks.
+
* '''.[[sega:ADX|ADX]]:''' Sound such as music or cutscene tracks.
* '''.DFF:''' RenderWare model.
+
* '''.DFF:''' [[sega:RenderWare|RenderWare]] model.
 
* '''.BON:''' Model bones file.
 
* '''.BON:''' Model bones file.
 
* '''.BDT:''' Stage visibility file.
 
* '''.BDT:''' Stage visibility file.
Line 23: Line 26:
 
* '''.BIN:''' Binary files. Files containing "light" in their name  are lighting-data for models on the stage; near-identical to the *light.bin files used in Sonic Heroes.
 
* '''.BIN:''' Binary files. Files containing "light" in their name  are lighting-data for models on the stage; near-identical to the *light.bin files used in Sonic Heroes.
  
== Directories ==
+
==Directories==
 
* '''character:''' Where character .ONE files are kept.  
 
* '''character:''' Where character .ONE files are kept.  
 
* '''common:''' This directory holds generic misc. data such as Weapon Resources and Len Flares.
 
* '''common:''' This directory holds generic misc. data such as Weapon Resources and Len Flares.
Line 37: Line 40:
 
* '''Root Directory:''' where music and other voices are kept. Also where CG cutscenes are kept. Also, there is a stg_cmn_gdt.one file that contains variety of common stage object models.
 
* '''Root Directory:''' where music and other voices are kept. Also where CG cutscenes are kept. Also, there is a stg_cmn_gdt.one file that contains variety of common stage object models.
  
== Software ==
+
==User Data==
* '''[[HeroesONE]]''' can be used to edit .ONE files from Shadow the Hedgehog.
+
<pre>
* The setid.bin file can be edited using '''[[Shadow SET ID Table Editor]]'''.
+
struct RpUserDataFormat
* '''[[Heroes Power Plant]]''' has support for stage model, collision, visibility and object layout files.
+
{
 +
  uint32 NumberOfSections;
 +
  uint32 StringLength;
 +
  string DataName;
 +
  uint32 Format;
 +
  uint32 NumberofElements;
 +
  void* Parameters;
 +
};
 +
</pre>
 +
<br>
 +
The following names does these effects:
 +
<pre>
 +
ATTR_WORLDPARM.ATTR_WORLDPARM - Material flag
  
== Object Layout Data ==
+
Parameters:
Object layouts are contained in various little endian .DAT files located inside each level's folder. They have the following layout:
+
08 - K
  
\\ HEADER (0xC bytes)
+
FVF.UserData - Misc. User Data
 
char[4] \\ file magic "sky2" in ascii
 
int32 \\ amount of objects
 
int32 \\ total lenght of misc. section in bytes
 
 
\\ OBJECT ENTRY (0x2C bytes)
 
 
float32[3] \\ X, Y, Z position
 
float32[3] \\ X, Y, Z rotation (degrees)
 
uint8 \\ usually 01
 
uint8 \\ 0x10 for CMN, 0x20 for NRM, 0x40 for HRD, 0x80 for DS1
 
uint8 \\ usually 00, but 0x40 for DS1
 
uint8 \\ usually 80
 
uint8 \\ usually 01
 
uint8 \\ 0x10 for CMN, 0x20 for NRM, 0x40 for HRD, 0x80 for DS1
 
uint8 \\ usually 00, but 0x40 for DS1
 
uint8 \\ usually 00
 
uint8 \\ object type
 
uint8 \\ object list
 
uint8 \\ link ID
 
uint8 \\ render distance
 
uint32 \\ lenght of misc. entry
 
uint32 \\ null
 
  
\\ X, Y and Z positions: location of the object in the world
+
Parameters:
\\ X, Y and Z rotations: angle of the object in the world
+
03 30
\\ 8 bytes have unknown function
+
</pre>
\\ object type: this byte sets which object from the list will be loaded
 
\\ object list: this byte sets which list the object will be chosen from
 
\\ link ID: this is used to link two or more objects together
 
\\ render distance: this multiplier sets from which distance the object starts being rendered
 
\\ lenght of misc. entry: amount of bytes of this object's misc. entry.
 
 
\\ after that, there is an amount of bytes set in the header with the misc. settings for each object. They are loaded in the same order the objects are laid out in the file.
 
  
//------------------------------------------------
+
==.BON==
//--- 010 Editor v7.0.2 Binary Template
 
 
//  File: .BON File (Shadow The Hedgehog External Bone Structure file for Animations, Export from DFF Model)
 
//  File: .BON File (Shadow The Hedgehog External Bone Structure file for Animations, Export from DFF Model)
//   Authors: Sewer56lol
+
//     Authors: Sewer56lol
//------------------------------------------------
+
 
struct FILE {
+
// struct FILE {
    struct HEADER  
+
//    struct HEADER  
 
     {
 
     {
 
         char Activator[4];
 
         char Activator[4];
Line 97: Line 81:
 
     } header;
 
     } header;
  
    struct RECORD {
+
//    struct RECORD {
 
         uint BoneTag; // Properties in 3DS
 
         uint BoneTag; // Properties in 3DS
 
         uint UnknownRootID; // SomeID
 
         uint UnknownRootID; // SomeID
Line 124: Line 108:
  
  
## Shadow The Hedgehog .BON Struct
+
// Shadow The Hedgehog .BON Struct
## Sewer56lol
+
 
 +
// Sewer56lol
  
0x10 Header: Constant
+
//0x10 Header: Constant
0x10 Character Name/Identifier (Must change for porting)
+
 
 +
//0x10 Character Name/Identifier (Must change for porting)
 +
 
 +
//Bone Data | 0x80 Byte Entries till EOF
  
Bone Data | 0x80 Byte Entries till EOF
 
 
---------
 
---------
0x10 X Offset of Parent Bone | Float
 
0x14 Y Offset of Parent Bone | Float
 
0x18 Z Offset of Parent Bone | Float
 
0x60 File Name | End of Entry
 
  
Knuckles Reference:
+
//0x10 X Offset of Parent Bone | Float
kn_root = Root Bone
+
 
kn_j_l2toge1 = Left Spines
+
//0x14 Y Offset of Parent Bone | Float
kn_j_head = Head
+
 
kn_j_m1oge1 = Middle Spines
+
//0x18 Z Offset of Parent Bone | Float
kn_j_r2toge1 = Right Spines
+
 
 +
 
 +
//0x60 File Name | End of Entry
 +
 
 +
//Knuckles Reference:
 +
 
 +
//kn_root = Root Bone
 +
 
 +
//kn_j_l2toge1 = Left Spines
 +
 
 +
//kn_j_head = Head
 +
 
 +
//kn_j_m1oge1 = Middle Spines
  
 +
//kn_j_r2toge1 = Right Spines
  
== Contributors ==
+
==References==
*[[Zeck]] - File formats and directories.
+
<references />
*[[igorseabra4]] - Object layout data.
 
*[[LimblessVector]] - Misc. file format and directory info.
 
  
 +
{{ShadowOmni}}
 
{{SCHGuides}}
 
{{SCHGuides}}
[[Category:Sonic Community Hacking Guide]]
 

Revision as of 14:01, 2 October 2020

Back to: Shadow the Hedgehog (game).
Sonicretro-round.svg This article needs cleanup.

This article needs to be edited to conform to a higher standard of article quality.
After the article has been cleaned up, you may remove this message. See How to Edit a Page for help.

Shadow the Hedgehog technical information
Main Article
Level Editing
Stage parameters
Stage ID list
Object layout format
Effect data
Spline format
Misc
Cutscene ID list

File formats

  • .ONE: the .one files are packages used to hold the textures and individual models. The header lists the one version compressor format, which is "One Ver 0.60" All the .one files all packages that keep textures and models packaged within them.
  • .BSP: Inside the multiple .ONE files in the stg0xxx directories are .PRS files, which contain .BSP files; these contain the level geometry. It seems that the level geometry is stored in numerous .ONE files for each level, except for the test levels.
  • .GNCP: These files store scripts for menus/HUD elements. The exact extension is different depending on the console version; .GNCP for GameCube, .XNCP for Xbox, .SNCP for PS2. Some *NCP's contain embedded .RWTEX format textures that it loads instead of from a .TXD.
  • .EFD: Inside the effect information data has particle effect data and of course parameters for each effect model.
  • .TXD: The usual texture pack. They are a different format from Sonic Heroes. All of the textures are kept in this pack.
  • .FOG: I'm actually not sure on what these are. I'm assuming create a fog. A .FOG file is usually in each of the stage folders and don't have much in them. Only 1 line has something on it, but even then it's not even full.
  • AudioData .BIN: These keep sound effects for what they may correspond to, such as stage objects or boss battles.
  • .PAC: Xbox version SFX / voice packs (Thanks to Neo Chaotikal)
  • .INF: Text files that contain boot and stage parameters.
  • .SFD: CG scenes/cutscenes.
  • .AFS: Packages to store something, in this case it's voices for the characters.
  • .ADX: Sound such as music or cutscene tracks.
  • .DFF: RenderWare model.
  • .BON: Model bones file.
  • .BDT: Stage visibility file.
  • .UVA: UV animation file.
  • .CCL: Object collision file.
  • .FNT: Subtitle script data.
  • .MET: Subtitle character spacing data.
  • .BIN: Binary files. Files containing "light" in their name are lighting-data for models on the stage; near-identical to the *light.bin files used in Sonic Heroes.

Directories

  • character: Where character .ONE files are kept.
  • common: This directory holds generic misc. data such as Weapon Resources and Len Flares.
  • csdFiles: Where any menu elements are kept, such as HUDs, Loading Screens, 2P Results.
  • discError: Where disc error .TXDs are kept. Exclusive to Xbox version.
  • enemy: Where enemies' and boss' .ONES are kept.
  • event: Where events, such as cutscene actions are kept. Seems to use .ONEs and .SCRs file formats.
  • fonts: Where text/fonts are kept.
  • palsel: Where PAL region's hertz screen data is kept. Not present in Xbox version.
  • sound: Where Audio Data and Sound Effects are kept.
  • stafroll: Where the .SRD and the .TXD file that make up the credits/staff roll are kept.
  • stg0xxx (stg0005 to stg0911): These are where the files that make up the stages in SHTH are kept. Usually contain .TXD files, .ONE files (which contain .PRS files, which contain .BSP and .TXD files) and .DAT files which in the stage's case make up camera data, however, some have .FOG files.
  • Root Directory: where music and other voices are kept. Also where CG cutscenes are kept. Also, there is a stg_cmn_gdt.one file that contains variety of common stage object models.

User Data

struct RpUserDataFormat
{
   uint32 NumberOfSections;
   uint32 StringLength;
   string DataName;
   uint32 Format;
   uint32 NumberofElements;
   void* Parameters;
};


The following names does these effects:

ATTR_WORLDPARM.ATTR_WORLDPARM - Material flag

Parameters:
08 - K

FVF.UserData - Misc. User Data

Parameters:
03 30

.BON

// File: .BON File (Shadow The Hedgehog External Bone Structure file for Animations, Export from DFF Model) // Authors: Sewer56lol

// struct FILE { // struct HEADER

   	{
       	char	Activator[4];
       	uint	Null;
       	ushort  Unknown;
       	ushort  Entries;
       	float   RootOfBone;
       	char	CharacterNameID[32];
   	} header;

// struct RECORD {

       	uint	BoneTag; // Properties in 3DS
       	uint	UnknownRootID; // SomeID
       	short   UnknownValue; // Some Value
       	byte	IDOfSplit;
       	byte	UnknownID;
       	int 	NullZero;
       	float   OffsetParentBoneX;
       	float   OffsetParentBoneY;
       	float   OffsetParentBoneZ;
       	int 	Null;   		// Always Null
       	float   UnknownReferenceFloatX;  // Seems to reference something else
       	float   UnknownReferenceFloatY;  // Seems to reference something else
       	float   UnknownReferenceFloatZ;  // Seems to reference something else
       	int 	NullTwo;    	// Always Null
       	float   UnknownFloatX2; // Almost always 1
       	float   UnknownFloatY2; // Almost always 1
       	float   UnknownFloatZ2; // Almost always 1
       	int 	NullThree;  	// Always Null
       	char	UnknownTwo[16];
       	char	BoneName[32];
   	} record[ header.Entries ];

} file;


// Shadow The Hedgehog .BON Struct

// Sewer56lol

//0x10 Header: Constant

//0x10 Character Name/Identifier (Must change for porting)

//Bone Data | 0x80 Byte Entries till EOF


//0x10 X Offset of Parent Bone | Float

//0x14 Y Offset of Parent Bone | Float

//0x18 Z Offset of Parent Bone | Float


//0x60 File Name | End of Entry

//Knuckles Reference:

//kn_root = Root Bone

//kn_j_l2toge1 = Left Spines

//kn_j_head = Head

//kn_j_m1oge1 = Middle Spines

//kn_j_r2toge1 = Right Spines

References


Shadow the Hedgehog
Shadow title.png

Main page
Comparisons
Maps
Cheat codes
Credits


Manuals
Promotional material
Magazine articles
Reception
Merchandise


Development
Hidden content
Bugs
Technical information

Sonic Community Hacking Guide
General
SonED2 Manual | Subroutine Equivalency List
Game-Specific
Sonic the Hedgehog (16-bit) | Sonic the Hedgehog (8-bit) | Sonic CD (prototype 510) | Sonic CD | Sonic CD (PC) | Sonic CD (2011) | Sonic 2 (Simon Wai prototype) | Sonic 2 (16-bit) | Sonic 2 (Master System) | Sonic 3 | Sonic 3 & Knuckles | Chaotix | Sonic Jam | Sonic Jam 6 | Sonic Adventure | Sonic Adventure DX: Director's Cut | Sonic Adventure DX: PC | Sonic Adventure (2010) | Sonic Adventure 2 | Sonic Adventure 2: Battle | Sonic Adventure 2 (PC) | Sonic Heroes | Sonic Riders | Sonic the Hedgehog (2006) | Sonic & Sega All-Stars Racing | Sonic Unleashed (Xbox 360/PS3) | Sonic Colours | Sonic Generations | Sonic Forces
Technical information
Sonic Eraser | Sonic 2 (Nick Arcade prototype) | Sonic CD (prototype; 1992-12-04) | Dr. Robotnik's Mean Bean Machine | Sonic Triple Trouble | Tails Adventures | Sonic Crackers | Sonic 3D: Flickies' Island | Sonic & Knuckles Collection | Sonic R | Sonic Shuffle | Sonic Advance | Sonic Advance 3 | Sonic Battle | Shadow the Hedgehog | Sonic Rush | Sonic Classic Collection | Sonic Free Riders | Sonic Lost World
Legacy Guides
The Nemesis Hacking Guides The Esrael Hacking Guides
ROM: Sonic 1 | Sonic 2 | Sonic 2 Beta | Sonic 3

Savestate: Sonic 1 | Sonic 2 Beta/Final | Sonic 3

Sonic 1 (English / Portuguese) | Sonic 2 Beta (English / Portuguese) | Sonic 2 and Knuckles (English / Portuguese)
Move to Sega Retro
Number Systems (or scrap) | Assembly Hacking Guide | 68000 Instruction Set | 68000 ASM-to-Hex Code Reference | SMPS Music Hacking Guide | Mega Drive technical information