Please leave any bug reports or feature requests in the Issues section. THANK YOU to all the bug reporters that have helped me improve this project!
This is a player bot addon for the Trouble in Terrorist Town game mode in Garry's Mod.
It is designed to be as modular as possible, allowing easy customization and expansion. It is designed for TTT2 while being fully playable in regular TTT.
📝 Note: Please stick to the main branch. Most other branches are eitherunstable or significantly behind.
You can find the maps custom-made for this add-on here.
The bots will work on any map with a navmesh, but if you want plug-and-play and/or you don't care, you can just use the above add-on.
- Download the latest version from the Steam Workshop.
- Start a Peer-to-Peer or SRCDS with sufficient player slots on a map with a navmesh or one of the included maps.
- As a super admin, either type
!botadd Xin chat or writettt_bot_add Xin the console. - You're done!
This add-on supports a wide range of TTT2 roles. Here are some that have explicit compatibility:
- Jester
- Jackal
- Sidekick
- Hitman (needs work)
- Serial Killer
- Survivalist
- Bodyguard
- Sheriff
- Deputy
- Drunk
The mod also auto-generates compatibility with custom roles, but it is imperfect. It does not comprehend most 'public killer' roles (e.g., 'Speedrunner').
A basic usage guide can be found on the wiki.
It will give you all the info you need for 90% of cases. A more in-depth set of guides are a WIP.
Check out the developer guide.
Please help me document/improve the codebase! I would highly appreciate it. And you can have bots get named after you!
First and foremost, this open-source software is provided as-is, with no warranty or guarantee of functionality.
I am committed to keeping this project open-source and easily accessible to everyone. I want developers and bot enthusiasts to be able to examine my code, offer feedback, and contribute. However, I have invested much time and effort into developing this project to its current state. Therefore, I have licensed it under CC-BY-SA 4.0, which allows you to clone, use, modify, and redistribute my content freely as long as you give me credit upon using significant portions of my code.
^ You can find the proper legalese for the CC-BY-SA-4.0 license in the LICENSE.txt file.