Show Teamspeak actions in Minecraft & connect the chats

Version: v0.67
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 Apr 03, 2014 at 17:17 UTC - 0 likes

    Regarding the UUID changes:

    BukkitSpeak does not store any player data. Player names are only used for formatting when players send messages to TeamSpeak or private messages from TeamSpeak to Minecraft.

    All versions of BukkitSpeak, including older versions of the plugin, are unaffected by the changes to the naming system and are still safe to use.


  • Avatar of Firedroide Firedroide Apr 01, 2014 at 19:28 UTC - 0 likes

    @TheFighterNb2: Go

    So, to recap your statement:

    • You want to get control over your voice chat client in-game, or even have a voice chat client integrated into Minecraft
      • This cannot really be done with a Bukkit plugin, as plugins cannot modify the client itself, but only the server
      • You've even found a mod to do this, but it seems like you just don't want to or are not able to use it (?)
    • You want to move your own TS client from TeamSpeak, and to be able to create channels
      • I've already mentioned that I won't be linking Minecraft players and TS clients, it would result in a horrible mess and security issues left and right
      • If you create a TS channel, you'll also want to configure it. Not something that's easy to do from Minecraft
      • You can create custom keybinds to do some of those actions in your TeamSpeak client, like moving your client or muting your mic
    • Your friend's processor only goes up to around 10% load whilst playing Minecraft, but it jumps up to around 85-100% with a voice chat client running
      • This wouldn't really be better if the voice chatting client was integrated into Minecraft, it would rather be even worse
      • Tell him to fix his audio drivers or to get a new PC.
    Last edited Apr 01, 2014 by Firedroide
  • Avatar of TheFighterNb2 TheFighterNb2 Mar 31, 2014 at 20:08 UTC - 0 likes

    Also i found this this might also help its an awesome Plugin/Mod


  • Avatar of TheFighterNb2 TheFighterNb2 Mar 31, 2014 at 19:51 UTC - 0 likes

    Hey i had a Question, well more like an idea.....Instead of just messaging and texting, can you add on the actual Teamspeak (like actual Talking through the Microphone to speak just like TeamSpeak 3) i've been think and working on my free time on a project but I'm not really good coding Yet the idea was to make minecraft the have the voice over lan option(just like Skype or Teamspeak and Ventrilo.i was wanted to add it on multiplayer settings so that you could turn it off and on, that being said there would be options of entering a group/Channel or you can make by doing "/ts Create [Group/Channel Name]" and to enter a channel or group just type"/ts Join [Group/Channel Name]"...i think this would make a very good plugin to look into, i though of this when my friend Beebe's Computer kept over heating from play Minecraft & Skype at the same time we also tried Othe Voice other Line software, but ultimatly his computer coudlnt handle two Softwares both open at the same time(trust me i tried a lot of test dont know why its just thoses ones sepficilly, i thinks it has to be his processor it keep bounce to 100-85% when have minecraft and any other software, but just minecraft it self is at like 10%, so ithough why not just add a voice lan with minecraft?)so if you could message me back on what you think, or even if its possible im all ears i think i would really enjoy doing reseach and work on this.^_^-TheFighterNb2

  • Avatar of piotrex43 piotrex43 Mar 25, 2014 at 17:29 UTC - 0 likes

    This plugin is very useful. You really should develop this plugin still. Thank you for your work on this plugin! :D Greetings from Polish!

  • Avatar of Razorskills Razorskills Mar 17, 2014 at 21:32 UTC - 1 like

    Never mind, your version seems to work excellent! Good Job! Im impressed :D

    That was such a fast fix!

  • Avatar of Razorskills Razorskills Mar 17, 2014 at 21:25 UTC - 0 likes

    Sure thing! I will test this out asap!

    I was wondering though. Since the messages in the chat come out like this:

    [g] Razorskills: Hello

    and the Town chat shows up like this:

    [TC] Razorskills: Hello Town!

    I guess i wanted to suggest for it to be able to monitor for any specific prefixes that come up, and a list of prefixes could be added to a blacklist to not sent to teamspeak.

    Or maybe a list Of prefixes that must show up to send to ts. like a whitlist.

    Anyways that is just an idea from my head. i will test what you have done today!

  • Avatar of Firedroide Firedroide Mar 17, 2014 at 21:19 UTC - 1 like

    @Razorskills: Go

    Well, there's not really a straightforward way to address this problem as TownyChat does not cancel the "public" chat events at any point, but just changes its recipients list.

    So basically I've added a configuration node which will not only help with TownyChat compatibility issues but other plugin issues in general.

    The added configuration node plugin-interaction.OnlyRelayChatAllPlayersWillReceive checks if a chat message has the same amount of players as recipients as there are online players and only then sends the message to TeamSpeak.

    Might work great, might fail miserably if other plugins randomly remove players from the chat recipient lists, we'll have to see. This is why I'd need you to test the newest build on my jenkins build server:

    Build 223
    Disclaimer: Development builds have not been approved by the BukkitDev staff. Use them at your own risk. (Really Bukkit? *sigh*)

    You shouldn't need to change anything to the configuration, the new setting is enabled by default. So just replace the old BukkitSpeak.jar on your server, restart it, and you should be fine.

    So yeah, I hope this fixes your issue. Thanks so much for the bug report and for giving me a reason to continue development on this plugin. Please excuse that my English skills suck so much today and that this response is not straightforward at all, I got only about 4 hours of sleep this night and it's late already.

    But please tell me if this change fixed your issue, so I could make further adjustments if it didn't or give myself a pat on the shoulder if it did :P

  • Avatar of Razorskills Razorskills Mar 17, 2014 at 20:32 UTC - 0 likes

    Is there a way to have bukkitspeak not send town chat to teamspeak? (what i mean is there is a global chat, and you can use your own townchat to talk among your members)

    I am using towny, so we have townychat aswell. I am using the townychat plugin available here for 1.6.4:

    TownyChat 0.40 ( http://goo.gl/NT4kW )

    This is the link from towny irc, I did not reupload it.

    The towny webpage is here: http://palmergames.com/towny/

    The site is kind of confusing, but I use the devbuild for my 1.6.4 server and it works great! only problem is townchat giving msgs to ts that it probably should not be.

    Last edited Mar 17, 2014 by Razorskills
  • Avatar of Firedroide Firedroide Feb 11, 2014 at 15:54 UTC - 0 likes

    @underestimate1984: Go

    Are you sure that you whitelisted the IP of your Minecraft server on your TS server?

    The file's called query_ip_whitelist.txt in the root directory of the TS server.

    Last edited Feb 11, 2014 by Firedroide


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