Hans (tool)

From Heavy Iron Modding

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