https://github.com/gerbilsoft/hack-detection
*** HACK DETECTION ***
https://github.com/gerbilsoft/hack-detection
hack-detection rom-hacking
Last synced: 3 months ago
JSON representation
*** HACK DETECTION ***
- Host: GitHub
- URL: https://github.com/gerbilsoft/hack-detection
- Owner: GerbilSoft
- License: agpl-3.0
- Created: 2017-07-08T02:51:21.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-07-08T04:19:07.000Z (over 8 years ago)
- Last Synced: 2025-08-26T02:02:28.073Z (5 months ago)
- Topics: hack-detection, rom-hacking
- Language: C
- Size: 59.6 KB
- Stars: 11
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# *** HACK DETECTION ***
This is a simple command line utility that can check if a ROM hack appears
to be a hex-edited binary hack instead of a hack based on a disassembly.
It works by checking how many bytes in the two ROMs match and how many
differ. If more than 50% of the bytes are identical, it is assumed to be
a hex-edited binary hack.
If the source ROM has extra padding at the end (due to ROM chips being
powers-of-two sizes), the padding is ignored. Only the used area is checked.
If the hacked ROM is smaller than the source ROM, then anything past the
hacked ROM's size in the source ROM is ignored.
## How to use:
```
$ hack-detection [Source ROM] [Hacked ROM]
```
* Source ROM: The original ROM, e.g. "Sonic 1 Rev00.gen".
* Hacked ROM: The hacked ROM, e.g. "Sonic 1337.gen".
## Screenshots
These examples use Sonic 1 Rev00 as the source ROM and
[Sonic 1337](https://info.sonicretro.org/Sonic_1337) as the hacked ROM.
## How to compile
* On Linux or other Unix-like systems: `./build-gcc.sh`
* On Windows, using MSVC (2010 or later): Run `build-msvc.bat` from an MSVC command prompt.
Tested on the following platforms:
* Gentoo Linux (amd64)
* OpenBSD (amd64)
* Windows XP (i386)
* Windows 7 (amd64)
## License
hack-detection is licensed under the GNU AGPLv3. See [LICENSE](LICENSE)
for more information.