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 ThisUsernameIsMine ThisUsernameIsMine Oct 21, 2014 at 21:02 UTC - 0 likes

    Hi Firedroide (how are you?) :-)

    Quick question for you: Can you consider adding a command to disable/enable BukkitSpeak on request? I often shutdown the TS server when no people have joined for some time, but BukkitSpeak frequently querries the TS server (which causes the below console errorspam), and this bothers me ;-)


    Thanks! :-)

    Last edited Oct 21, 2014 by ThisUsernameIsMine
  • Avatar of Firedroide Firedroide Aug 15, 2014 at 22:23 UTC - 0 likes

    @CraftYourWay: Go

    Try setting the property via the in-game commands. This way we can exclude any possibilities of formatting errors.

    So /tsa set SentChatToTeamspeak channel and also make sure the Channel ID (and optionally password) are set correcty.

    Using in-game commands with /tsa set channel, you can use the actual name of the channel you want BukkitSpeak to be in. When editing the file manually, one can only enter the actual numeric channel ID.


  • Avatar of CraftYourWay CraftYourWay Aug 13, 2014 at 13:45 UTC - 0 likes

    SentChatToTeamspeak doesnt work, i put it on channel nothing happens but when i put it on server still nothing happens.what can i do

    Last edited Aug 13, 2014 by CraftYourWay
  • Avatar of Firedroide Firedroide Aug 03, 2014 at 13:54 UTC - 0 likes

    @RazorX2014: Go

    Check this page for the most common errors, please.

    Sorry for the long message delay, I didn't have any internet access for the last few days.

  • Avatar of RazorX2014 RazorX2014 Aug 01, 2014 at 00:24 UTC - 0 likes

    hi im trying to use this on my bukkit server with my teamspeak server im paying for from teamspeak but its saying 0 clients online or cant comunicate with the teamspeak server can someone help me get this setup?

    im running the latest craftbukkit server

    Last edited Aug 01, 2014 by RazorX2014
  • Avatar of Firedroide Firedroide Jul 05, 2014 at 10:43 UTC - 0 likes

    @Paxination: Go

    Added grouping function in build 227.

    I added a config value, teamspeak.GroupClientListByServerGroup. When set to true, the layout of /ts list will look like this:

    [BukkitSpeak] Currently online (3):
    ServerAdmin: SuperAwesomeAdminUser
    Moderator: Mod1, Mod2
    User: trolldude1337, musicBot42, afkIdler

    So basically the name of the TS server group on the left side and the clients in these groups on the right.

    @Paxination: Go, is that about what you imagined of this new feature?

    I also added a new variable for the locale.yml file called %count%. It will be replaced by the number of clients online.

    Currently online (%count%):

    Just like that. You'll have to update the values in the locale file for /ts list to use this new variable.

    Last edited Jul 05, 2014 by Firedroide
  • Avatar of Firedroide Firedroide Jun 24, 2014 at 18:02 UTC - 0 likes

    @Paxination: Go

    Cool idea, I'm gonna look into it for the next update. I'm already getting the server groups of each client for the permissions for TS commands anyways, so this should be easy to implement, too.

    I'll probably add a config option to enable or disable the grouping in /ts list so the list can be kept more compact for smaller size TS servers.

    I won't do an update in the next few days though, so it could take one week or two. The summer holidays start at that date, so I should finally have a bit more time again ^^

  • Avatar of Paxination Paxination Jun 24, 2014 at 14:59 UTC - 0 likes

    Would you have the time to add a new feature? Assuming its even possible cuz i know of the limitations of servequarry....

    Would like /ts list to show some sort of an indicator that certain people in ts are in a staff group.

    Like lets say I do /ts list, and there are 3 peeps in my ts server that are in a group that I named staff.

    in the mc server it would show [Staff] next to their name when it shows the list.

    Is this possible for the servequarry to return back players groups when quarried?

  • Avatar of Firedroide Firedroide Jun 17, 2014 at 21:59 UTC - 0 likes


    Quote from just a couple comments further down: "BukkitSpeak v0.67 is compatible with all versions of 1.7 and will probably also be compatible with the 1.8 releases."

    If something isn't working properly, tell me. I will then fix the problem and update the plugin immediately.

    For now, all changes made to the plugin since 0.67 are purely cosmetical and not worthy of a new update. Further more, I currently don't have loads of time for these projects.

  • Avatar of THEMINECRAFT951 THEMINECRAFT951 Jun 17, 2014 at 16:14 UTC - 0 likes

    UP (Upgrade plz !)


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