Windows games → editable C source → native Linux/macOS builds
Recompile legacy Windows PC games using PCRecomp, rev.ng, and reusable runtime shims.
Quick start · Screenshots & proof · Roadmap · Toolchain · Contribute
Windows game.exe → recover & lift → generate C → compile → run → verify
- Generates a rebuildable C source project and native executable with Windows API shims.
- Uses rev.ng for higher-level source recovery; preserves a low-level fallback where needed.
- Records build provenance, execution results, and verification evidence. Currently supports PE32 (x86) inputs.
Cave Story (Doukutsu.exe) — the rebuilt game reaches its frame loop and renders. 143/143 imports bind; the run is classified partial, not independently verified playable gameplay.
 Intro frame |
 Animation |
 Later captured frame |
| Evidence | Current result |
|---|---|
| Independently verified playable games | 0 |
| Cave Story | Rendering/frame loop observed; partial |
| Source recovery | 18/955 rev.ng provider functions with scoped differential certifications in the documented experiment |
Evidence: Game matrix · Verification methodology · Reports. Captured frames demonstrate rendering, not gameplay equivalence. Upstream PCRecomp game successes are documented separately in the matrix and are not counted as GameReComp-verified ports.
Planned targets, not verified playable ports. Priorities and supported games will evolve based on progress, contributions, and community requests. Suggest a title in GitHub Issues.
| Series | Planned games | Priority |
|---|---|---|
| Project I.G.I. | Project I.G.I. (2000) | P0 |
| Hitman | Codename 47, Hitman 2: Silent Assassin, Contracts, Blood Money | P1–P2 |
| Max Payne | Max Payne, Max Payne 2 | P1 |
| TrackMania | Nations ESWC, Nations Forever, United Forever | P2–P3 |
Full game test matrix · Request another game
Windows PE32 game
↓
PE analysis + Capstone / PCRecomp lifting ── rev.ng (higher-level C recovery)
↓
Generated C (rev.ng also works with LLVM IR)
↓
ABI bridge + recomp32 / win32hle runtime shims (SDL2, DirectDraw, DirectSound)
↓
CMake + C compiler (Clang or GCC)
↓
Native executable → runtime checks + Unicorn differential tests → reports
| Component | Role |
|---|---|
| PCRecomp / Capstone | Function discovery and executable-oriented x86-to-C lifting |
| rev.ng / LLVM | Higher-level C recovery and LLVM-based lifting infrastructure |
recomp32 + win32hle / SDL2 |
Guest execution model, Win32 and game runtime shims |
| CMake + Clang / GCC | Native project generation and compilation |
| Unicorn | Differential testing of machine-code behavior |
Note: The current executable path is PCRecomp-generated C → C compiler. rev.ng-based readable-source replacement and multi-lifter fallback are being developed; LLVM IR is not currently the required build artifact. Architecture · Lifter fallback roadmap
Requirements: Python 3.10+, Capstone 5, CMake 3.16+, C compiler, pkg-config, SDL2, SDL2_ttf.
git clone https://github.com/heaven-hm/GameReComp.git
cd GameReComp
python3 -m pip install capstone
python3 -m tools.autorecomp.cli /path/to/game.exe
python3 -m tools.autorecomp.cli /path/to/game.exe --interactiveGenerated files: projects/<game>/src/ (C), build/ (binary), reports/ (evidence). Supply your own legally obtained game executable and assets. Installation & troubleshooting →
More commands
python3 -m tools.autorecomp.cli /path/to/game.exe --assets-dir /path/to/game/assets
python3 -m tools.autorecomp.cli /path/to/game.exe --no-build --no-run
python3 -m tools.autorecomp.cli /path/to/game.exe --timeout 60 --json
sh verify.sh --fastContributions to binary lifting, readable C recovery, runtime shims, and reproducible gameplay tests are welcome. Check open issues, run sh verify.sh --fast, then open a pull request with test evidence. Do not commit proprietary game binaries or assets.