axXezBot - TeamSpeak Server Bot
Hello guys, after I posted my Stream Overlay a while ago it kind of motivated me to finally get another project into a releasable state — so here we go, a TeamSpeak server bot :D
This started back in 2021 when my friend Freeman wrote the first version of the query client and came up with the idea of a modular bot framework. I picked it up, rewrote and extended it a lot, and spent the last month cleaning it up to get it releasable.
The built-in modules are fairly basic for now — most of the work went into building a solid, extensible base for writing your own modules and plugins.
Key Features
- works with TeamSpeak 3 and 6 (SSH and plain TCP transport support)
- module system — enable only what you need
- plugin support — load your own .NET DLLs at runtime without touching the bot code
- Docker image for amd64 and arm64
- fully configurable via config files or environment variables
- auto-reconnect with full state restore
Built-in Modules
-
Auto AFK Switch — moves idle clients to an AFK channel based on configurable thresholds
-
User Channels — creates a temporary personal channel for a client on demand and cleans it up when empty
-
Exclusive Groups — enforces mutually exclusive server groups, keeping only the highest-priority one
-
Music Bots — creates voice-connected music bots that join TeamSpeak channels and stream audio
Full setup guide and all configuration options are on GitHub.
Bonus: The repo also includes a documented ServerQuery reference I put together because I couldn’t find one that had all commands and fields properly covered :D (also I don’t know if mine is correct either lol)
GitHub: github.com/axXez/axXezBot
Docker Hub: hub.docker.com/r/axzeu/axxezbot
Bugs can be reported on GitHub, PRs are welcome too but since my work repo is hosted on my private GitLab I can’t directly merge them sry.
If you have any ideas for modules or improvements feel free to suggest them, I’ll try to implement them when I find the time^^
I hope it’s useful to some of you and you have fun with it :D