Mirror of https://github.com/GTAmodding/re3 - Automatic sync currently disabled due to DMCA from Take-Two: https://github.com/github/dmca/blob/master/2021/02/2021-02-19-take-two.md
Go to file
2021-02-03 20:55:06 +01:00
.github/workflows and a space 2021-02-03 20:26:59 +01:00
.vscode .vscode/settings: fix include path 2020-10-09 02:01:53 -04:00
cmake cmake: install files ready for copying in game folder 2021-01-11 11:24:25 +01:00
codewarrior cw: remove extras folder 2021-01-22 20:44:11 +01:00
gamefiles Merge pull request #851 from cirno-999/master 2021-02-03 21:48:07 +02:00
src Merge pull request #1019 from Sergeanur/ControllerMenu2 2021-02-03 21:43:25 +02:00
utils/gxt Merge pull request #851 from cirno-999/master 2021-02-03 21:48:07 +02:00
vendor Update OpenAL 2021-01-25 18:49:29 +02:00
.clang-format Add basic clang format file 2020-12-08 18:38:49 +01:00
.gitattributes Add .gitattributes for better language stats 2020-09-23 16:08:35 +03:00
.gitignore make building with Codewarrior 7 possible 2021-01-21 03:18:15 +01:00
.gitmodules Move stuff to vendor 2020-08-14 14:22:50 +03:00
CMakeLists.txt Update CMakeLists.txt 2021-01-28 23:19:12 +01:00
CODING_STYLE.md Separate Coding Style out into its own Document, and mention it from the Readme. 2020-09-30 06:54:57 -04:00
conanfile.py Fix 2021-01-12 23:46:11 +01:00
logo.png Changed outline to black 2020-12-23 19:00:15 +02:00
logo.svg Changed outline to black 2020-12-23 19:00:15 +02:00
premake5.exe premake: add startrpoject; add lto option; fix copying of binary to gamedir; update premake5.exe 2021-01-10 20:55:40 +01:00
premake5.lua add Vanilla config to premake and premake CI 2021-01-24 17:06:50 +01:00
premake5Linux premake: add startrpoject; add lto option; fix copying of binary to gamedir; update premake5.exe 2021-01-10 20:55:40 +01:00
premake-vs2015.cmd improvements (?) to premakefile 2020-04-29 11:44:26 +02:00
premake-vs2017.cmd improvements (?) to premakefile 2020-04-29 11:44:26 +02:00
premake-vs2019.cmd improvements (?) to premakefile 2020-04-29 11:44:26 +02:00
README.md standalone windows links to premake 2021-02-03 20:55:06 +01:00

re3 logo

Build Status

Intro

The aim of this project is to reverse GTA III for PC by replacing parts of the game one by one such that we have a working game at all times.

How can I try it?

  • re3 requires game assets to work, so you must own a copy of GTA III.
  • Build re3 or download the latest nightly build (You must be logged in.)
  • (Optional) If you want to use optional features like Russian language or menu map, copy the files in /gamefiles folder to your game root folder.
  • Move re3 executable to GTA 3 directory and run it.

Latest standalone executables to download

(Put content of selected archive into gamedir)

Building from Source

When using premake, you may want to point GTA_III_RE_DIR environment variable to GTA3 root folder, if you want executable to be moved there via post-build script.

Linux Premake

For Linux using premake, proceed: Building on Linux

Linux Conan

Obtain source code.

git clone https://github.com/GTAmodding/re3.git
cd re3
git submodule init
git submodule update --recursive

Install python and conan, and then run build.

conan export vendor/librw librw/master@
mkdir build
cd build
conan install .. re3/master@ -if build -o re3:audio=openal -o librw:platform=gl3 -o librw:gl3_gfxlib=glfw --build missing -s re3:build_type=RelWithDebInfo -s librw:build_type=RelWithDebInfo
conan build .. -if build -bf build -pf package
FreeBSD

For FreeBSD using premake, proceed: Building on FreeBSD

Windows

Assuming you have Visual Studio:

  • Clone the repo using the argument --recursive.
  • Run one of the premake-vsXXXX.cmd variants on root folder.
  • Open the project via Visual Studio

If you use 64-bit D3D9: We don't ship 64-bit Dx9 SDK. You need to download it from Microsoft if you don't have it(although it should come pre-installed after some Windows version)

If you choose OpenAL on Windows You must read Running OpenAL build on Windows.

There are various settings in config.h, you may want to take a look there. i.e. FIX_BUGS define fixes the bugs we've come across.

Did you notice librw? re3 uses completely homebrew RenderWare-replacement rendering engine; librw. librw comes as submodule of re3, but you also can use LIBRW enviorenment variable to specify path to your own librw.

Contributing

Please read the Coding Style Document

Unreversed / incomplete classes (at least the ones we know)

The following classes have only unused or practically unused code left:

NameGrid.cpp - only on mobile (a player name grid, either a very early player name code ala GTA1 or a multiplayer leftover)
PedDebug.cpp - only on mobile (debug code)
HandlingMgr.cpp - debug functions from mobile
CFormationInfo - unused PedAI class that could be found on mobile
CVehicle::ProcessBikeWheel - early bike code (only on mobile)
CAutomobile::DebugCode - debug function from mobile
CBoat::DebugCode - debug function from mobile
CBoat::ModifyHandlingValue - debug function from mobile
CBoat::DisplayHandlingData - debug function from mobile
CStreaming::PrintRequestList - debug function from mobile
d3d8raster.c - only on PC (slight RW modification that we don't actually need)