Difference between revisions of "Hans (tool)"

From Battlepedia
Jump to navigationJump to search
(Created page with "'''Hans''' is a tool made by community member igorseabra4 in C#. It is a save file editor for SpongeBob Squarepants: Battle For Bikin...")
 
 
Line 1: Line 1:
'''Hans''' is a tool made by community member [[User:igorseabra4|igorseabra4]] in C#. It is a [[Save File Format|save file]] editor for SpongeBob Squarepants: Battle For Bikini Bottom named after the character present in the game and TV show, a disembodiend hand who picks up the player when he's out of bounds.
+
'''Hans''' is a tool made by community member [[User:igorseabra4|igorseabra4]] in C#. It is a [[Save File Format|save file]] editor for Heavy Iron Studios games named after the character present in SpongeBob Squarepants: Battle For Bikini Bottom and in the TV show, a disembodiend hand who picks up the player when he's out of bounds.
  
 
Currently, editing is limited as the entire format is not known yet.
 
Currently, editing is limited as the entire format is not known yet.
 +
 +
==Supported Formats==
 +
The tool can open files from the following games:
 +
* Scooby-Doo: Night of 100 Frights
 +
* SpongeBob SquarePants: Battle For Bikini Bottom
 +
* The SpongeBob SquarePants Movie
 +
* The Incredibles
 +
* The Incredibles: Rise of the Underminer (possibly; untested)
 +
 +
In the following formats:
 +
* GameCube: GCI
 +
* Playstation 2: PCSX2 raw
 +
* Xbox: XBX
 +
 +
Please choose the game and file you want to open in the Settings menu before opening the file.
  
 
==Usage==
 
==Usage==
The tool can only open GCI save files (used by Dolphin) for Battle For Bikini Bottom (GameCube NTSC). Edited save files will only work with the Disable Save File Checksum AR Code:
+
The save files is composed of multiple blocks. GDAT, LEDR, ROOM, PREF, SVID are normally the first five blocks and each contain different types of data, all of which can be edited. SFIL is the last block. The area in between them has a variable number of Scene blocks, plus the blocks CNTR and PLYR (these are unrelated to the [[CNTR]] and [[PLYR]] [[asset]]s). The Scene blocks plus CNTR and PLYR are usually in alphabetical order. Scene blocks are named after each scene in the game which has already been visited in that save file (for example: JF01). Sometimes there are also blocks for the menu files in this region. The CNTR block is not present in Scooby.
  
