diff --git a/README.md b/README.md index 28b20a9..aabd35a 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,21 @@ -# This modification has been deprecated in favor of [GrinchTrainer](https://github.com/user-grinch/GrinchTrainer-III-VC-SA). Future updates will be available there! +# I have forked the cheat menu repo +This menu is a work in progress, features may be broken or crash your game. It currently only builds and runs for GTA SA. +I will add a release for the menu when I feel like it's ready. +I have disabled logging support in this menu due to it being broken. +As I learn more C++ I will be adding more to this menu. Eventually, I would like to make some sort of chaos mod too. +I have been getting the hang of the functions in GTA SA using the plugin sdk and this menu. +I would like to make my own menu and name it KCNet-SAMenu or something like that using this one as a base. + +All credit goes to Grinch for the menu [user-grinch](https://github.com/user-grinch)
- Press Left Ctrl + M to open the menu. Doesn't work in multiplayer + Press Left Ctrl + M to open the menu. Doesn't work in multiplayer.
READ THE INSTRUCTIONS. EVERYTHING YOU NEED TO KNOW IS ALREADY HERE.
@@ -27,10 +35,8 @@ Only these versions of the game is supported. I highly recommand installing the
- GTA VC v1.0 EN
- GTA III v1.0 EN
-If you have those mentioned versions installed, use the installer [here](https://github.com/user-grinch/Cheat-Menu/raw/master/installer/Installer.exe).
-
Manual ( Not recommanded, use the installer instead! )
+ Manual ( I have disabled the installer for my fork. )
1. Install [DirectX9](https://www.microsoft.com/en-us/download/details.aspx?id=35), [Visual C++ Redistributable 2022 x86](https://aka.ms/vs/17/release/vc_redist.x86.exe) & [Ultimate asi loader](https://github.com/ThirteenAG/Ultimate-ASI-Loader/releases).
2. Download [**CheatMenuSA/VC/III.7z**](https://github.com/user-grinch/Cheat-Menu/releases) and extract everything in game root directory (NOT MODLOADER). The **CheatMenu** folder & **.asi** file must be placed in the same place.
@@ -98,13 +104,45 @@ If you're language isn't supported ( Appears `???` in the menu. Check [here](htt
## Required to build
1. [Build Tools 2022](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022)
2. [DirectX9 SDK](https://www.microsoft.com/en-us/download/details.aspx?id=6812)
-4. [Plugin SDK](https://github.com/DK22Pac/plugin-sdk)
-5. [Premake5](https://premake.github.io/) - Comes with already.
+3. [Plugin SDK](https://github.com/DK22Pac/plugin-sdk)
+4. [Premake5](https://premake.github.io/) - Comes with already.
+
+# Building the menu
+## To make the solution files for this
+1. Open a Command Prompt, Windows Terminal or Powershell window into the tools folder.
+2. Run .\premake5.exe vs2022 (If using a different Visual Studio version, specify it here.)
+
+## To build the menu
+I need to look into how I built this, I don't remember the exact steps.
+But you should be able to open the solution file in Visual Studio 2022 and build it from there.
+
+## Debug the menu
+You can use Visual Studio 2022 to debug the menu.
+
+
+Here is my layout for the Debugging tab (These values should be set to where your GTA SA install is.):
+* Command: "C:\Rockstar Games\GTA SA orig mod\gta_sa.exe"
+* Working directory: "C:\Rockstar Games\GTA SA orig mod"
+
+I have set this in the general tab for output directory: "C:\Rockstar Games\GTA SA orig mod\scripts".
+This makes it to where it will build the menu straight to my GTA SA folder and I can launch the game using the debugger in Visual Studio 2022.
+
+Mods helpful to have in GTA SA:
+* Fast Loader (Make the game faster for debugging): [Fast Loader](https://www.gtagarage.com/mods/show.php?id=25665)
+* Wide screen fix (Patch the game for proper widescreen support): [Wide screen fix](https://gtaforums.com/topic/547841-gtanfsmpother-widescreen-fixes-pack/)
+* Windowed Mode (Add windowed mode support for the game.) [Windowed mode](https://github.com/ThirteenAG/III.VC.SA.WindowedMode/releases)
+* Silent Patch (Fix a bunch of bugs and misc items in the game.) [Silent Patch](https://gtaforums.com/topic/669045-silentpatch/)
+
+If using multiple monitors:
+* Skip Device Selection: [Skip Device Selection](https://www.gtainside.com/en/sanandreas/mods/99791-skip-device-selection-window)
+
+This disabled the device selection screen on startup for faster debugging.
## Projects used
-1. [ImGui](https://github.com/ocornut/imgui)
-2. [Kiero](https://github.com/Rebzzel/kiero)
-3. [MinHook](https://github.com/TsudaKageyu/minhook)
-4. [Plugin SDK](https://github.com/DK22Pac/plugin-sdk)
+1. [Cheat-Menu](https://github.com/user-grinch/Cheat-Menu)
+2. [ImGui](https://github.com/ocornut/imgui)
+3. [Kiero](https://github.com/Rebzzel/kiero)
+4. [MinHook](https://github.com/TsudaKageyu/minhook)
+5. [Plugin SDK](https://github.com/DK22Pac/plugin-sdk)
All credits are given in Menu/About tab.