ModdingRX/GTAV_BuildGuide
1
0
Fork 0
Code Issues Pull Requests Actions 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
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 68 additions and 43 deletions
Show Stats 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>
🔨 **Known Bugs, Errors and Issues:** [See Here](/knownissues.md)
@ -19,8 +21,8 @@
- 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`
- [update.rpf and update2.rpf from GTA V build 2699](https://mega.nz/file/3j5yAYzR#guzO1Yw80efLfmHIPdY8gcPFAHJn7ncF1voadjdpaLE)
- Some Patience, Brain and Knowledge.
- [update.rpf and update2.rpf from GTA V build 2699](https://mega.nz/file/PzJ3DC4R#PAQei9OwOEboB4o5oN2TFmb7KmRFRTvlcKVlZ5zhj3o)
- Some Patience and Technical Competence
### Dependencies
- [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)
- [Scripts](https://drive.google.com/file/d/1AVMC_MBPpqKp0BIrOI-_lLq98QmwRn46/view)
___
> [!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.
@ -55,12 +59,12 @@
4. Install Update 4 for Visual Studio 2012
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:
1. Hold Shift and right click the `incredibuild4_0.exe` file, select "Copy as path"
2. Open Command Prompt as Administrator
3. Paste the path and press Enter
1. Hold Shift and right click the `incredibuild4_0.exe` file, select "Copy as path"
2. Open Command Prompt as Administrator
3. Paste the path and press Enter
- Select to install "Incredibuild Agent", "Incredibuild Coordinator", and the extension for Visual Studio.
6. Install OpenIV
7. Install Miscellaneous Files
7. Install [DLL Patches and Rush Patches](#miscellaneous)
8. (OPTIONAL) Install 3D Studio Max 2010 SDK
9. Create X:\ Drive by following the steps at the bottom:
1. Open Command Prompt
@ -68,9 +72,9 @@
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`
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.
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:
```batch
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.
* By the end, Your Folder Structure should look like this:
**By the end, Your Folder Structure should look like this:**
```
🖥️ X:
┗ 📂 gta5
@ -92,39 +96,38 @@ setx /m RS_PROJECT gta5
## Patching The Source Code
1. Open `rush_patches-master.zip`
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
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.
## Building The Game Binary
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.
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
4. Hold Ctrl key and click all projects under "GameLibs" and "Rage", right-click and select "Properties"
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"
- 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.
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"
3. Change "Active Solution Platform" to "x64" and close the configuration window.
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".
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)"
- 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.
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.
10. Copy output binary to game folder.
> [!NOTE]
> 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.
> [!WARNING]
> 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
1. Under "Shaders", right click the "shaders_rc" project and click "Build"
2. (OPTIONAL) Build low quality shaders
1. Right click the "shaders_rc" project and click "Properties"
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"
4. Rebuild shaders
5. Copy `X:\gta5\titleupdate\dev_ng\common` to game directory
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..
3. Copy `X:\gta5\titleupdate\dev_ng\common` to game directory.
## Building Game Scripts
1. Open Command Prompt
2. Run the following commands:
1. Open Command Prompt and Run the following commands:
```batch
X:
cd X:\gta5\src\dev_ng
@ -132,25 +135,45 @@ setenv
cd ..\..\tools_ng\bin\RageScriptEditor
ragScriptEditor
```
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`
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`.
## 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"
2. Select the game folder and click "Continue"
3. Open `GTA V\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
5. (OPTIONAL) Fix Story Mode by following the steps at the bottom:
1. Open `GTA V\update\update.rpf\common\data` and make sure "Edit Mode" is enabled
3. Open `<Game Directory>\update\update2.rpf\x64\levels\gta5\script`
4. Delete `script.rpf`
5. Click the "Edit mode" button, and copy `X:\gta5\titleupdate\dev_ng\x64\levels\gta5\script\script.rpf` to the OpenIV window.
<!-- 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"
3. Under "Search", type "51000"
4. Change the value of `51000` to `53000`
5. Click "Save"
6. 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
2. Close OpenIV
-->
## Running The Game
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.
- **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(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.
- [Here is all the arguments list](misc/LAUNCHPARAMS_GTAV.txt)
3. (OPTIONAL) Launch RAG with the following commands in Command Prompt
- [Here is the almost all the arguments list](misc/LAUNCHPARAMS_GTAV.txt)
3. (OPTIONAL) Launch RAG with the following commands in Command Prompt:
```batch
X:
cd X:\gta5\src\dev_ng
@ -180,4 +203,6 @@ rag
## BankRelease & Debug Controls
[All The Controls & Keys](/misc/controls)
[Almost Every Controls & Keys](/misc/controls)
<!-- Made with ❤️ by Smashtika(@yungDoom) -->