goldsrc-cheat/README.org

#+title: Half-Life cheat (Original author: [[https://github.com/8dcc/][8dcc]])
#+options: toc:nil
#+startup: showeverything
#+author: Wizzard

*Linux cheat for goldsrc games.*

#+TOC: headlines 2

* Description
Simple linux cheat for most goldsrc games, made in C.

Supported games:
- [[https://store.steampowered.com/app/70/HalfLife/][Half-Life 1]]
- [[https://store.steampowered.com/app/10/CounterStrike/][Counter-Strike 1.6]]
- [[https://store.steampowered.com/app/20/Team_Fortress_Classic/][Team Fortress Classic]]
- [[https://store.steampowered.com/app/30/Day_of_Defeat/][Day of Defeat]]
- [[https://store.steampowered.com/app/40/Deathmatch_Classic/][Deathmatch Classic]]

This project was heavily inspired by [[https://github.com/UnkwUsr/hlhax][UnkwUsr/hlhax]], and would not have been
possible without his help. Make sure to check out his repo too.

Also make sure to check out [[https://github.com/deboogerxyz/ahc][deboogerxyz/ahc]].

* Features

| Feature     | Description                       |
|-------------|-----------------------------------|
| Bhop        | Automatically jump when landing   |
| Autostrafe  | Automatic strafing movement       |
| Aimbot      | Aim assistance with FOV control   |
| Autoshoot   | Automatically shoot at enemies    |
| ESP         | See enemies through walls         |
| Chams       | Colored player models             |
| Crosshair   | Custom crosshair                  |
| Tracers     | Show bullet paths                 |
| Namechanger | Automatically change player name  |
| ThirdPerson | Third-person camera view          |

#+begin_quote
*Note:* All features can now be controlled via the ImGui menu (press INSERT to open).
#+end_quote

* GUI Menu

The cheat includes a full graphical user interface that can be opened by pressing the *INSERT* key. The menu includes several tabs:

- *Aimbot:* Configure aimbot settings including FOV, smoothing, and autoshoot
- *Visuals:* ESP, chams, crosshair and other visual enhancements
- *Misc:* Various utilities including name changer
- *Movement:* Bunny hop and auto-strafe settings
- *ThirdPerson:* Configure third-person camera view and key binding
- *Config:* Save and load configurations, set default settings

Key features of the menu:
- Press INSERT to toggle the menu on/off
- Settings are automatically saved to =~/.config/dz-goldsrccheat/=
- Default settings can be saved and will automatically load on startup
- Bind custom keys for features like third-person toggle

#+begin_quote
*Note:* Aimbot FOV goes from 0 (off) to 180 (all enemies)
#+end_quote

#+begin_quote
*Note:* Chams color can be changed from the =h_glColor4f()= function inside
[[https://git.deadzone.lol/Wizzard/goldsrc-cheat/src/branch/main/src/hooks.c][src/hooks.c]]. Since this cheat is not hard to compile, I rather have less
console variables than more customization at runtime.
#+end_quote

#+begin_quote
*Note:* Bullet tracer color, width and time can be changed at the bottom of the
=bullet_tracers()= function inside [[https://git.deadzone.lol/Wizzard/goldsrc-cheat/src/branch/main/src/features/misc.c][src/features/misc.c]]. See previous chams note.
#+end_quote

* Building
#+begin_src console
$ git clone --recurse-submodules https://git.deadzone.lol/Wizzard/goldsrc-cheat
$ cd goldsource-cheat
$ make
...
#+end_src

Note that you will need to clone with =--recurse-submodules= for the sdk. If you
have already cloned it, you can just:

#+begin_src console
$ cd goldsource-cheat
$ git submodule update --init --recursive
#+end_src

* Injecting
Uses the [[https://www.gnu.org/savannah-checkouts/gnu/gdb/index.html][gdb]] debugger for injecting the library.

#+begin_src console
$ ./injector.sh
[sudo] password for username:

...

goldsource-cheat loaded!
#+end_src