Stargazers Issues MIT License Build Status Discord Status


Logo

TF2 Bot Detector

Automatically detects and votekicks cheaters/bots in TF2 casual.
Report a Bug · Request a Feature · Join the Discord

Table of Contents

Getting Started

These instructions will give a quick overview of getting started with TF2BD. There is also a (very slightly out of date, but still useable) video by CrazyGunman#6724 here.

Prerequisites

A note about 64 bit vs 32 bit: If your computer was made after 2011 it is 64 bit and you should use the 64 bit version.

This program requires Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019 (32bit version available here)

Installation

  1. Download and install the Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019
  2. Download the latest release (32bit version)
  3. Extract the zip in any location inside of your user folder (e.g. Downloads, Documents)

How to use

  1. Run tf2_bot_detector.exe before TF2
  2. On first run it will ask you if you would like to allow internet connectivity and if you would like to be notified of future updates. Both are highly recommended

Note: The tool should automatically determine your steamID and tf2 directory. If for whatever reason they are not detected correctly you can override the generated values in the settings menu

How to update

Currently the program does not self update. You can update the program by extracting the new zip over the existing folder. You could also delete the old version and follow the installation instructions again.

FAQ

What does it do?

TF2 Bot Detector calls a votekick against bots (and select human cheaters) on your team. If they are on the other team, sends a chat message telling the other team to kick their cheater.

Will this get me VAC banned?

No. It does not modify the game or OS memory in any way. It is only using built-in functionality in the engine, exactly the way it was intended. Anecdotally, many users have been using this tool for a few months now without issue.

How does it work?

It monitors the console output (saved to a log file) to get information about the game state. Invoking commands in the game is done via passing rcon commands to your client. Getting players in the current game is done via the tf_lobby_debug and status commands. Cheaters are identified by some rules but primarily by comparing players steamIDs against a list of known cheaters.

How is the list of known cheaters curated?

The official list that is included with the program is maintained by Pazer exclusively. No user submissions are accepted at this time and it is unlikely that they will be in the future. While this approach this may seem limiting, it is to avoid false positives and to maintain the integrity of the project as a whole. There are some community player lists that can be added to your own detector. These are not maintained by Pazer. For more information on installing community lists go here.

I don’t like how the tool spams chat. Can I change that?

You can turn off chat warnings by unchecking the checkbox labeled “Enable Chat Warnings.” By default if there are multiple tool users in the same server a “Bot Leader” is chosen and only their tool will send messages. There is no other way to customize chat messages outside of editing the code yourself.

I downloaded the tool but I don’t see an executable. What did I do wrong?

You likely downloaded the source code instead of the actual tool. Make sure you are downloading one of the .ZIPs that is not labeled “Source Code.” There are two of them, one labeled with an x86 and one with an x64. If you don’t know which one you want, you almost certainly want the one with the x64. For further instructions go here.

Help! The tool wont open!

Make sure you have Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019 installed. If you just installed it make to to restart your computer after to finish the installation. For further assistance either open an issue on github or join our discord for faster, community based support.

What do you think of using aimbot/cathook/esp/cheats against the bots?

This project does not advocate for the use of cheating in any fashion. Putting aside the obvious moral issues with using cheats, that would introduce the possibility of a VAC ban. This project is committed to maintaining the safety of its users.

I have a question that is not listed here!

Take a look at the wiki. There is not a ton there right now but that will be the location of all future documentation. If you can’t find your answer there, stop by the discord.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Project Discord: https://discord.gg/W8ZSh3Z

Issues page

Acknowledgements

Sponsors

Huge thanks to the people sponsoring this project via GitHub Sponsors: