Update readme

This commit is contained in:
kelson8 2024-06-18 01:42:49 -04:00
parent 30f9a0427b
commit 1f1137856a
Signed by: kelson8
GPG Key ID: 3D738D9DD7239E13

View File

@ -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)
<p align="center">
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/logo.png" width="700" height="180">
</p>
<p align="center">
Press <kbd>Left Ctrl</kbd> + <kbd>M</kbd> to open the menu. Doesn't work in multiplayer
Press <kbd>Left Ctrl</kbd> + <kbd>M</kbd> to open the menu. Doesn't work in multiplayer.
</p>
<p align="center">
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).
<details>
<summary>Manual ( Not recommanded, use the installer instead! )</summary>
<summary>Manual ( I have disabled the installer for my fork. )</summary>
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.