BukkitSpeak

logo

BukkitSpeak

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!

Features:

  • 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>

Commands

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.

Configuration

Moved to my GitHub Wiki.

Permissions

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

Disclaimer:
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)


Donations

Donate
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 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 :)

    BFAK:Firedroide,90621593,b23d7c6ec2a5a56a0e2a4422bf2057ed72ddedeeddb080ad2654eacbb5af27ef

  • Avatar of uncovery uncovery May 05, 2015 at 23:51 UTC - 1 like

    @Firedroide: Go Hey there, thanks for the timely help!

    I need some additional info here. I understand you only want messages from the "global" channel transmitted to the TeamSpeak server, so there must be messages that get picked up from somewhere else.

    I just specified that to make sure that I do not want everything from all in-game channels to be sent to TS, only that channel. Right now, I cannot get any chat from the game to be seen on the TS server. I want the "Global" channel from HeroChat to be broadcasted to the specified Channel.

    So I changed the settings for the broadcast and the permission and that seems to have fixed everything, so all works as intended now! Thanks, great plugin!

    Last edited May 06, 2015 by uncovery
  • Avatar of Firedroide Firedroide May 05, 2015 at 15:39 UTC - 0 likes

    @uncovery: Go

    Hi there, uncovery! First of all, thanks for using my plugin and for not just trashing it when it didn't work quite right at the start :)

    So, let's get to your doesn't-work list:

    • I could not get any in-game items (actions/join/chat) to be shown on the teamspeak server

    This could very well be a permissions issue. BukkitSpeak will only send notifications for players who have the permission bukkitspeak.sendteamspeak.* set. This permission node should usually be true for everyone, but maybe your permissions plugin is causing some issues here.

    It could also be that you have another plugin installed that messes these events up. For example, BukkitSpeak does not listen to cancelled events or events with a join / leave / kick message of "null". But the chance of this happening is rather low, only really inexperienced programmers would set these values to null just for the heck of it.

    • I do not want the global chat from TS to be shown in-game if possible.

    Easy fix, just set

    SendServerBroadcastsToMinecraft: false
    

    This will make it so no TS server-wide chat is sent to the Minecraft server anymore.

    • I only want to see the global channel chat from HeroChat to be shown in the specified channel in Teamspeak

    I need some additional info here. I understand you only want messages from the "global" channel transmitted to the TeamSpeak server, so there must be messages that get picked up from somewhere else.

    What exactly is it that is also being sent? Messages from other HeroChat channels? Messages outside of HeroChat?

    Also you must know I'm not that familiar with HeroChat and haven't been watching its development lately, so there might be features I'm not familiar with. Therefore, please bear with me and please explain the issue as precisely as possible so I can help you :)

    • Joins and quits on the TS server can be shown in-game

    Also not sure what exactly you meant by this. Above you stated that TS joins / quits are transmitted to the TS server correctly, so wherein lies the issue?

    Do you want to turn this feature off? Then you'd have to set

    SendServerEventsToMinecraft: false
    

    for BukkitSpeak not to message you about TS server joins / quits and

    SendChannelEventsToMinecraft: false
    

    for it not to send TS channel joins / quits.

    I'm sorry I didn't understand what you meant by each issue, but please get back to me so we can figure this out together.

  • Avatar of uncovery uncovery May 04, 2015 at 04:52 UTC - 0 likes

    Hi there, thanks for this plugin, really appreciated! I just installed it and am trying to get it to work as I want, but I am running into a few snags.

    First of all, I am running the latest snapshot that you linked below. Second of all, I am running HeroChat with a "Global" channel.

    So what I could get done is:

    • Joins/quits on the TS server are shown in-game
    • I could designate a channel on TS, and joins/quits in that channel are shown in-game
    • When someone says something on TS global chat, it's shown in-game with a [TS] - prefix.
    • When someone says something in the specific channel, it's shown in-game without a prefix

    What does not work?

    • I could not get any in-game items (actions/join/chat) to be shown on the teamspeak server
    • I do not want the global chat from TS to be shown in-game if possible.
    • I only want to see the global channel chat from HeroChat to be shown in the specified channel in Teamspeak
    • Joins and quits on the TS server can be shown in-game

    The configs that I think are critical for this are these here:

      ChannelID: 29
      ChannelPassword: ''
    
      SendServerEventsToMinecraft: true
      SendServerBroadcastsToMinecraft: true
      SendChannelEventsToMinecraft: true
      SendChannelChatToMinecraft: true
    
      SendChatToTeamspeak: channel
    
      Herochat:
        enabled: true
        channel: Global
        SendTeamspeakEventsToChannel: true
    

    What else do I need to set to make it work?

    Last edited May 04, 2015 by uncovery
  • Avatar of Firedroide Firedroide Apr 11, 2015 at 11:47 UTC - 0 likes

    @Robert_LP: Go

    I'm assuming you're running the latest official release, v0.67.

    This is a somewhat known bug. Try out the latest snapshot release from the build server. That version should fix your issue.

    Please tell me if any of my assumptions were wrong or the new version didn't fix the problem.

  • Avatar of Robert_LP Robert_LP Apr 10, 2015 at 19:06 UTC - 0 likes

    Hello. I habe two join-messages one behind the other in minecraft, if I join the ts3 server. The left-messages come only once.

    Can any one help me, please?

    Last edited Apr 10, 2015 by Robert_LP
  • Avatar of ThisUsernameIsMine ThisUsernameIsMine Apr 09, 2015 at 17:52 UTC - 0 likes

    @Firedroide: Go

    Thanks for clearing that up and sorry for taking work out off your hands.

    I will only create tickets from now on (if there's an unreported bug) ;-)

    Last edited Apr 09, 2015 by ThisUsernameIsMine

    My problem(s) with MyCommand and Ban Management

    Portable and Updatable Minecraft Launcher
    + http://web.minecraftnoob.com +

    -:- Me on YouTube -:-

    http://i.imgur.com/Z1kXY8n.png

  • Avatar of Firedroide Firedroide Apr 09, 2015 at 11:08 UTC - 0 likes

    @cicatrice74: Go @ThisUsernameIsMine: Go

    Yes and no, it depends if you're actually a server admin or not.

    As long as you can generate a ServerQuery login, you'll be able to use the plugin.

    See here on how to do so.

    Also @ThisUsernameIsMine: Go, I'm still around despite there not being any major code changes. You don't need to constantly have this page open and answer support requests for me.

  • Avatar of ThisUsernameIsMine ThisUsernameIsMine Apr 09, 2015 at 09:46 UTC - 0 likes

    @cicatrice74: Go

    This is for managing your TeamSpeak server/channel from within Minecraft and to transmit/receive (text) chat, not for broadcasting voice (if that's what you ment) ;-)

    You'll also need a login name and password for the Server Query, otherwise the plugin won't be able to communicate with the TeamSpeak server.

    With the privilege key you'll only be able to administer/manage on the TeamSpeak server/channel itself.

    Last edited Apr 09, 2015 by ThisUsernameIsMine
  • Avatar of cicatrice74 cicatrice74 Apr 09, 2015 at 09:20 UTC - 0 likes

    i have not a server but a privilege key for channel and subchannel administration on a ts server, can i use this plugin to broadcast on my server?

Facts

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

Authors