# Mega Man 8 Recompiled

Experimental native recompilation of the USA PlayStation release of **Mega
Man 8**, built on the shared
[`psxrecomp-tweaks`](https://github.com/douglasjv/psxrecomp-tweaks) framework.

This source-only repository does not distribute the game, a PlayStation BIOS,
extracted executables, generated C, or build products. You must supply your own
legally obtained disc image and BIOS.

## Current status

The exact USA disc revision has been identified as `SLUS-00453`. The baseline
configuration intentionally starts faithful: 4:3 presentation, native timing,
and digital controls. Build and runtime findings are recorded in
[`docs/baseline.md`](docs/baseline.md); enhancement investigations are kept in
[`docs/enhancements/`](docs/enhancements/).

## Local setup on macOS

Requirements: CMake, Ninja, pkg-config, SDL2, Python 3, and MAME `chdman`.

1. Clone recursively.
2. Place `Mega Man 8 (USA).chd` at the repository root, or pass its path to
   `./tools/extract_chd.sh`.
3. Place a legally obtained 512 KiB `SCPH1001.BIN` at
   `psxrecomp/bios/SCPH1001.BIN`.
4. Run `./tools/extract_chd.sh` and `./tools/build-macos.sh`.
5. Launch with:

```sh
./build/Mega_Man_8_Recompiled --no-launcher --game game.toml \
  --disc disc/MegaMan8.cue --renderer opengl
```

Local inputs and generated files are ignored. See
[`docs/local-inputs.md`](docs/local-inputs.md) for hashes and expected paths.

## Legal

Mega Man and all game assets belong to their respective owners. This project
contains integration source and reproducible tooling only.