149 lines
8.1 KiB
Markdown
149 lines
8.1 KiB
Markdown
# 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.
|
|
</p>
|
|
<p align="center">
|
|
READ THE INSTRUCTIONS. EVERYTHING YOU NEED TO KNOW IS ALREADY HERE.
|
|
</p>
|
|
|
|
## Introduction
|
|
|
|
A mod menu for Grand Theft Auto III, Vice City & San Andreas which allows a large set of modifications/cheats to be applied enabling a much more easier & amusing gameplay. This is **NOT** intended for use in multiplayer, I won't be responsible for any form of bans. Use it at your own risk!
|
|
|
|
Get stable binaries from [here](https://github.com/user-grinch/Cheat-Menu/releases). Beta binaries are available at the discord server.
|
|
|
|
[](https://discord.com/invite/ZzW7kmf)
|
|
|
|
## Installation
|
|
Only these versions of the game is supported. I highly recommand installing the menu on a fresh, non-modded game first.
|
|
- GTA SA v1.0 US Hoodlum
|
|
- GTA VC v1.0 EN
|
|
- GTA III v1.0 EN
|
|
|
|
<details>
|
|
<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.
|
|
3. Install [SilentPatch](https://gtaforums.com/topic/669045-silentpatch/) (For GTA III don't install the ddraw.dll component)
|
|
4. Install [D3D8to9 wrapper](https://github.com/crosire/d3d8to9/releases) (For III & VC)
|
|
</details>
|
|
|
|
## Incompatible Mods
|
|
### GTA SA
|
|
1. **ENB/ SA_DirectX 2.0**
|
|
2. **MSI Afterburner** **FIX:** Enable Stealth mode in rivatuner
|
|
3. **GTA Underground**
|
|
|
|
### GTA III
|
|
1. SilentPatch **ddraw.dll** component. **FIX:** Delete ddraw.dll file for now
|
|
|
|
Let me know if you mind more.
|
|
|
|
## Things to do on crash
|
|
1. Delete the `CheatMenuXX.toml` config file and try again.
|
|
2. If it's happening after installing a recent mod try removing it.
|
|
3. Try on a fresh installation of the game.
|
|
4. If still doesn't fix your issue, go ahead and report it.
|
|
|
|
### Crash reports/ Bug reports
|
|
Install [Crash info](https://www.mixmods.com.br/2021/06/crashinfo.html) & reproduce your crash. When reporting the crash upload the crashinfo logfile with it. Explain how to reproduce the crash in details. Also include,
|
|
- Game version
|
|
- Menu version
|
|
- List of mods installed
|
|
|
|
You can either open a issue here or directly contact me on discord (Recommended).
|
|
|
|
## Images
|
|
<details>
|
|
<summary>Show Images</summary>
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/1.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/2.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/3.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/4.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/5.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/6.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/7.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/8.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/9.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/10.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/11.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/12.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/13.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/14.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/15.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/16.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/17.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/18.png">
|
|
<img src="https://raw.githubusercontent.com/user-grinch/Cheat-Menu/master/images/19.png">
|
|
</details>
|
|
|
|
## Submit Translations
|
|
*How to translate Cheat Menu to another language*
|
|
|
|
The translations are loaded from `CheatMenuXX/locale/*.toml` files. Make a copy of the `English.toml` file and translate the texts there to your language. Rename the file to `your_language.toml` and make a pull request.
|
|
|
|
If you're language isn't supported ( Appears `???` in the menu. Check [here](https://github.com/user-grinch/Cheat-Menu/tree/master/tools/subset/in.txt) for supported languages), open a [issue](https://github.com/user-grinch/Cheat-Menu/issues) asking for support.
|
|
|
|
|
|
## 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)
|
|
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. [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.
|