https://github.com/falsepattern/sasqpatch
Asset file patcher for some Housemarque arcade games
https://github.com/falsepattern/sasqpatch
Last synced: 5 months ago
JSON representation
Asset file patcher for some Housemarque arcade games
- Host: GitHub
- URL: https://github.com/falsepattern/sasqpatch
- Owner: FalsePattern
- License: other
- Created: 2024-12-08T23:21:08.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-12-10T14:05:13.000Z (about 1 year ago)
- Last Synced: 2025-08-15T07:35:06.229Z (6 months ago)
- Language: Java
- Size: 151 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.MD
- License: LICENSE
Awesome Lists containing this project
README
# SasqPatch
A modding tool for patching the stream.dat asset file present in some games developed by Housemarque.
The name of this project comes from `UNP-Sasquatch`,
which is the namespace of the game engine's C++ classes used in games which use this file format. (discovered from crash reports)
Special thanks to @GoobyCorp who did the most of the initial reverse engineering of Nex Machina. This project couldn't have been done without him.
Games that are known to use this file format:
- [Nex Machina](https://housemarque.com/games/nexmachina/) (64-bit)
- [Outland](https://housemarque.com/games/outland/) (32-bit)
This project mainly focuses on patching `SCRI` assets, which are standard Lua 5.1 bytecode scripts used to define a lot of complex behaviour in these games.
Patching for other asset files is planned in the future due to file complexity.
## Dependencies
- Java 21 or newer installed on your system as the default java
## HOW TO USE
1. create the `./games/nexmachina/input` folder in this directory
2. Put `stream.dat` from Nex Machina into that input folder
3. Run `./gradlew decompile`
4. Edit scripts in `./games/nexmachina/dev`, add `--SP_recompile` to the start of the file for any scripts you want to modify
5. Run `./gradlew recompile`
6. Copy `./games/nexmachina/output/stream.dat` into Nex Machina
7. Enjoy
Outland modding not yet implemented, but it's Work in Progress.