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 Nov 05, 2014 at 16:31 UTC - 0 likes

    @Firedroide: Go

    To be honest i don't have a clue either.. i'll test some of the older builds ;-)

    Last edited Nov 05, 2014 by ThisUsernameIsMine
  • Avatar of Firedroide Firedroide Nov 02, 2014 at 12:57 UTC - 0 likes

    @ThisUsernameIsMine: Go

    Do you remember which build number your BukkitSpeak version had before you updated?

    Would help narrow down the problem, because right now I have no idea what might be causing this (again).


  • Avatar of ThisUsernameIsMine ThisUsernameIsMine Oct 29, 2014 at 13:16 UTC - 0 likes

    Joining the TS server somehow results in two/duplicate in-game join announcements. I haven't seen any of this before.

    Last edited Oct 29, 2014 by ThisUsernameIsMine
  • Avatar of ThisUsernameIsMine ThisUsernameIsMine Oct 27, 2014 at 16:09 UTC - 0 likes

    @Firedroide: Go

    Oh god, i wasn't aware Debug was still enabled... lol :$
    I'll do another test, with Debug disabled

    edit: seems a lot better now :-)

    Last edited Oct 27, 2014 by ThisUsernameIsMine
  • Avatar of Firedroide Firedroide Oct 27, 2014 at 14:19 UTC - 1 like

    @ThisUsernameIsMine: Go

    You need to set teamspeak.Debug to false in your config.yml file.

    That's actually intended behaviour if debug mode is turned on :)

  • Avatar of ThisUsernameIsMine ThisUsernameIsMine Oct 26, 2014 at 22:33 UTC - 0 likes

    Hi again, i've tested the new build and this is the outcome:

    - http://dev.bukkit.org/paste/10809/

  • Avatar of ThisUsernameIsMine ThisUsernameIsMine Oct 26, 2014 at 02:35 UTC - 1 like

    @Firedroide: Go

    woah, that's quite some text there buddy! (you must be really happy they don't need you for the army :+) ).

    I'm aware of the DMCA stuff, but over at SpigotMC they're also planning to work on a 1.8 update, but it willl take some time and patience.

    About my question and the given solution/workaround: I fully understand your point of view, i'll happely test the new build you compiled and report back how it works.

    Thanks a lot and good to know you're (still) in good shape! ;-)


    PS: I don't like WikiCreole, i always use BBCode :D

    Last edited Oct 26, 2014 by ThisUsernameIsMine
  • Avatar of Firedroide Firedroide Oct 23, 2014 at 15:42 UTC - 0 likes

    @ThisUsernameIsMine: Go

    Hi ThisUsernameIsMine, I'm doing fine! Just got to know that I'm not required to join the army, so... yay :D

    As to your request, BukkitSpeak already slows down its reconnection attempts in what's basically an exponential function, starting at 1 minute and ending at around 60 minutes.

    Edit: Read below.

    I understand well that this is probably not a sufficiently clean solution for your issue. As stated in the Bukkit guidelines, plugins should usually not modify their own state (enabled, disabled). What is more, there would be no way for a BukkitSpeak command to re-enable the plugin, since disabling it via Bukkit causes all command handlers to be unregistered.

    Furthermore, I'm not really updating the plugin for Bukkit anymore, since the Bukkit development has been stopped by a DMCA takedown. I will try to release an updated and modified version of BukkitSpeak for the Sponge modding API as soon as their server implementation is at least functional. (At the moment, they're still waiting for the release of Forge and are putting more work into the development of the API itself.)

    Thus I'd recommend you download something like a plugin enabler / disabler, of which there are dozens here on dev.bukkit.org. From my experience, a plugin like this is really useful anyways, and it would be a nice fix for your issue without taking a ton of work by either you or me.

    I hope I haven't gone too overboard with this response and I also hope that this is an acceptable solution to your issue. As always, thank you very much for your input.

    EDIT: Just thought of a nice way to reduce the spam: BukkitSpeak now only logs any connection issue message once and then basically silences itself. When the plugin then reconnects to the TS server, that will be logged to the console. It's not a "turning it on and off again" solution but it should remove the reconnection spam.

    Dev build. It would be very nice if you could let me know if everything works as intended now, as I haven't had a chance to test the fix yet.

    EDIT 2: Why does anyone use WikiCreole???

    Last edited Oct 23, 2014 by Firedroide
  • 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.


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