Show Teamspeak actions in Minecraft & connect the chats

Version: v0.67 (compatible with all versions of 1.6 and 1.7)
Created by Deathmarine and Firedroide.

This plugin will display Teamspeak 3 server joins, quits and messages in Minecraft
and allows you to chat with your friends using the /ts commands!


  • Display Teamspeak joins in Minecraft
  • Display Teamspeak quits in Minecraft
  • Display Teamspeak (server-wide) messages in Minecraft
  • Broadcast messages in Teamspeak
  • In channels:
    • Display messages in Minecraft if somebody enters or leaves your channel.
    • Display chat messages in that channel in Minecraft.
    • Chat with the people in the channel by using /ts chat <message>


User commands:

  • /ts - Displays the help screen.
  • /ts list (channel) - Displays who's online on Teamspeak (in the channel).
  • /ts mute - Mutes BukkitSpeak only for you.
  • /ts broadcast msg - Broadcasts a message to all people on the Teamspeak server.
  • /ts chat msg - Shows your chat message in the Teamspeak channel.
  • /ts pm target msg - Sends a chat message a specific person.
  • /ts poke target msg - Pokes a client on Teamspeak.
  • /ts info - Shows some info about the TS3 server.

Admin commands:

  • /tsa or /ts admin - Shows the admin help screen.
  • /tsa channelkick target msg - Kicks someone out of the channel with the given reason.
  • /tsa kick target msg - Same as above, but kicks from the server.
  • /tsa ban target msg - This command bans a TS client from the server.
  • /ts status - Shows some information about BukkitSpeak and whether the Listener is running.
  • /tsa reload - Reloads BukkitSpeak. (Reloads the config and the query)

A complete command reference can be found here.


Moved to my GitHub Wiki.


You can check out the list of BukkitSpeak's permissions here.

Setting up the plugin

  • Download the newest release and move BukkitSpeak.jar into the plugins directory.
  • Editing the config:
    • Set TeamSpeakIp to the IP of your TS server
    • Set TeamSpeakPort to the port (when connecting with a regular client)
    • Set QueryPort to the port the TS server uses for server queries. By default this is 10011. You can also find the query port in the server.ini file in the directory of your TeamSpeak server.
    • Set QueryUsername and QueryPassword to a server query login you've generated with your client. More information about that here.
  • Give your users the permissions to use BukkitSpeak and to see messages from BukkitSpeak.
    • In general, you can give admins the permission bukkitspeak.* and users the permission bukkitspeak.user.
    • Complete permissions documentation here.
  • Whitelisting the Minecraft server on the Teamspeak server:
    • You don't need to follow this step if your Teamspeak server runs on the same IP as the Minecraft server.
    • Find the file query_ip_whitelist.txt in the root directory of your Teamspeak server and add the IP of the Minecraft server to this file.
    • Reload / restart the Teamspeak server afterwards. (The whitelist is cached and will only be read when the server starts...)

Any feature requests / ideas / bug reports / locale files / ect. ?

Just write a comment or open a ticket :)

Source Code (Branch BukkitSpeakMerged)
Wiki with a more detailed documentation (some stuff still WIP)
Complete changelog

Development builds have not been approved by the BukkitDev staff. Use them at your own risk.
Development Builds
Build repository

Deathmarine's BukkitSpeak
Original thread by but2002
Original thread by Greycap (might be removed)


Any donations to BukkitSpeak will help to keep a little Minecraft server of mine alive.
I really appreciate every little support.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Firedroide Firedroide Nov 22, 2015 at 17:08 UTC - 0 likes

    @SirPsp: Go

    You're trying to use a TS3 nickname for the server query that has already been taken by another client or query or is invalid.



    in the config file to a different value. Use a nickname that is at least 3 characters long and only uses ASCII characters.

    Last edited Nov 22, 2015 by Firedroide


  • Avatar of SirPsp SirPsp Nov 21, 2015 at 10:18 UTC - 0 likes

    When someone chats on minecraft, this is what comes through on teamspeak: <21:11:44> "Psp from": SirPsp: Hello

    Is it possible to remove the IP from that message? Only because it's so long and takes up half the chat box.

  • Avatar of Firedroide Firedroide Aug 14, 2015 at 11:36 UTC - 0 likes

    @dvargas135: Go

    It should, yes. It hasn't been tested thoroughly in 1.8, though.

  • Avatar of dvargas135 dvargas135 Aug 13, 2015 at 06:07 UTC - 0 likes

    Does this work for 1.8?


  • Avatar of Firedroide Firedroide Jul 07, 2015 at 12:17 UTC - 0 likes

    @MonnierAnt: Go

    TeamSpeak 3 doesn't support server-side volume control, therefore the answer is no, it's not possible.

    I heard that something like this can be done with Mumble, however, so you might want to check that out. If it's actually possible, I bet there is already a plugin for it.

  • Avatar of MonnierAnt MonnierAnt Jul 06, 2015 at 18:08 UTC - 0 likes

    Hi @Firedroide.

    Your plugin seems to be a very nice one.

    I wonder, i'm looking for a specific feature and i can't find anything for the moment.

    I wonder can we imagine a distant chat that link the volume of people for players according to their distance in the world.

    If someone is far away from you you can't hear him on ts.


    Ours plugins : Obole - Deposite - CmdToRedstone - Salary
    French documentation for many bukkit's plugins : HERE

  • Avatar of Firedroide Firedroide Jun 17, 2015 at 13:33 UTC - 0 likes

    @Paxination: Go

    Sorry, but I can't really implement this into BukkitSpeak.

    What you request is just so extremely specific and would probably only benefit you and maybe one or two more users of this plugin.

    This, actually, sounds like a perfectly valid idea for a standalone plugin for you (or someone else) to program. You could even use BukkitSpeak's server query instance to send your messages to TeamSpeak. To get the query object, just use BukkitSpeak.getQuery().

    To get more information about the TS3 server query API used in BukkitSpeak, see here.

    Again, sorry that I can't really implement this into BukkitSpeak. It's just simply out of scope.

  • Avatar of Paxination Paxination Jun 15, 2015 at 23:29 UTC - 0 likes

    @Firedroide: Go

    Hey, just wandering, if you could add a feature?

    Make it so that it watches what commands a player issues, and if it matches a list of commands in the config, have the plugin send a msg to any one on the TS server that is within a specific server group.

    There are times when my staff are in TS and not on our MC server. And it would be helpful if they could get a notification that something is up from like a /helpop or /report or a defined command from inside of bukkitspeak itself.

    Is this possible for you to poke a specific group or all players in a specific group on TS through the serveradmin?

  • Avatar of Razorskills Razorskills May 31, 2015 at 22:36 UTC - 0 likes

    I'm really happy this is still working great on 1.7.10

    Only issues I have noticed are: if from teamspeak I send "!Say Something" (usually longer messages) it sends to to the server just fine, but it also messages to the channel, but it usually sends 2 messages to the channel in teamspeak instead of just one.

    I also noticed if you use "say" in the console on the server, it doesn't send that to teamspeak.

    But I definitely love the plugin.

    Last edited May 31, 2015 by Razorskills
  • Avatar of Firedroide Firedroide May 06, 2015 at 21:50 UTC - 0 likes

    @uncovery: Go

    Wonderful, nice to hear everything is working correctly now!

    If any other issues with the plugin happen to come up, feel free to comment here again :)


Date created
Dec 18, 2011
Last update
Oct 29, 2013
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files