ts-widget

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

1. Enable ClientQuery in TeamSpeak 3: Tools → Options → Addons → ClientQuery
2. Install TS Widget alongside Fabric API
3. 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