https://github.com/velocityra/slytools
Sly Cooper (PS2/PS3 games) modding tools & research
https://github.com/velocityra/slytools
cooper game-research modding modding-tools ps2 ps3 sly
Last synced: about 1 month ago
JSON representation
Sly Cooper (PS2/PS3 games) modding tools & research
- Host: GitHub
- URL: https://github.com/velocityra/slytools
- Owner: VelocityRa
- License: mit
- Created: 2020-12-06T21:48:05.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-11-14T19:40:03.000Z (6 months ago)
- Last Synced: 2025-03-25T03:01:35.710Z (2 months ago)
- Topics: cooper, game-research, modding, modding-tools, ps2, ps3, sly
- Language: Python
- Homepage:
- Size: 138 KB
- Stars: 29
- Watchers: 6
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Tools
### Unpacker
**Input** for Sly 1: `WAC` + `WAL` file pair
**Input** for Sly 2/3: `WAL`
**Output**: Files contained within the archive
### Packer
**Input**: Directory with files to archive
**Output** for Sly 1: `WAC` + `WAL` file pair
**Output** for Sly 2/3: `WAL`
### Compressor
Compresses files to the LZSS-derived format that the official game expects for Sly level files.
## Templates
The `templates/` directory contains various [010 Editor](https://www.sweetscape.com/010editor/) templates for game files, in-memory data structures, memory dumps, etc that were developed during research.
This is a dump of everything that I have, some of them might have been superseeded and not useful anymore.
## Instructions
### Extracting assets
1) Download the tools from the Releases panel on the right (or build them)1)
1) If you're extracting PS2 files, move to step 7. For PS3 continue.
1) Download the [psarc]([http://www.mediafire.com/file/aegbgpkm3xfot80/psarc.zip/file](https://cdn.discordapp.com/attachments/439459490702557195/990547521858322462/psarc.exe)) tool
1) Go to your installed game's USRDIR directory (example: `C:/rpcs3/dev_hdd0/game/NPUA80663/USRDIR`).
We'll now refer to this as `$USRDIR`, replace it where appropriate.
1) Copy `psarc.exe` there (or use the full path to it in the next command)
1) Run this to extract the contents.
Replace `Sly1` with `Sly2` or `Sly3` if appropriate:
```cmd
psarc extract --input=Sly1.psarc --to=.
rename Sly1.psarc Sly1.orig.psarc
```
1) Run this to unpack the archive:
For Sly 1:
```cmd
sly_unpacker_1.exe $USRDIR/Sly1/SLY.WAC .
```
For Sly 2 and 3 (change paths as needed):
```cmd
sly_unpacker_2_3.exe $USRDIR/Sly2/SLY2.WAL .
```
After a while you should see an `extracted/` dir in there, with all the games' files.
### Repackaging assets
No detailed instructions yet, see `sly_bake.bat` and modify the paths in it accordingly.
### Modifying / re-compressing levels
No detailed instructions yet, see `sly_bake.bat` and modify the paths in it accordingly.
### Asset List
A Google Sheet with a list of all the official game's assets [is maintained here](https://docs.google.com/spreadsheets/d/1bdhTl2IvXVWOjnjhpgUTH0kg6e-RcioezIYrsi-_mso/edit?usp=sharing).
## Contact
I'm `velocity` on the [Sly Cooper Modding](https://discord.gg/gh5xwfj) Discord server.