celisej567/gtav-sourcecode-build-guide
1
0
Fork 0
mirror of https://github.com/RockstarAdvancedGameEngine/gtav-sourcecode-build-guide.git synced 2026-09-23 20:09:49 +03:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Smashtika
2024-04-21 00:36:41 +03:00
committed by GitHub
parent 15ee9f898b
commit 985e844d70
1 changed files with 68 additions and 43 deletions
Download Patch File Download Diff File Expand all files Collapse all files

111
README.md
View File

@@ -1,6 +1,8 @@
![Icon](/misc/design/icon.png) <!-- Made with ❤️ by Smashtika(@yungDoom) -->
# 📜 GTA V Source Code Build Guide ![Icon](/misc/design/iconv2/iconv2.png)
# 📜 GTA V Source Code Build Guide V2
🖥️ **Working Status of Tools and Game:** [See Here](/workingstatus.md)<br> 🖥️ **Working Status of Tools and Game:** [See Here](/workingstatus.md)<br>
🔨 **Known Bugs, Errors and Issues:** [See Here](/knownissues.md) 🔨 **Known Bugs, Errors and Issues:** [See Here](/knownissues.md)
@@ -19,8 +21,8 @@
- Archive Password: `Mi76#b>9mRed` - Archive Password: `Mi76#b>9mRed`
- You can verify the authenticity of the file by its SHA1 hash: `ca39323730ed644fa534a2946506d4287f92a799` - 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 `7-Zip > CRC SHA > SHA1`
- [update.rpf and update2.rpf from GTA V build 2699](https://mega.nz/file/3j5yAYzR#guzO1Yw80efLfmHIPdY8gcPFAHJn7ncF1voadjdpaLE) - [update.rpf and update2.rpf from GTA V build 2699](https://mega.nz/file/PzJ3DC4R#PAQei9OwOEboB4o5oN2TFmb7KmRFRTvlcKVlZ5zhj3o)
- Some Patience, Brain and Knowledge. - Some Patience and Technical Competence
### Dependencies ### Dependencies
- [Visual Studio 2012](https://files.dog/MSDN/Visual%20Studio%202012/en_visual_studio_ultimate_2012_x86_dvd_2262106.iso) - [Visual Studio 2012](https://files.dog/MSDN/Visual%20Studio%202012/en_visual_studio_ultimate_2012_x86_dvd_2262106.iso)
@@ -44,6 +46,8 @@
- [Shaders](https://github.com/WH0LEWHALE/gtav-sourcecode-build-guide/files/14649717/common.zip) - [Shaders](https://github.com/WH0LEWHALE/gtav-sourcecode-build-guide/files/14649717/common.zip)
- [Scripts](https://drive.google.com/file/d/1AVMC_MBPpqKp0BIrOI-_lLq98QmwRn46/view) - [Scripts](https://drive.google.com/file/d/1AVMC_MBPpqKp0BIrOI-_lLq98QmwRn46/view)
___
> [!NOTE] > [!NOTE]
> It is recommended to create a virtual machine for this build process, Although the build process can be done on your Real PC. VMWare/Hyper-V are recommended to run the VM due to their performance. > It is recommended to create a virtual machine for this build process, Although the build process can be done on your Real PC. VMWare/Hyper-V are recommended to run the VM due to their performance.
@@ -55,12 +59,12 @@
4. Install Update 4 for Visual Studio 2012 4. Install Update 4 for Visual Studio 2012
5. Install Incredibuild 4.0 (Only needed for compiling shaders and scripts) 5. 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: - If you encounter the error that the installer is "Blocked by your administrator", follow these steps:
1. Hold Shift and right click the `incredibuild4_0.exe` file, select "Copy as path" 1. Hold Shift and right click the `incredibuild4_0.exe` file, select "Copy as path"
2. Open Command Prompt as Administrator 2. Open Command Prompt as Administrator
3. Paste the path and press Enter 3. Paste the path and press Enter
- Select to install "Incredibuild Agent", "Incredibuild Coordinator", and the extension for Visual Studio. - Select to install "Incredibuild Agent", "Incredibuild Coordinator", and the extension for Visual Studio.
6. Install OpenIV 6. Install OpenIV
7. Install Miscellaneous Files 7. Install [DLL Patches and Rush Patches](#miscellaneous)
8. (OPTIONAL) Install 3D Studio Max 2010 SDK 8. (OPTIONAL) Install 3D Studio Max 2010 SDK
9. Create X:\ Drive by following the steps at the bottom: 9. Create X:\ Drive by following the steps at the bottom:
1. Open Command Prompt 1. Open Command Prompt
@@ -68,9 +72,9 @@
3. Run `net use X: \\localhost\c$\<Path to working folder for build> /persistent:yes` 3. 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: `net use X: \\localhost\c$\Users\abcd\Desktop\GTA /persistent:yes`
10. Create the folder `X:\gta5` and copy all folders from `GTAVSP.7z\GTA V Source` into it 10. Create the folder `X:\gta5` and copy all folders from `GTAVSP.7z\GTA V Source` into it
11. Right click the folder `X:\gta5`, select "Properties", uncheck "Read-only", click Apply then OK 11. Right click the folder `X:\gta5`, select "Properties", uncheck "Read-only", click Apply then OK.
12. Copy all folders in `dll_patches_x.zip` to `X:\gta5\tools_ng\bin`, make sure to overwrite when copying. 12. Copy all folders in `dll_patches_x.zip` to `X:\gta5\tools_ng\bin`, make sure to overwrite when copying.
13. (OPTIONAL) Install 3rdParty Folder, Extract and Put the folder to `X:\gta5\` 13. (OPTIONAL) Install 3rdParty Folder, Extract and Put the folder to `X:\gta5\`.
14. Open Command Prompt as Administrator and run the following commands, then close: 14. Open Command Prompt as Administrator and run the following commands, then close:
```batch ```batch
setx /m RS_TOOLSROOT X:\gta5\tools_ng setx /m RS_TOOLSROOT X:\gta5\tools_ng
@@ -80,7 +84,7 @@ setx /m RS_PROJECT gta5
``` ```
15. To ensure changes are finalized, restart build machine/computer. 15. To ensure changes are finalized, restart build machine/computer.
* By the end, Your Folder Structure should look like this: **By the end, Your Folder Structure should look like this:**
``` ```
🖥️ X: 🖥️ X:
┗ 📂 gta5 ┗ 📂 gta5
@@ -92,39 +96,38 @@ setx /m RS_PROJECT gta5
## Patching The Source Code ## Patching The Source Code
1. Open `rush_patches-master.zip` 1. Open `rush_patches-master.zip`
2. Copy `game` and `rage` folders to `X:\gta5\src\dev_ng`, make sure to overwrite when copying 2. Copy `game` and `rage` folders to `X:\gta5\src\dev_ng`, make sure to overwrite when copying.
3. (OPTIONAL) To skip launcher requirement for running the game, copy `game` and `rage` folders from `rush_patches-master.zip\OPTIONAL_FIXES` to the same folder 3. (OPTIONAL) To skip launcher requirement for running the game, copy `game` and `rage` folders from `rush_patches-master.zip\OPTIONAL_FIXES` to the same folder.
## Building The Game Binary ## Building The Game Binary
1. Run `X:\gta5\src\dev_ng\game\VS_Project\load_sln_unity_2012.bat` 1. 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. - 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.
2. Once the solution loads, open the dropdown menu that says "Debug" at the top, select "Configuration Manager" 2. Once the solution loads, open the dropdown menu that says "Debug" at the top, select "Configuration Manager"
3. Change "Active Solution Platform" to "x64" and close the configuration window 3. Change "Active Solution Platform" to "x64" and close the configuration window.
4. Hold Ctrl key and click all projects under "GameLibs" and "Rage", right-click and select "Properties" 4. Hold Ctrl key and click all projects under "GameLibs" and "Rage" folder, right-click and select "Properties".
5. In the "Configuration" dropdown, select "All Configurations" 5. In the "Configuration" dropdown, select "All Configurations".
6. 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" 6. 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)". - 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 `C1060: Compiler is out of heap space` during build, come back to the above setting and turn it off.
7. Right-click the "game" project and select "Properties" and do step 5 again 7. Right-click the "game" project and select "Properties" and do step 5 again.
8. Change build the type at the top of the window from "Debug" to "BankRelease" 8. Change build the type at the top of the window from "Debug" to "BankRelease".
9. At the top of the window, select `Build > Build Solution` and wait for build to finish. 9. At the top of the window, select `Build > Build Solution` and wait for build to finish.
10. Copy output binary to game folder. 10. Copy output binary to game folder.
> [!NOTE] > [!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. > Building shaders and scripts can be skipped using the [prebuilt files above](#prebuilt-files). These steps are here to allow modding or for those who prefer to build from source as much as possible.
## Building Shaders ## Building Shaders
1. Under "Shaders", right click the "shaders_rc" project and click "Build" 1. Under "Shaders", right click the "shaders_rc" project and click "Build"
2. (OPTIONAL) Build low quality shaders 2. (OPTIONAL) Build low quality shaders
1. Right click the "shaders_rc" project and click "Properties" 1. Right click the "shaders_rc" project and click "Properties"
2. Select `Configuration Properties > NMake` 2. Select `Configuration Properties > NMake`
3. Under "General", change all command lines from ending with `win32_40.bat` to ending with `win32_40_lq.bat`, then click "Apply" and "OK" 3. Under "General", change all command lines from ending with `win32_40.bat` to ending with `win32_40_lq.bat`, then click "Apply" and "OK".
4. Rebuild shaders 4. Rebuild shaders..
5. Copy `X:\gta5\titleupdate\dev_ng\common` to game directory 3. Copy `X:\gta5\titleupdate\dev_ng\common` to game directory.
## Building Game Scripts ## Building Game Scripts
1. Open Command Prompt 1. Open Command Prompt and Run the following commands:
2. Run the following commands:
```batch ```batch
X: X:
cd X:\gta5\src\dev_ng cd X:\gta5\src\dev_ng
@@ -132,25 +135,45 @@ setenv
cd ..\..\tools_ng\bin\RageScriptEditor cd ..\..\tools_ng\bin\RageScriptEditor
ragScriptEditor ragScriptEditor
``` ```
3. In the editor, select `File > Open Project` and open `X:\gta5\script\dev_ng\singleplayer\GTA5_SP.scproj` 3. In the editor, select `File > Open Project` and open `X:\gta5\script\dev_ng\singleplayer\GTA5_SP.scproj`.
4. Select `Compiling > Intellibuild > Build Project` 4. Select `Compiling > Intellibuild > Build Project`.
## Patching Game Assets ## Patching Game Assets
#### Putting update.rpf and update2.rpf
1. Install ``update.rpf and update2.rpf from GTA V build 2699`` from [Requirements](#requirements)
2. Put `update.rpf` and `update2.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.<br>
Here you can see how to do it:
1. From `rush_patches-master.zip`, copy all files in the `ARCHIVEFIX` folder to a separate location
2. Drag RPF file onto `ArchiveFix.exe`
* Don't drag the both files at the same time, This will not work with that way.
#### Replacing script.rpf
If did you compiled the scripts and want to put it to the game, here you can follow this steps in order to make scripts work:
1. Run OpenIV, select "Windows" 1. Run OpenIV, select "Windows"
2. Select the game folder and click "Continue" 2. Select the game folder and click "Continue"
3. Open `GTA V\update\update2.rpf\x64\levels\gta5\script` 3. Open `<Game Directory>\update\update2.rpf\x64\levels\gta5\script`
4. Click the "Edit mode" button, and copy `X:\gta5\titleupdate\dev_ng\x64\levels\gta5\script\script.rpf` to the OpenIV window 4. Delete `script.rpf`
5. (OPTIONAL) Fix Story Mode by following the steps at the bottom: 5. Click the "Edit mode" button, and copy `X:\gta5\titleupdate\dev_ng\x64\levels\gta5\script\script.rpf` to the OpenIV window.
1. Open `GTA V\update\update.rpf\common\data` and make sure "Edit Mode" is enabled
<!-- This can be skipped because i already included everything in the update.rpf and update2.rpf.
1. (OPTIONAL) Fix Story Mode by following the steps at the bottom:
1. Open `<Game Directory>\update\update.rpf\common\data` and make sure "Edit Mode" is enabled
2. Under "XML Text Files", right-click `gameconfig.xml` and click "Edit" 2. Under "XML Text Files", right-click `gameconfig.xml` and click "Edit"
3. Under "Search", type "51000" 3. Under "Search", type "51000"
4. Change the value of `51000` to `53000` 4. Change the value of `51000` to `53000`
5. Click "Save" 5. Click "Save"
6. Close OpenIV 2. Close OpenIV
7. From `rush_patches-master.zip`, copy all files in the `ARCHIVEFIX` folder to a separate location
8. Open `<GAME FOLDER>\update`, and drag `update.rpf` and then `update2.rpf` onto `ArchiveFix.exe` -->
* Don't drag the both files at the same time, This will not work with that way.
10. Close both windows
## Running The Game ## Running The Game
1. In the game directory, create a file named `launch.bat` and add these contents: 1. In the game directory, create a file named `launch.bat` and add these contents:
@@ -165,10 +188,10 @@ game_win64_bankrelease.exe -noSocialClub -nokeyboardhook -nonetlogs
- `-ragUseOwnWindow` - Use it with `-rag` parameter to make game run outside of RAG Render Window. - `-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. - **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. - `-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(michael, franklin or trevor) with a random clothes. - 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. - Additional standard game arguments can be added as well.
- [Here is all the arguments list](misc/LAUNCHPARAMS_GTAV.txt) - [Here is the almost all the arguments list](misc/LAUNCHPARAMS_GTAV.txt)
3. (OPTIONAL) Launch RAG with the following commands in Command Prompt 3. (OPTIONAL) Launch RAG with the following commands in Command Prompt:
```batch ```batch
X: X:
cd X:\gta5\src\dev_ng cd X:\gta5\src\dev_ng
@@ -180,4 +203,6 @@ rag
## BankRelease & Debug Controls ## BankRelease & Debug Controls
[All The Controls & Keys](/misc/controls) [Almost Every Controls & Keys](/misc/controls)
<!-- Made with ❤️ by Smashtika(@yungDoom) -->