Query Server & API TeamSpeak 3

Query Server & API TeamSpeak 3

Le ServerQuery TeamSpeak 3 est une interface texte TCP (port 10011) permettant d'automatiser administration, bots status, panels web et intégrations Discord. Ce guide couvre activation, sécurisation, commandes essentielles et bonnes pratiques sur serveur hébergé.

Qu'est-ce que ServerQuery ?

Protocole ligne de commande : connexion TCP, login, exécution commandes (clientlist, channelcreate, sendtextmessage…). Utilisé par TS3StatusBot, Auron, panels PHP, etc.

Prérequis

• TS3 en ligne, démarrage
• Port 10011 accessible (limité IP recommandé)

Activer & sécuriser Query

1. Identifiants query par défaut visibles au premier setup, changez-les immédiatement
2. Client TS3 → Outils → Options → Application → Query, ou fichier query_ip_whitelist.txt
3. Ajoutez uniquement IP de vos bots/panels au whitelist
4. Créez un compte query dédié par bot avec permissions minimales
5. Désactivez login query Guest si exposé publiquement

Première connexion query (exemple)

telnet IP 10011
login client_login_name=admin client_login_password=VOTRE_MDP
use port=9987
clientlist

Remplacez par bibliothèque TS3 Query en Python/Node pour bots production.

Commandes utiles

• clientlist, joueurs connectés
• channelcreate channel_name=Salon password=xxx
• sendtextmessage targetmode=3 msg=Annonce serveur
• banadd ip=xxx.xxx.xxx.xxx time=3600
• serversnapshotcreate, backup automatisé

Bots & intégrations

• Statut web, affiche nombre connectés sur site
• Discord bridge, sync présence ou création channels
• Anti-AFK / modération, kick auto selon règles

HTTP Query (plugin)

TS3 natif est TCP texte. Certains hébergeurs ou wrappers exposent HTTP, vérifiez la doc de votre bot. Sinon, exécutez le bot sur VPS avec accès whitelist Query.

Dépannage

• error id=520 invalid login, mauvais identifiants query
• Connection refused 10011, pare-feu, TS3 arrêté, mauvaise IP
• Flood ban query, trop de requêtes, espacer appels bot

Voir aussi : permissions, sécurité.