mrsteyk/cathook

UNMAINTAINED, THE CODE IS FOR EDUCATIONAL PURPOSES

IMPORTANT - UNMAINTAINED

This project is no longer maintained. Do not contact me about bugs in the software, don't open pull requests, make a fork instead (or find a maintained one)

Cathook Training Software

Discord Server

The discord server is depreciated due to discord taking action.
Please use the new Official Telegram Group.
Official Discord Server

cathook is a training software designed for Team Fortress 2 for Linux. cathook includes some joke features like

• Backpack.TF API integration with playerlist GUI, allowing you to see players' inventory values
• Always/Never spycrab
• Ignore Hoovy
• 100% Casual/Comp coin flip
• Encrypted chat
• Emoji ESP
• Fidget Spinner crosshair
• Chance to get manually VAC banned by Valve

and a lot of useful features, including

• Anti Backstab with option to say "No" voice command when spy tries to backstab you
• Heal Arrows exploit (overheal an enemy for 1200 health with single huntsman arrow, you can also do it with buildings!)
• Extremely customizable spam (you can make spam lines that'll include name of random dead enemy pyro or sniper)
• Follow Bots
• Working crit hack

FULL LIST OF FEATURES HERE

INSTALLATION

You can use gcc-7 for compiling cathook if you add -e CC=gcc-7 CXX=g++-7 to make command line

Ubuntu gcc6 installation: (check if you have gcc-6 installed already by typing gcc-6 -v

sudo apt update && sudo apt install build-essential software-properties-common -y && sudo add-apt-repository ppa:ubuntu-toolchain-r/test -y && sudo apt update && sudo apt install gcc-snapshot g++-6-multilib gcc-6 g++-6 -y

Ubuntu other dependencies installation:

sudo apt update && sudo apt install git libssl-dev:i386 libc6-dev:i386 gdb libsdl2-dev libglew-dev:i386 libfreetype6-dev:i386 -y 

Arch gcc6 & dependencies installation:

sudo pacman -U https://archive.archlinux.org/packages/g/gcc-multilib/gcc-multilib-6.3.1-2-x86_64.pkg.tar.xz https://archive.archlinux.org/packages/g/gcc-libs-multilib/gcc-libs-multilib-6.3.1-2-x86_64.pkg.tar.xz https://archive.archlinux.org/packages/l/lib32-gcc-libs/lib32-gcc-libs-6.3.1-2-x86_64.pkg.tar.xz && sudo cp -r /usr/include/c++/6.3.1/ /tmp/ && sudo pacman -S gdb gdb-common glew1.10 glew lib32-glew1.10 rsync lib62-gcc-libs gcc-libs-multilib gcc-multilib --noconfirm && yes | sudo cp -r  /tmp/6.3.1/ /usr/include/c++/

If you don't use Ubuntu or Arch (or if Arch script gets outdated), here's the list of what cathook requires:

• gcc-6
• g++-6
• gcc-6-multilib
• g++-6-multilib
• glew
• gdb (for the injection script, you can use different injector if you want)
• libssl-dev:i386
• libc6-dev:i386
• libsdl2-dev
• libglew-dev:i386
• libfreetype6-dev:i386
• rsync (used for copying shaders/fonts to tf2 data directory, check-data script)

Cathook installation script:

git clone --recursive https://github.com/nullifiedcat/cathook && cd cathook && bash build-tf2

Errors while installing?

/usr/include/c++/5/string:38:28: fatal error: bits/c++config.h: No such file or directory You don't have gcc-multilib-6 installed correctly.

src/<any file>: fatal error: mathlib/vector.h: No such file or directory You didn't download Source SDK. DO NOT DOWNLOAD CATHOOK USING "DOWNLOAD .ZIP" FROM GITHUB. USE git clone --recursive!

If you are using another distro, make sure to have g++-6, gdb, libc6 and build essentials installed.

Updating cathook

Run the update script in cathook folder.

Cathook requires a special data folder (contains shaders, font files, walkbot paths, etc). This folder is located at /opt/cathook/data and is generated automatically when you compile cathook.

Injection

sudo ./attach to attach cathook into TF2. Optionally, you can provide an argument number (0-n - #) to provide the TF2 process ID (for bots).

sudo ./attach-backtrace to attach and print backtrace incase TF2 crashes. Some users report that this causes FPS drop in-game. This is recommended to grab a log of what went wrong if Cathook is crashing on you.

Followbots (outdated)

cathook-ipc-server allows you to run and control Followbots to do your evil bidding in-game. The installation for Followbots is quite complex, and will not be covered on this page. Obviously, you must have several user accounts ready to run TF2.
A guide for Followbots can be found here: How to setup and use followbots.
You may also ask someone in our discord server to help you out.

The installation script is as followed:

git clone --recursive https://github.com/nullifiedcat/cathook-ipc-server && cd cathook-ipc-server && make -j4

To run the Followbot server, run ./bin/cathook-ipc-server. You can also use ./bin/cathook-ipc-server &>/dev/null & to run it in background.