Hans (tool): Difference between revisions

no edit summary
Battlepedia>Igorseabra4
(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...")
 
No edit summary
 
(3 intermediate revisions by 2 users not shown)
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 SpongeBobHeavy Squarepants:Iron BattleStudios For Bikini Bottomgames named after the character present in theSpongeBob gameSquarepants: 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 BFBB save filefiles 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.
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 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).
0403ED94 60000000
 
===Format Conversion===
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).
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"
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).
|+
! 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==
Line 16 ⟶ 66:
* [https://github.com/igorseabra4/IndustrialParkHans Source code on GitHub]
 
[[Category:Modding]] [[Category:Tools]]