search

thebigsleepjoe / TTT-Bots-2

Player bots for Garry's Mod TTT
Creative Commons Attribution Share Alike 4.0 International
11 stars 4 forks source link
ai bots game garrysmod ttt ttt2

readme

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!

TTT Bots Header

What is this?

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.

Maps

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.

How to use

  1. Download the latest version from the Steam Workshop.
  2. Start a Peer-to-Peer or SRCDS with sufficient player slots on a map with a navmesh or one of the included maps.
  3. As a super admin, either type !botadd X in chat or write ttt_bot_add X in the console.
  4. You're done!

Role Support

This add-on supports a wide range of TTT2 roles. Here are some that have explicit compatibility:

The mod also auto-generates compatibility with custom roles, but it is imperfect. It does not comprehend most 'public killer' roles (e.g., 'Speedrunner').

Usage and Commands

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.

For developers

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!

License

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.