Go to file
Nikolay Korolev ef59c623fd Merge remote-tracking branch 'upstream/master' 2021-01-18 23:59:16 +03:00
.github/workflows A bit more of cleanup of CI 2021-01-12 21:57:58 +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
gamefiles remake 2021-01-05 04:17:18 +03:00
src Merge remote-tracking branch 'upstream/master' 2021-01-18 23:59:16 +03:00
utils/gxt remake 2021-01-05 04:17:18 +03:00
vendor sync milessdk with re3mss 2021-01-17 22:15:49 +01: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 Add sdk to gitignore 2020-12-29 20:23:57 +02:00
.gitmodules Move stuff to vendor 2020-08-14 14:22:50 +03:00
CMakeLists.txt Make cmake files more generic 2021-01-13 12:15:22 +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
README.md Fix typo 2021-01-14 18:02:28 +01: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
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
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 remove scriptspath from premake 2021-01-13 14:34:58 +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

README.md

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.exe to GTA 3 directory and run it.

Building from Source

If you gonna use premake, then before starting 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 at the very bottom of 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)