Repository navigation
Customization
Certain aspects of TF2BD can be customized either in the tool or by editing the configuration files. All config files are JSON and have schemas (allows autocomplete/validation). I personally recommend Visual Studio Code.
Third party player lists may have false positives. Since I do not maintain the lists, I cannot personally vouch for them. However, in my experience they are generally accurate.
In addition to the local playerlist.json and the official playerlist.official.json, some users maintain their own playerlists. These lists will automatically update every time the tool is started (assuming you have "Allow Internet Connectivity" enabled in the settings). You can "install" these lists by saving them under cfg/playerlist.<somename>.json.
- TF2BD "Trusted" list - List of cheaters contributed to by those with the "Trusted" role in the TF2 Bot Detector discord.
- wgetJane's biglist - List of bot accounts maintained by wget#0242 on discord.
- milenko's cathook list - List of players who have broadcasted their usage of cathook to the rest of the server.
Settings such as your SteamID and tf directory are stored in cfg/settings.json. Most of these settings can be configured from within the tool by opening "Settings" from the top left.

Scoreboard colors can be modified by clicking on the squares above the scoreboard.

Inside the tool, you can right click on players on the scoreboard to manually (un)mark them with the various tags.
The list of cheaters is stored in cfg/playerlist.json. The tool also loads any files matching the wildcard cfg/playerlist.*.json. The official list of cheaters (aka the list maintained by me) is stored in cfg/playerlist.official.json. It is recommended that you do not modify this file, since otherwise you will have to manually merge changes when updating.
Most cheater bots are extremely low-effort and can be easily automatically detected. The rules for detection are in cfg/rules.json. Like cfg/playerlist.json, rules are also loaded from all files matching the wildcard cfg/rules.*.json. It is also not recommended to modify the official list in rules.official.json.