0403ED94 60000000
+
The tool allows you to add, remove and change the order of any of the sections. Note: Hans requires GDAT to be the first section for the file to be saved correctly (and, in the case of Xbox files, SFIL to be the last). The other sections can be in any order (it's unknown how the game will react to orders different than the default one specified above, though).
 +
 
 +
===Format Conversion===
 +
Hans can convert the files between different platforms, but this method is still limited due to our (little) knowledge of the Scene sections. To save a file in a different platform, choose it in the Settings menu before saving. Changing the game with a file open has no effect as you cannot convert a save file to a different game. This is the status of all possible conversions:
 +
 
 +
{| class="wikitable sortable"
 +
|+
 +
! Source
 +
! Destination
 +
! Status
 +
|-
 +
| Xbox
 +
|| Playstation 2
 +
|| Only conversion which works fully.
 +
|-
 +
| Xbox
 +
|| GameCube
 +
|| Only menu settings will be converted properly, but not player and scene data. You must add the converted data to a GCI file manually in a hex editor. Checksum will be incorrect.
 +
|-
 +
| Playstation 2
 +
|| Xbox
 +
|| Should work, but you must add the footer of the XBX manually in a hex editor.
 +
|-
 +
| Playstation 2
 +
|| GameCube
 +
|| Only menu settings will be converted properly, but not player and scene data. You must add the converted data to a GCI file manually in a hex editor. Checksum will be incorrect.
 +
|-
 +
| GameCube
 +
|| Playstation 2
 +
|| Only menu settings will be converted properly. Checksum will be incorrect.
 +
|-
 +
| GameCube
 +
|| Xbox
 +
|| Only menu settings will be converted properly. Checksum will be incorrect. You must add the footer of the XBX manually in a hex editor.
 +
|}
  
The BFBB save file is composed of multiple blocks. GDAT, LEDR, ROOM, PREF, SVID are normally the first five blocks and each contain different types of data, all of which can be edited. SFIL is the last block. The area in between them has a variable number of Scene blocks, plus the blocks CNTR and PLYR (these are unrelated to the [[CNTR]] and [[PLYR]] [[asset]]s). The Scene blocks plus CNTR and PLYR are usually in alphabetical order. Scene blocks are named after each scene in the game which has already been visited in that save file (for example: JF01).
+
===Checksum===
 +
Edited save files will only work if the Disable Save File Checksum code is on. This is the AR code for Battle For Bikini Bottom (GameCube, NTSC):
  
The tool allows you to add, remove and change the order of any of the sections. Note: Hans requires GDAT to be the first section for the file to be saved correctly. The other sections can be in any order (it's unknown how the game will react to orders different than the default one specified above, though).
+
0403ED94 60000000
  
 
==Links==
 
==Links==

Latest revision as of 22:56, 10 February 2020

Hans is a tool made by community member igorseabra4 in C#. It is a save file editor for Heavy Iron Studios games named after the character present in SpongeBob Squarepants: Battle For Bikini Bottom and in the TV show, a disembodiend hand who picks up the player when he's out of bounds.

Currently, editing is limited as the entire format is not known yet.

Supported Formats

The tool can open files from the following games:

  • Scooby-Doo: Night of 100 Frights
  • SpongeBob SquarePants: Battle For Bikini Bottom
  • The SpongeBob SquarePants Movie
  • The Incredibles
  • The Incredibles: Rise of the Underminer (possibly; untested)

In the following formats:

  • GameCube: GCI
  • Playstation 2: PCSX2 raw
  • Xbox: XBX

Please choose the game and file you want to open in the Settings menu before opening the file.

Usage

The save files is composed of multiple blocks. GDAT, LEDR, ROOM, PREF, SVID are normally the first five blocks and each contain different types of data, all of which can be edited. SFIL is the last block. The area in between them has a variable number of Scene blocks, plus the blocks CNTR and PLYR (these are unrelated to the CNTR and PLYR assets). The Scene blocks plus CNTR and PLYR are usually in alphabetical order. Scene blocks are named after each scene in the game which has already been visited in that save file (for example: JF01). Sometimes there are also blocks for the menu files in this region. The CNTR block is not present in Scooby.

The tool allows you to add, remove and change the order of any of the sections. Note: Hans requires GDAT to be the first section for the file to be saved correctly (and, in the case of Xbox files, SFIL to be the last). The other sections can be in any order (it's unknown how the game will react to orders different than the default one specified above, though).

Format Conversion

Hans can convert the files between different platforms, but this method is still limited due to our (little) knowledge of the Scene sections. To save a file in a different platform, choose it in the Settings menu before saving. Changing the game with a file open has no effect as you cannot convert a save file to a different game. This is the status of all possible conversions:

Source Destination Status
Xbox Playstation 2 Only conversion which works fully.
Xbox GameCube Only menu settings will be converted properly, but not player and scene data. You must add the converted data to a GCI file manually in a hex editor. Checksum will be incorrect.
Playstation 2 Xbox Should work, but you must add the footer of the XBX manually in a hex editor.
Playstation 2 GameCube Only menu settings will be converted properly, but not player and scene data. You must add the converted data to a GCI file manually in a hex editor. Checksum will be incorrect.
GameCube Playstation 2 Only menu settings will be converted properly. Checksum will be incorrect.
GameCube Xbox Only menu settings will be converted properly. Checksum will be incorrect. You must add the footer of the XBX manually in a hex editor.

Checksum

Edited save files will only work if the Disable Save File Checksum code is on. This is the AR code for Battle For Bikini Bottom (GameCube, NTSC):

0403ED94 60000000

Links