Installer un bot de musique sur TeamSpeak

Un bot de musique se connecte à votre serveur TeamSpeak comme un client normal et lit de l’audio dans un salon. Les solutions courantes (Sinusbot, JTS3Servermod) fonctionnent sur le même principe : un compte Server Query pour l’authentification et un client virtuel pour la lecture.

Cause / Le problème

Sans login Server Query dédié, le bot tente de se connecter avec des identifiants instables et finit banni pour “flood” (trop de tentatives). Et sans whitelist des permissions, le bot ne peut ni rejoindre le salon ni y parler.

Solution

1. Choisissez un bot : Sinusbot (interface web, scripts) ou JTS3Servermod (léger, Java). Les deux se connectent comme un client TeamSpeak.
2. Créez un login Server Query dédié au bot. Dans le client TeamSpeak, connectez-vous en Server Admin puis :
   • Tools → ServerQuery Login (ou via le port query 10011).
   • Créez un compte musique_bot et notez le mot de passe généré.

   # Exemple de connexion query
   login musique_bot MotDePasseGenere
   use sid=1

3. Configurez le bot avec les identifiants du serveur :
   • IP, port voix (par défaut 9987)
   • Port Server Query (10011)
   • Login/mot de passe Server Query
   • Salon cible (channel ID)
4. Démarrez le bot via le panel ou en ligne de commande. Il apparaît dans le salon comme un client normal.
5. Whitelistez le bot dans les permissions pour éviter le flood ban. Ajoutez son identité (unique ID) à un groupe Bot avec :
   • i_client_channel_join_power suffisant
   • b_virtualserver_client_permission si besoin
   • i_client_music_volume (droits de lecture audio)
6. Évitez le flood ban : si le bot échoue plusieurs fois de suite (mauvais mot de passe, salon plein), TeamSpeak bannit l’IP. Solutions :
   • Vérifiez le mot de passe Server Query avant de lancer le bot.
   • Ajoutez l’IP du bot à la Query IP Whitelist dans query_ip_whitelist.txt.
   • Désactivez la persistance de connexion si le bot redémarre souvent.
7. En cas de flood ban : patientez (le ban dure généralement 1h) ou dé-bannissez via le panel. Corrigez les identifiants avant de relancer.
8. Commandes de base : la plupart des bots se pilotent par chat (!play <url>, !stop, !volume 50) ou via une interface web sur le port dédié (ex. 8087 pour Sinusbot).

Sur Mumble, il n’existe pas de bot musical aussi mature ; les solutions passent souvent par un pont vers un salon Discord ou un bot Python custom via Ice/Murmur.