AsobiCodes / rac-rs

# rac-rs
An unofficial PC port of **Ratchet & Clank** (PlayStation 2, 2002), written in Rust. It runs the full game, start to credits, from **your own disc**.
> **No game data is included.** This repository contains no game code, graphics, sound, text or other game files.
> The setup reads your own copy of the disc and creates everything it needs on your PC. You need to own the game.
Project site: https://asobicodes.dev
Support the project (no pressure tho!): https://ko-fi.com/asobicodes
## Status
- The whole game is playable from power-on to the end credits, including New Game+.
- Gameplay follows the original PS2 game one to one. On top of that, the PC version has widescreen, keyboard and mouse controls, gamepad support, and an optional modern camera (mouse look and strafing).
- Optional modern graphics on the Graphics page (Pause > Options > Graphics): enhanced lighting, ambient occlusion, dynamic shadows, clear reflective water, enhanced smoke, fire and explosions, and sun rays. The Classic settings keep the original PS2 look.
- Plays from the PAL / Europe disc and, since v0.2, from the USA disc.
- Windows only for now.
- Known issues are listed under Known issues below.
## How it works
The game runs on its own original code. When you run setup, it translates the PS2 code from your disc into native Rust ("static recompilation"), and that code runs on a PS2 CPU core written in Rust. Because the game logic is the original code, gameplay behaves exactly like the PS2 version.
Everything around the game code is native PC code written for this port: graphics, sound, movies, input, saving, and the PC features. Where a fix or a PC feature needs it, an original function is rewritten in readable Rust. Changes are tested against the original: test runs play the same frames on both versions and compare the game's memory.
## Goal
A faithful, fully playable PC version of Ratchet & Clank that you build from your own disc, with PC improvements on top. The game logic stays the original code. Rewriting the whole game from scratch is not a goal of this project.
## What you need
- **The game disc:** Ratchet & Clank, **PAL / Europe v1.00** (serial SCES-50916) or **USA v1.00** (serial SCUS-97199). Make an `.iso` image of **your own** disc. Other versions (Japan, Platinum and Greatest Hits re-releases) are not supported yet. Setup checks the image.
- **About the USA version:** it should play the same as the PAL version (at 60 frames per second, like the original US game), but it has had less testing so far. If something looks or behaves differently from the PAL version, please open an issue here on GitHub.
- **Windows 10 or 11, 64-bit**, with about **5 GB of free disk space** (the finished install takes about 3.5 GB) and an internet connection for the first setup.
That's all. Setup downloads anything else it needs into its own folder.
## Setup
1. Click the green **Code** button above, choose **Download ZIP**, and unzip it anywhere.
2. Double-click **Setup.cmd**. A