# Community cheat packs

Generated by `tools/cheat-import/build_packs.py`; do not edit by hand. Every file in this directory is rewritten
by the generator and checked in CI, so a hand edit fails the regeneration check.

Each `packs/<CRC32>.cht` is one cartridge (bound by `vj_rom_crc32`), converted from community BigPEmu C cheat
scripts with the project's own converter. Every cheat starts disabled. `manifest.json` lists the packs with
their sha256 and the scripts and settings behind each one; `unsupported.json` is the work list of scripts and
settings the converter cannot express yet.

## Credit

- Cheats by jguffer (https://github.com/jguffer/BigPEmu_Scripts), converted by the Virtual Jaguar project with the author's permission.

## Permission

- jguffer, the author of BigPEmu_Scripts and of #1050, gave the maintainer permission to convert and use the scripts (see libretro/virtualjaguar-libretro#1071 and #1050). The repository has no license file.

## Sources

- `jguffer`: https://github.com/jguffer/BigPEmu_Scripts/tree/24211503339a969f8494b8e189b8f2aa0cb9eba6 (commit date 2026-04-15)

## How it is generated

```
python3 tools/cheat-import/build_packs.py --sources tools/cheat-import/sources.json \
    --cartridges tools/cheat-import/cartridges.json --out site/cheats
```

The generator fetches one pinned tarball per source, converts only `scripts/cheat_*.c` files (parsed, never
executed), maps each script's cartridge hash to a CRC32 through the committed hash table, and writes these
files byte-for-byte reproducibly. See [tools/cheat-import](https://github.com/libretro/virtualjaguar-libretro/tree/develop/tools/cheat-import).