Plugin Teamspeak3 Info

made by undef.de

This plugin display a little widget with the "current connected clients/max. clients" and a small Teamspeak3-Logo, just like the MiniWidget from Records-Eyepiece.

If a player click on this mini-widget, then the info-window comes up where some Teamspeak-Server-Statistics are to see. The channels and currently connected users are in a seperated box also included (max. 75 entries).

Includes some of the code from tsstatus.php made by Sebastien Gerard.


Screenshots

Info Widget
Info Window

Configuration

If you did not host your Teamspeak3-Server by yourself, then the hosters should give you detailed information at which port your rented Teamspeak3-Server is listening on for the query-service and many more.

Most of them use different names for the related options in the config/teamspeak3_info.xml in the block. And here I try to give a lookup table for them:

Option Remark Possible names
<id> Required Server ID
<public_host> Required Direct Host
<public_port> Required UDP Port, Join Port
<query_host> Optional Direct Host, Query Host
<query_port> Required Query Port

Please make sure that you have added a query user, otherwise this plugin can not read the required data and would display only ---/---.


You do not know your server ID?

If you did not know your server ID, you can retrieve them via the shell (Linux) / command (Windows) like this:

Retrieve the server ID
telnet HOST PORT
serverlist -uid

Replace HOST with your Query Host (or IP-Address) and PORT with your Query Port from your TS3-Server.

Example answer from your Teamspeak3-Server
virtualserver_id=1 virtualserver_port=9987 virtualserver_status=online
virtualserver_clientsonline=1 virtualserver_queryclientsonline=1
virtualserver_maxclients=32 virtualserver_uptime=8130166 virtualserver_name=TeamSpeakServer virtualserver_autostart=1
virtualserver_machine_id virtualserver_unique_identifier=eIbse78G5JY/TQSbONcYvAStuE8=
error id=0 msg=ok

Behind virtualserver_id= you will see your server ID.


Setup the whitelist

Please make sure that you have added the IP from your server that queries the Teamspeak3-Server into query_ip_whitelist.txt, otherwise this Plugin gets banned and would display only ---/--- or let UASECO hang.

Alternative you can also change the flood protection limits with this commands:

Change the limits
instanceedit serverinstance_serverquery_flood_commands=50
serverinstance_serverquery_flood_time=3

Chat-Commands

  • /ts3 reload

    Reload the config/teamspeak3_info.xml

    For MasterAdmins only!


Installation

  • Edit config/teamspeak3_info.xml to your needs and place it into the config folder of UASECO.
  • The plugin/plugin.teamspeak3_info.php has to be stored into the plugins folder of UASECO.
  • The locales/plugin.teamspeak3_info.xml has to be stored into the locales folder of UASECO.
  • Edit config/plugins.xml and add <plugin>plugin.teamspeak3_info.php</plugin> to it.
  • That is it, restart UASECO and enjoy!

Downloads

File Version Build Downloads Author(s)
plugin.teamspeak3_info.php 0.9.9 2018-06-03 26 undef.de


License

General Public License version 3

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.


Info

For feedback, help, bugs or suggestions please use the official ManiaPlanet forum at the UASECO section.

This is a private enthusiast Website. Maniaplanet, Trackmania, Shootmania, Nadeo are trademarks of Ubisoft Entertainment.
Windows is a registered trademark of Microsoft Corporation.

Last modified: Sat, 15 Jun 2019 20:36:14 +0200