andrewnakas/gtav-recomp

选用指南

AI 根据 README 整理 · 2026/11/3 07:36:44

使用方式

通过启动器安装游戏并运行，支持命令行参数；iPhone和Android版本需先在电脑上构建。

查看 README 依据

- **For the phones** (optional): see [iPhone](#iphone) and [Android](#android). ## Windows 1. Download `gtav-recomp-windows-x64.zip`, unzip it somewhere with enough space, and run `gtav_launcher.exe`. 2. Pick **Disc 1**, **Disc 2** and the **title update** (File... or Folder...), then press **Install**. 3. When setup finishes, press **Play**. Later: running `gtav_launcher.exe` starts the game directly. Hold **Shift** while starting it to get the setup window (redo setup, or **Build for iPhone** / **Build for Android**). Logs: `data\logs`. ## Linux

1. Download `gtav-recomp-linux-x64.tar.gz` and unpack it: `tar xf gtav-recomp-linux-x64.tar.gz`. 2. Open `gtav_launcher` (double-click it, or run `./gtav_launcher`). The setup window opens: choose Disc 1, Disc 2 and the title update, then press **Install**. (Without a desktop, setup runs in the terminal: `./gtav_launcher --setup "Disc 1.iso" "Disc 2.iso" tu00000009_00000000`.) 3. Press **Play**. Setup also adds "GTA V recomp" to your applications menu. Later: the menu entry or `./gtav_launcher` starts the game. `./gtav_launcher --setup` (or the menu

1. **Install and play the game on your computer first, for a while.** The phone gets the shaders your computer has seen, so drive around and go inside some buildings. 2. **Build for iPhone.** Open the setup window (Windows: hold Shift starting the launcher; macOS: hold Option opening the app; Linux: `./gtav_launcher --setup`) and press **Build for iPhone** (or run the launcher with `--iphone`). It takes about 15-25 minutes and shows you `iphone/GTAV.ipa` in your game folder. 3. **Install the ipa** with Sideloadly or AltStore, with the iPhone connected.

部署要求

需要自备Xbox 360版GTA V光盘（Disc 1和Disc 2）及TU27更新；电脑需8GB内存、约25GB磁盘空间，Windows需AVX2 CPU和Vulkan驱动，macOS需Apple silicon，Linux需glibc 2.35和GCC 13。

查看 README 依据

reference hashes. Every release is taint-scanned against the game's files and the code generated from them. ## What you need - **Your own GTA V for Xbox 360**: Disc 1 (Install) and Disc 2 (Play), as ISO images or extracted folders, and **Title Update 27** (the `tu00000009_00000000` file from your console, or a folder with `disc002/default.xexp` and `disc002/update.rpf`). Other title updates won't work: the recompilation is made for TU27's executable. - **A computer** (pick one): | | Windows | Linux | macOS | |---|---|---|---|

| OS | Windows 10/11 x64 | x86-64 with glibc 2.35 + GCC 13 libstdc++ (Ubuntu 24.04, Debian 13, Fedora 39, Arch...) | macOS 15 or newer | | CPU | AVX2 (Intel Haswell / AMD Zen or newer) | AVX2 | Apple silicon (M1 or newer) | | GPU | Vulkan driver | Vulkan driver + loader | built in (Metal) | | Extra | none (the Visual C++ runtime is included) | a desktop session (X11 or Wayland) | none | 8 GB RAM or more. About 25 GB free during setup, about 17 GB afterwards. A controller is recommended (Xbox or PlayStation through SDL; Windows: XInput). The keyboard works on Mac and Linux.

已知限制

iPhone需iOS 17+和A14芯片，免费Apple ID签名每7天需重新签名；Android需Snapdragon芯片；手机性能受热降频影响。

查看 README 依据

Later: opening `GTAV.app` starts the game. Hold **Option** while opening it to get the setup window with **Build for iPhone** / **Build for Android**. Esc in game opens the settings menu. ## iPhone Needs an **iPhone 12 or newer** (A14 chip or later) on **iOS 17+**, about **17 GB** free, and a sideloading tool that signs apps with your own Apple ID: [Sideloadly](https://sideloadly.io) (Windows, macOS) or [AltStore](https://altstore.io). A free Apple ID works, but the app has to be re-signed every 7 days.

Controls: on-screen touch controls; a Bluetooth controller hides them. The game renders at 75% of 720p. **Missing objects?** Copy the phone's `GTA V/shader_cache` folder to `iphone/shader_cache` in your game folder, press Build for iPhone again (a few minutes) and reinstall the ipa. Your game files on the phone stay. ## Android Needs a recent **Snapdragon** phone (tested: Galaxy S23 FE, Snapdragon 8 Gen 1) with about 40 GB free during setup. 1. **Install and play the game on your computer first, for a while** (as for iPhone).

**Missing objects?** Copy the phone's `Android/data/com.gtavrecomp.app/files/shader_cache` folder to `android/shader_cache` in your game folder, press Build for Android again, and choose the new pack on the phone. ## Performance Rough numbers measured during development; your hardware will differ. | Device | Typical | |---|---| | Apple M1 Mac (8 GB) | ~45-60 fps in the open world | | iPhone 13 mini | ~30 fps in the city and the prologue, ~20 fps in the heaviest scenes; slower when the phone is hot | | Galaxy S23 FE | ~28-29 fps cool, 14-17 fps when thermally throttled (on the charger) |