January 3, 20251 yr There's this archive made with an open-source game engine called Hatch from Github which uses OpenMania (Sonic Mania mod stuff e.t.c) source code and i can't get to open it using RetroED nor extracting it using RSDK_v5 extracting tools cause it uses the "HATCH" header instead of "RSDK" Sample file: Data.hatch is there a way to decompress these files for dumping the resources like (image, sprites, sound and models e.t.c) cause i found some references here: https://github.com/Axanery/HatchGameEngine https://github.com/Axanery/OpenMania
January 3, 20251 yr Supporter Hi. File format looks like this: // header 5 bytes (char) - signature // "HATCH" 3 bytes - version // 01 00 00 // index 2 bytes (uint16) - file count // for each file 4 bytes (uint32) - filename CRC32 8 bytes (uint64) - file offset 8 bytes (uint64) - file uncompressed size 4 bytes (uint32) - data flag // 2 - encrypted, 0 - not encrypted 8 bytes (uint64) - file compressed size // data // for each file x bytes - file data And here's a script to dump and decompress file data. https://github.com/bartlomiejduda/Tools/blob/master/NEW Tools/Hatch Engine/Hatch_Engine_HATCH_script.bms Unfortunately all files with dataFlag=2 are encrypted. If I understand engine's source code corretly, you need original filenames and original file sizes to properly decrypt data. Here's the algorithm to decrypt: https://github.com/Axanery/HatchGameEngine/blob/master/source/Engine/ResourceTypes/ResourceManager.cpp#L172-L232 You can probably hook the game with Frida to get the filenames.
January 4, 20251 yr Supporter Luckily this "Sonic Galactic" game had debug symbols in "demo 2" release 😄 So it was very easy to create frida hook https://github.com/bartlomiejduda/Tools/blob/master/NEW Tools/Hatch Engine/hatch_engine_frida_script.js And I have 574 filenames already: sonic_galactic_filenames_FINAL.zip
January 4, 20251 yr Supporter It's possible to get some assets after making use of the filenames I shared above: Here's my implementation of the decryption algorithm: https://github.com/bartlomiejduda/ReverseBox/blob/main/reversebox/encryption/encryption_hatch_engine.py I'm also working on a extractor for this game, but I'll share it when it will be more user friendly 😄
January 5, 20251 yr Supporter Currently 1394 filenames are known 2025-01-05 01:41:02 - __main__ - line 109 - INFO - ####### SUMMARY ####### 2025-01-05 01:41:02 - __main__ - line 112 - INFO - Known filenames: 1394 (61.76%) 2025-01-05 01:41:02 - __main__ - line 113 - INFO - Unknown filenames: 863 (38.24%) 2025-01-05 01:41:02 - __main__ - line 114 - INFO - All filenames: 2257 Full list available here: https://github.com/bartlomiejduda/Tools/blob/master/NEW Tools/Hatch Engine/Hatch Engine Archive Tool/filelists/sonic_galactic_demo2_filenames.txt
January 5, 20251 yr Supporter Solution Extractor for data.hatch archive is available here: https://github.com/bartlomiejduda/Tools/tree/master/NEW Tools/Hatch Engine/Hatch Engine Archive Tool
January 5, 20251 yr Supporter Thanks to anonymous user we have now over 90% of the filenames. 😉 2025-01-05 21:17:54 - __main__ - line 109 - INFO - ####### SUMMARY ####### 2025-01-05 21:17:54 - __main__ - line 112 - INFO - Known filenames: 2039 (90.34%) 2025-01-05 21:17:54 - __main__ - line 113 - INFO - Unknown filenames: 218 (9.66%) 2025-01-05 21:17:54 - __main__ - line 114 - INFO - All filenames: 2257
January 20, 20251 yr Supporter 1 hour ago, Kubatao said: Can you get the scripts? What scripts? What do you mean?
January 20, 20251 yr Can you get the .hsl files? exemple Stage/2_CGZ/Enemies/Crab/CGZCrabCutscene2Spawn.hsl Stage/2_CGZ/Enemies/Crab/CrabBoss.hsl Stage/2_CGZ/Enemies/Crab/CrabDespawner.hsl Stage/2_CGZ/Enemies/Crab/CrabDestroyRect.hsl Edited January 20, 20251 yr by Kubatao
January 20, 20251 yr Supporter Tool I shared above can decrypt and extract ALL files from the archive, but some filenames are still unknown, so you'll get names like "file123.bin" instead of "CrabBoss.hsl" You could search for them in "Unknown_Files" directory.
January 20, 20251 yr I don't know how to use this tool, can you share everything you manage to extract?
January 20, 20251 yr Supporter 24 minutes ago, Kubatao said: can you share everything you manage to extract? No. 24 minutes ago, Kubatao said: I don't know how to use this tool Please read readme file. Example usage is shown there.
July 27, 2025Jul 27 On 1/4/2025 at 8:02 PM, ikskoks said: It's possible to get some assets after making use of the filenames I shared above: Here's my implementation of the decryption algorithm: https://github.com/bartlomiejduda/ReverseBox/blob/main/reversebox/encryption/encryption_hatch_engine.py I'm also working on a extractor for this game, but I'll share it when it will be more user friendly 😄 I couldn't find any of the files over here, any luck or on how I can extract them?
July 27, 2025Jul 27 Supporter 1 hour ago, KrisAnimations said: I couldn't find any of the files over here, any luck or on how I can extract them? Hi. You just have to use tool I shared in one of the previous post https://github.com/bartlomiejduda/Tools/tree/master/NEW Tools/Hatch Engine/Hatch Engine Archive Tool It's a Python program, so you need to follow these steps: 1. Install Python 3.11 https://www.python.org/downloads/release/python-3119/ 2. Install all requirements using pip pip install -r requirements.txt 3. Run the tool as explained in readme file.
July 27, 2025Jul 27 It doesn't find the file Data.hatch doesn't exists for me I cannot find the file SonicGalactic\Data.hatch and it says "aster\\Tools-master\\hatch_engine_archive_tool.py': [Errno 2] No such file or directory PS C:\Users\depre\Downloads\Tools-master\Tools-master>" if I try to locate it with shift and right click to the python cmd but the logs says "2025-07-27 23:50:29 - __main__ - line 34 - INFO - Starting export data... 2025-07-27 23:50:29 - reversebox.io_files.file_handler - line 114 - ERROR - Can't read from this file! 2025-07-27 23:50:35 - __main__ - line 34 - INFO - Starting export data... 2025-07-27 23:50:35 - reversebox.io_files.file_handler - line 114 - ERROR - Can't read from this file! 2025-07-27 23:51:56 - __main__ - line 34 - INFO - Starting export data... 2025-07-27 23:51:56 - reversebox.io_files.file_handler - line 114 - ERROR - Can't read from this file! 2025-07-27 23:52:01 - __main__ - line 34 - INFO - Starting export data... 2025-07-27 23:52:01 - reversebox.io_files.file_handler - line 114 - ERROR - Can't read from this file!" Edited July 27, 2025Jul 27 by KrisAnimations
July 27, 2025Jul 27 Supporter You need to put valid paths for the tool to work. Also if you have any spaces in your paths, you have to put double quotes around them.
July 27, 2025Jul 27 19 minutes ago, ikskoks said: You need to put valid paths for the tool to work. Also if you have any spaces in your paths, you have to put double quotes around them. I did copied what was putted I am unsure if there are spaces.. the app hatch engine archive tool is closing itself when open Edited July 27, 2025Jul 27 by KrisAnimations
July 27, 2025Jul 27 Supporter Please read or watch some tutorials on how to run command line programs https://www.google.com/search?q=how+to+run+command+line+program or how to run python scripts with arguments https://www.google.com/search?q=how+to+run+python+script+with+arguments It is a simple python script. Running this in cmd is pretty standard action.
July 27, 2025Jul 27 9 minutes ago, ikskoks said: Please read or watch some tutorials on how to run command line programs https://www.google.com/search?q=how+to+run+command+line+program or how to run python scripts with arguments https://www.google.com/search?q=how+to+run+python+script+with+arguments It is a simple python script. Running this in cmd is pretty standard action. 8 hours ago, ikskoks said: Hi. You just have to use tool I shared in one of the previous post https://github.com/bartlomiejduda/Tools/tree/master/NEW Tools/Hatch Engine/Hatch Engine Archive Tool It's a Python program, so you need to follow these steps: 1. Install Python 3.11 https://www.python.org/downloads/release/python-3119/ 2. Install all requirements using pip pip install -r requirements.txt 3. Run the tool as explained in readme file. The tool requires a valid .hatch file (e.g., Data.hatch), and that file is missing. The error is not about spaces or command line formatting it’s simply that the file doesn’t exist of what I downloaded from the links ya send The script expects Data.hatch but it’s not included in the demo download. Where can I get that file or what file am I supposed to use as input to -e? This is the only way forward, unless the .hatch file is packed under another name ? and the hatch_engine_archive_tool is closing when opened as I showed the logs it says "2025-07-27 23:50:29 - __main__ - line 34 - INFO - Starting export data... 2025-07-27 23:50:29 - reversebox.io_files.file_handler - line 114 - ERROR - Can't read from this file! 2025-07-27 23:50:35 - __main__ - line 34 - INFO - Starting export data... 2025-07-27 23:50:35 - reversebox.io_files.file_handler - line 114 - ERROR - Can't read from this file! 2025-07-27 23:51:56 - __main__ - line 34 - INFO - Starting export data... 2025-07-27 23:51:56 - reversebox.io_files.file_handler - line 114 - ERROR - Can't read from this file! 2025-07-27 23:52:01 - __main__ - line 34 - INFO - Starting export data... 2025-07-27 23:52:01 - reversebox.io_files.file_handler - line 114 - ERROR - Can't read from this file!" this simply when the file is opened Edited July 27, 2025Jul 27 by KrisAnimations
July 27, 2025Jul 27 Supporter WHAT 😄 So why did you even ask in the thread about hatch file if you don't have hatch file? 😄😄 This topic is about Sonic Galactic, so you have to download Sonic Galactic first to even see the hatch file, I thought it was abvious. Here is the link --> https://sonicgalactic.github.io/download.html You need to download the game and hatch file will be located in the archive. Just unpack it wherever you like😄 I literally don't know how to help more with this...
July 27, 2025Jul 27 4 minutes ago, ikskoks said: WHAT 😄 So why did you even ask in the thread about hatch file if you don't have hatch file? 😄😄 This topic is about Sonic Galactic, so you have to download Sonic Galactic first to even see the hatch file, I thought it was abvious. Here is the link --> https://sonicgalactic.github.io/download.html You need to download the game and hatch file will be located in the archive. Just unpack it wherever you like😄 I literally don't know how to help more with this... 😄😄 that's on me then I am sorry hahaha however I still cannot open the hatch files that's the issue? Edited July 27, 2025Jul 27 by KrisAnimations
July 27, 2025Jul 27 11 minutes ago, ikskoks said: WHAT 😄 So why did you even ask in the thread about hatch file if you don't have hatch file? 😄😄 This topic is about Sonic Galactic, so you have to download Sonic Galactic first to even see the hatch file, I thought it was abvious. Here is the link --> https://sonicgalactic.github.io/download.html You need to download the game and hatch file will be located in the archive. Just unpack it wherever you like😄 I literally don't know how to help more with this... I did it ! never mind thank you so much ! everything is extracting
July 28, 2025Jul 28 Supporter FYI - I've added error handling in the newest version https://github.com/bartlomiejduda/Tools/commit/d55e2d040ac4562b339f47c147a9cd3c5d65b5a4 So you should get nice error message now if something is wrong with a path to the hatch file: Invalid HATCH file path provided! Exiting!
Create an account or sign in to comment