# Rising Zan: The Samurai Gunman Recompiled

Static recompilation of **Rising Zan: The Samurai Gunman** (USA, SLUS-00829)
built on [psxrecomp](https://github.com/mstan/psxrecomp) and
[recomp-ui](https://github.com/mstan/recomp-ui).

## Repository name note

This repository is named **Rising-Zan-The-Samurai-Gundam-Recomp**, but the game
contained within it is **Rising Zan: The Samurai Gunman** — the 1999 Taito
beat-'em-up, USA release. The repository URL was not renamed per your
instruction; the mismatch is noted here so users are not confused.

## Legal

You must own the original game. Disc images under `disc/` are gitignored and
must never be committed. Retail BIOS dumps are not redistributed; OpenBIOS is
used for Generate unless you supply your own SCPH locally.

## Quick start (dev)

```bash
git clone --recurse-submodules \
  https://github.com/omegakatana92/Rising-Zan-The-Samurai-Gundam-Recomp.git
cd Rising-Zan-The-Samurai-Gundam-Recomp
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DPSX_SDL_BACKEND=SDL2
cmake --build build --target psx-runtime
```

## Status

- Boot EXE: `SLUS_008.29` (extracted from `Rising Zan - The Samurai Gunman (USA).cue`)
- Serial: `SLUS-00829`, Volume ID: `RISING_ZAN`
- Load address: `0x80010000`, Entry PC: `0x80012B48`
- Text size: `0x00080800`, Stack base: `0x801FFFF0`
- Seeds: 695 (first-pass JAL scan)
- OpenBIOS: enabled by default
- SDL backend: SDL2 (Windows)
- See `docs/BUILDING.md` for full instructions.