Repolode
Submit
gothamor

gothamor/gta-vcs-recomp

A native Windows and Linux port of GTA: Vice City Stories for PS2, built by recompiling your own disc's executable into C++.

View on GitHub
Stars
505
Forks
26
Open issues
23
Last commit
11 hours ago

What is it?

This project is a native PC port of Grand Theft Auto: Vice City Stories (PS2, USA release). It recompiles the game's PS2 executable into C++ and builds it for Windows and Linux, rather than running it in an emulator. The 3D world, vehicles and menus are rendered with Direct3D 11 on Windows or Vulkan on Linux, and movies are decoded with FFmpeg.

The repository contains no game code or data. Users must supply their own USA .iso, from which the build reads the executable and the game reads its assets at runtime. A Windows launcher walks through disc selection and compilation, and manual build scripts are provided for both platforms.

The project is still in development. Its settings menu adds frame-rate independent timing (60 fps by default), widescreen and ultrawide support, higher internal resolutions, anti-aliasing, and full control rebinding, with an F5 trainer available.

Key features

  • 01Runs natively on Windows (Direct3D 11) and Linux (Vulkan) instead of in an emulator.
  • 02Frame-rate independent timing, with 60 fps by default and the original 30 fps available.
  • 03Widescreen and ultrawide modes, plus higher internal resolutions and MSAA.
  • 04Keyboard, mouse and gamepad support with every binding rebindable.
  • 05Built-in F5 trainer for vehicles, weapons, missions and world settings.

Use cases

  • Playing Vice City Stories on a modern PC at high frame rates and widescreen resolutions.
  • Running the PS2 game on Linux with a native Vulkan renderer.
  • Studying how a PS2 game's code can be statically recompiled to C++.

Quick start

  1. 1

    Download the newest Windows zip from the Releases page and extract it to a short local folder

  2. 2

    Start VCSLauncher.exe and follow its steps to pick your USA .iso, install build tools and build the game

Things to know

  • Status is in development, so many features are still incomplete.
  • You must supply your own USA release .iso (SLUS-21590); other regions are not supported.
  • The first build recompiles about 200 MB of C++ and can take 20 to 60 minutes.
  • Licensed under GPL-3.0, a copyleft license that applies to derivative works.

Topics

#game-port#static-recompilation#ps2#emulation-alternative#c++#vulkan#direct3d-11#reverse-engineering

FAQ

What is gta-vcs-recomp?
A native Windows and Linux port of GTA: Vice City Stories for PS2, built by recompiling your own disc's executable into C++. This project is a native PC port of Grand Theft Auto: Vice City Stories (PS2, USA release). It recompiles the game's PS2 executable into C++ and builds it for Windows and Linux, rather than running it in an emulator. The 3D world, vehicles and menus are rendered with Direct3D 11 on Windows or Vulkan on Linux, and movies are decoded with FFmpeg.
Is gta-vcs-recomp free to use? What license does it have?
gta-vcs-recomp is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is gta-vcs-recomp still maintained?
Actively maintained. The last commit to gta-vcs-recomp was on Nov 6, 2026.
What can I use gta-vcs-recomp for?
Playing Vice City Stories on a modern PC at high frame rates and widescreen resolutions. Running the PS2 game on Linux with a native Vulkan renderer. Studying how a PS2 game's code can be statically recompiled to C++.
How do I install gta-vcs-recomp?
Download the newest Windows zip from the Releases page and extract it to a short local folder Start VCSLauncher.exe and follow its steps to pick your USA .iso, install build tools and build the game
Where can I get gta-vcs-recomp?
The source code and installation instructions are on GitHub: https://github.com/gothamor/gta-vcs-recomp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

drakolordx7 / switch2-recomp

Windows port of Pokémon Pokopia (Switch 2) produced by static recompilation, run from your own extracted game dump.

Other#recompilation#static-recompilation#switch2
461+233 this week44C++GPL-3.0Updated 2 days ago

EstebanPdN / zelda-alttp-3ds

A native Nintendo 3DS port of The Legend of Zelda: A Link to the Past that uses the top screen for gameplay and the bottom screen for maps and menus.

Other#game-port#nintendo-3ds#homebrew
779+9 this week24CNo licenseWell maintainedUpdated 2 days ago

samuelit0davila / fifa-street-pc-port

A Windows PC port of FIFA Street (2012), recompiled from the Xbox 360 game, with a launcher, rooms and free community online play. You supply your own ISO.

Other#game-preservation#recompilation#windows
490+27 this week26C#MITWell maintainedUpdated 6 days ago