PS1 Argonaut Games Reverse Engineering *
Unofficial documentation of PS1 Argonaut games formats & Python extraction scripts
Extracted assets: PS1-Argonaut-Assets.
Currently supported games (Animations, 3D models, textures, maps & audio, depends on the game)
- Croc 2 PS1
- Croc 2 Demo PS1 (including DUMMY WADs)
- Harry Potter 1 PS1
- Harry Potter 2 PS1
Games that use the same engine but aren't supported yet
- Aladdin in Nasira's Revenge
- Alien Resurrection
- The Emperor's New Groove
The engine used by Argonaut's PS1 games seems to have evolved a lot over time, causing the file formats to change.
Therefore, this documentation and these tools cannot work with all Argonaut PS1 games.
How to use the Python scripts
Please use Python >= 3.10
Check that the assets you seek are not already extracted on PS1-Argonaut-Assets before using assets_export.py.
If they are not, it most probably means that they are not extractable or too experimental for now.
- (Optional) Create a virtual environment (venv) and activate it.
- Install the required Python packages:
pip install -r requirements.txt. - You can now launch the scripts, there are 2 at the moment:
- extract_files_from_dat.py: Extracts all files (like WADs) from raw game files (.DIR/.DAT).
- export_assets.py: Extracts assets (textures, music, levels, etc) from raw game files or WADs.
Disclaimers
- Please read this piece of documentation before the other pages.
- This project is in progress, so anything in this repo may change anytime.
- This is my first reverse, please be indulgent. Also, any help or advice is appreciated !
- I don't plan on reversing the code at the moment.
- I didn't manage to understand some values & concepts (yet). Don't hesitate to contact me / open an issue / submit a pull request if you have any valuable information.
- The scripts can't create modified/forged assets yet, but I plan on making this possible.
- Some documentation files can be hard to understand, sorry about that.
Contact
You can currently contact me on several Discord guilds (XeNTaX, TCRF, HP Modding, HP Console Speedruns, hpgames.net, Croc & Stuff, PSXDEV Network & more).
Huge thanks to my friends Dobbyatemysock and supluk for supporting me and sharing their ideas
Thanks to MasterLeoBlue for advising me to use my scripts on Croc 2: it was a good idea
Notes
* This repository used to be named "PS1 BRender Games Reverse Engineering", but according to this Twitter thread, the engine used by Argonaut games on the PS1 isn't BRender.