goldsrc-cheat/README.org

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

*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]]

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    | Command       | Values (0..n)          |
|------------+---------------+------------------------|
| Bhop       | =cv_bhop=       | off/on                 |
| Autostrafe | =cv_autostrafe= | off/rage/legit         |
| Aimbot     | =cv_aimbot=     | off/fov*               |
| Autoshoot  | =cv_autoshoot=  | off/on*                |
| ESP        | =cv_esp=        | off/3d-box/name/all    |
| Chams      | =cv_chams=      | off/players/hands/all* |
| Crosshair  | =cv_crosshair=  | off/length             |
| Tracers    | =cv_tracers=    | off/on*                |


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

#+begin_quote
*Note:* If =cv_autoshoot= is enabled, and =cv_aimbot= is enabled, it will stop
attacking if there is no visible target.
#+end_quote

#+begin_quote
*Note:* Chams color can be changed from the =h_glColor4f()= function inside
[[https://git.deadzone.lol/Wizzard/goldsource-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/goldsource-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/goldsource-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