Grand Theft Auto III / Grand Theft Auto: Vice City

About

A repository holding the fully reversed source code for GTA III (master branch) and GTA Vice City (miami branch), known as re3 and reVC. It has been tested on Windows, Linux and FreeBSD on x86, amd64, arm and arm64, and renders with either the original RenderWare or the librw reimplementation. A PS2 or Xbox build is not possible yet.

How it differs from the original

Changes listed include widescreen support, a debug menu and debug camera, a rotatable camera, XInput controller support, no loading screens between islands, and PS2 and Xbox rendering effects. Asset mods should work as with the original game, but code mods such as dll/asi and CLEO will not.

Getting started

You must own a copy of the game, as it requires the original game assets. Build it from source or download a nightly build for Windows, Linux or macOS, then extract it over your game directory and run it.

History

re3 was started in spring 2018 to test reversed collision and physics code by replacing single functions of the game with a dll, and was pushed to GitHub in May 2019. A standalone executable came in April 2020, reVC was started in May 2020 and considered finished in December, and reLCS has since been started.

Known issues & limitations

• Mods that change code, including DLL/ASI, CLEO, and limit adjusters, will not work.

What you need to run it

Features

• Rendering can use original RenderWare with D3D8 or librw with D3D9, OpenGL, or OpenGL ES.
• Audio can use MSS or OpenAL.
• There are no loading screens between islands when “map memory usage” is enabled in the menu.
• The game includes a controller configuration menu.

How to install

1. Download a listed build for Windows, Linux, or macOS.

Controls

• Press Ctrl-M to open the debug menu.
• Press Ctrl-B to toggle the debug camera.

Media

Licensing & legal

• The authors state they do not feel in a position to give the code a license, and that it should only be used for educational, documentation and modding purposes.

FAQ

What is Grand Theft Auto III / Grand Theft Auto: Vice City?

Grand Theft Auto III / Grand Theft Auto: Vice City is an open-source engine reimplementation of Grand Theft Auto III and Grand Theft Auto: Vice City. A new engine written from scratch that loads the original game's data files.

Do I need the original game files to run Grand Theft Auto III / Grand Theft Auto: Vice City?

Yes. The project does not include the original game's assets, so you need your own copy.

How is Grand Theft Auto III / Grand Theft Auto: Vice City licensed?

project: not licensed (code). The repository itself is the authoritative source.