other | ||
.gitattributes | ||
knownissues.md | ||
README.md | ||
source-code-links.md | ||
workingstatus.md |
📜 --> GTA V Source Code Build Guide <-- 📜
🖥️ Working Status of Tools and Game: See Here
🔨 Known Bugs, Errors and Issues: See Here
⚠️ If you having any problem, let us know in the "Issues" section of this repository!
💬 You can check out "Discussions" for talking and discuss.
📩 You can contact me from discord: yungdoomofficial
Prerequisites
Base
- Windows 10/11
- LTSC 2021 Recommended, but you can use Normal Windows 10/11 too.
- Latest Grand Theft Auto V Files from Steam, Epic Games or maybe Rockstar Games Launcher.
- Minimum 65GB Free Space, 140GB+ is Recommended because of the game files and programs.
- GTAVSP.7z - Source Code
- Download Link: All Available Download Links
- Archive Password:
Mi76#b>9mRed
- You can verify the authenticity of the file by its SHA1 hash:
ca39323730ed644fa534a2946506d4287f92a799
- To verify with 7-Zip, right click the file and select
7-Zip > CRC SHA > SHA1
- To verify with 7-Zip, right click the file and select
- update.rpf and update2.rpf from GTA V build 2699
- Some Patience and Technical Competence
Dependencies
- Visual Studio 2012
- DirectX SDK June 2010
- (OPTIONAL) 3D Studio Max 2010 SDK
- Incredibuild 4.0
- This is only needed for Compiling Shaders and Game Scripts.
- 7-Zip
- For extracting the archives.
- OpenIV
- For editing the game files.
Miscellaneous
- Rush Patches
- DLL Patches
- (OPTIONAL) 3rdParty Folder
- (OPTIONAL) gIKgDXuVHNzIgXkiwpB.zip - Art Asset Leak
- Mirror Link, Thanks to @RockstarAdvancedGameEngine.
- (OPTIONAL & NOT STABLE) Visual Studio 2022 Patches
- Presented by @userTermzik, but i don't recommend this because it needs some modifications.
Prebuilt Files
- Shaders (You can build your own shaders and play with them without any problem.)
- Scripts (Already included, You can build your own scripts and play with them without any problem.)
Note
It is recommended to create a virtual machine for this build process, Although the build process can be done on your Real PC
It's not recommended on your Real PC because sometimes the conflicts may happen and broke the whole compilation process
VMWare/Hyper-V are recommended to run the Virtual Machine due to their performance.
Prerequisites Setup
- Install DirectX SDK June 2010
- Install 7-Zip
- Install Visual Studio 2012
- Uncheck all optional components in the installer except "Microsoft Foundation Classes for C++" to save space, none of them are needed for the build.
- Install Update 4 for Visual Studio 2012
- Install Incredibuild 4.0 (Only needed for compiling shaders and scripts)
- If you encounter the error that the installer is "Blocked by your administrator", follow these steps:
- Hold Shift and right click the
incredibuild4_0.exe
file, select "Copy as path" - Open Command Prompt as Administrator
- Paste the path and press Enter
- Hold Shift and right click the
- Select to install "Incredibuild Agent", "Incredibuild Coordinator", and the extension for Visual Studio
- If you encounter the error that the installer is "Blocked by your administrator", follow these steps:
- Install OpenIV
- Install DLL Patches and Rush Patches
- (OPTIONAL) Install 3D Studio Max 2010 SDK
- Create X:\ Drive by following the steps at the bottom:
- Open Command Prompt
- Create a new folder called "GTA" to the Desktop or anywhere that you want
- Run
net use X: \\localhost\c$\<Path to working folder for build> /persistent:yes
- Example:
net use X: \\localhost\c$\Users\abcd\Desktop\GTA /persistent:yes
- Example:
- Create the folder
X:\gta5
and copy all folders fromGTAVSP.7z\GTA V Source
into it - Right click the folder
X:\gta5
, select "Properties", uncheck "Read-only", click Apply then OK - Open Command Prompt as Administrator and run the following commands, then close:
setx /m RS_TOOLSROOT X:\gta5\tools_ng
setx /m DXSDK_DIR "C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)"
setx /m RS_CODEBRANCH X:\gta5\src\dev_ng
setx /m RS_PROJECT gta5
- To ensure changes are finalized, restart build machine/computer.
Patching The Source Code
- Open
rush_patches-master.zip
- Copy
game
andrage
folders toX:\gta5\src\dev_ng
, make sure to overwrite when copying - (OPTIONAL) To skip launcher requirement for running the game, copy
game
andrage
folders fromrush_patches-master.zip\OPTIONAL_FIXES
to the same folder - Copy all folders in
dll_patches_x.zip
toX:\gta5\tools_ng\bin
, make sure to overwrite when copying - (OPTIONAL) Install 3rdParty Folder, Extract and Put the folder to
X:\gta5\
.
By far, Your Folder Structure should look like this:
🖥️ X:
┗ 📂 gta5
┣ 📂 3rdParty - (OPTIONAL)
┣ 📂 src
┣ 📂 script
┗ 📂 tools_ng
Building The Game Binary/Executable
- Run
X:\gta5\src\dev_ng\game\VS_Project\load_sln_unity_2012.bat
- If prompted with "How do you want to open this file?", check "Always use this app to open .sln files" and Select Visual Studio 2012 then click OK
- Once the solution loads, open the dropdown menu that says "Debug" at the top, select "Configuration Manager"
- Change "Active Solution Platform" to "x64" and close the configuration window
- Hold Ctrl key and click all projects under "GameLibs" and "Rage" folder, right-click and select "Properties"
- In the "Configuration" dropdown, select "All Configurations"
- Select
C/C++ > All options
, under "Look for options or switches", search "err" and set "Treat Warnings as Errors" to "No (/WX-)", then click "Apply" and "OK"- For faster compiles, search "mul" and set "Multiprocessor Compilation" to "Yes (/MP)"
- If you get the error
C1060: Compiler is out of heap space
during build, come back to the above setting and turn it off
- If you get the error
- For faster compiles, search "mul" and set "Multiprocessor Compilation" to "Yes (/MP)"
- Right-click the "game" project and select "Properties" and do step 5,6 again
- Change build the type at the top of the window from "Debug" to "BankRelease"
- At the top of the window, select
Build > Build Solution
and wait for build to finish - Copy output binary to game folder.
Warning
Building shaders and scripts can be skipped using the prebuilt files above
These steps are here to allow modding or for those who prefer to build from source as much as possible
If you prefer using prebuilt files, here is all the instruction to make them work.
Building Shaders
- Under "Shaders", right click the "shaders_rc" project and click "Build"
- (OPTIONAL) Build low quality shaders
- Right click the "shaders_rc" project and click "Properties"
- Select
Configuration Properties > NMake
- Under "General", change all command lines from ending with
win32_40.bat
to ending withwin32_40_lq.bat
, then click "Apply" and "OK" - Rebuild shaders and wait it to finish
- Copy
X:\gta5\titleupdate\dev_ng\common
to game directory.
Building Game Scripts
- Open Command Prompt and Run the following commands:
X:
cd X:\gta5\src\dev_ng
setenv
cd ..\..\tools_ng\bin\RageScriptEditor
ragScriptEditor
- In the editor, select
File > Open Project
and openX:\gta5\script\dev_ng\singleplayer\GTA5_SP.scproj
- Select
Compiling > Intellibuild > Build Project
and wait until the compiling process finishes. - Run OpenIV, select "Windows" under "Grand Theft Auto V"
- Select the game folder and click "Continue"
- Open
<Game Directory>\update\update2.rpf\x64\levels\gta5\script
- Delete
script.rpf
- Click the "Edit mode" button, and copy
X:\gta5\titleupdate\dev_ng\x64\levels\gta5\script\script.rpf
to the OpenIV window.
Patching Game Assets
- Install
update.rpf and update2.rpf from GTA V build 2699
from Prerequisites List - Put
update.rpf
andupdate2.rpf
files to<Game Directory>\update\
folder- Dont forget to backup your old files from update folder.
Modifying the RPF Files
If you ever modify the RPF files, dont forget to encrpyt them.
Here you can see how to do it:
- From
rush_patches-master.zip
, copy all files in theARCHIVEFIX
folder to a separate location - Drag RPF file(s) onto
ArchiveFix.exe
- Don't drag the both files at the same time, just drag one by one, This will not work with that way.
Prebuilt Stuff
Prebuilt Shaders
- Go to game directory
- Put the
common
folder to the game directory.
Prebuilt Scripts
- Scripts Already included in update2.rpf, you can replace it in future with one that you builded it.
Running The Game
- In the game directory, create a file named
launch.bat
and add these contents:
cd %~dp0
game_win64_bankrelease.exe -noSocialClub -nokeyboardhook -nonetlogs
- (OPTIONAL) Add additional arguments:
-kbgame
- Start game with game keyboard enabled-output
- Show console log of game, the game opens a little bit slow.-rag
- Enable support for RAG, the internal game debugging tool-ragUseOwnWindow
- Use it with-rag
parameter to make game run outside of RAG Render Window- DO NOT Forget to Launch RAG Before launching the game if u using any RAG parameters
-DoReleaseStartup
- Start real Story Mode on launch, Ignore if it says unknown parameter/command- If you dont type this parameter, you will spawned in a random location as a random character with a random clothes
- Additional standard game arguments can be added as well.
- (OPTIONAL) Launch RAG with the following commands in Command Prompt:
X:
cd X:\gta5\src\dev_ng
setenv
cd ..\..\tools_ng\bin\rag
rag
- Run
launch.bat
BankRelease & Debug Controls
Final Thoughts
Thanks for reading my precious tutorial, please consider starring or forking the repository if this helped u
Feel free to contribute the repository, you'll be welcomed if you dont make stupid thingies.