TS Widget

TeamSpeak 3 integration directly in your Minecraft HUD.

TS Widget connects to your running TeamSpeak 3 client via the ClientQuery interface and shows your current channel, who's talking, and lets you control TeamSpeak straight from Minecraft — no more alt-tabbing.

🔌 Connection

Auto-connect on game launch (optional, toggle in settings)
Automatic API key detection — searches common TeamSpeak 3 config locations on Windows, macOS, and Linux (%APPDATA%/TS3Client/, ~/Library/Application Support/TeamSpeak 3/, ~/.ts3client/) and reads the ClientQuery plugin's key for you
Falls back to a manually configured API key if auto-detection doesn't find one
Automatic reconnect with heartbeat monitoring if the connection drops

🎧 HUD Widget

Shows your current channel name and the list of users in it
Talking indicator — see who's speaking in real time
Status icons for talking, idle, muted, deafened, and away
Optional "pretty" channel name formatting
Optional display of server query clients
Adjustable scale, position, and transparency
Max displayed clients setting to keep the widget compact on busy servers
Toggle widget visibility with a keybind at any time

🔔 Toast Notifications

Get an in-game popup for TeamSpeak events, each individually toggleable:

User joins the server
User leaves the server
User moves channels
You change channels
Someone pokes you (click the toast to jump straight to a reply)

💬 Chat Bridge

Bridges TeamSpeak text messages into your Minecraft chat (optional, with its own toast toggle)
Send messages back to TeamSpeak from Minecraft chat commands

⌨️ Commands

Full TeamSpeak control without leaving the game, with tab-completion:

/tsjoin <channel> — switch channel (partial name matching, click-to-pick if multiple match)
/tsmsg <player> <message> — private message a TS user by nickname
/tspoke <player> <message> — poke a TS user
/tschannel <message> — message your current channel
/tsmute / /tsunmute — toggle your microphone
/tsdeafen — toggle output
/tsafk [message] — mark yourself away with an optional custom message

😴 AFK Sync

Automatically marks you away in TeamSpeak when you pause/tab out of Minecraft
Configurable delay before syncing
Customizable away message (default: AFK in Minecraft)
Clears away status automatically when you're back

⚙️ Settings Screen

Everything configurable in-game via a dedicated UI (slider, switches, tabs) — no manual config editing needed.

⌨️ Keybinds

TS3 Widget Toggle — show/hide the widget
TS3 Connect/Disconnect — connect or disconnect
Open TS3 Settings — open the configuration screen

📋 Requirements

Minecraft 1.21.11, Fabric Loader >=0.18.1, Fabric API >=0.141.0, Java >=21
TeamSpeak 3 client with the ClientQuery plugin enabled

🔧 Setup

Enable ClientQuery in TeamSpeak 3: Tools → Options → Addons → ClientQuery
Install TS Widget alongside Fabric API
Launch Minecraft — TS Widget auto-detects your API key and connects

📄 License

MIT — client-side only, no data leaves your machine (connects only to 127.0.0.1).

Support

Found a bug, have a suggestion or need help? Join our Discord and open a ticket! https://discord.gg/Z3b8NvWb9n

ts-widget