Guía del Bot de Música

En nuestro servidor de TeamSpeak tenemos un bot de música (TS3AudioBot) para manquear a gusto entre compañeros y así bajar nuestro WN8 hasta el Rojo absoluto. Cualquier integrante del clan puede usarlo: solo tienes que escribirle los comandos por chat.

Para enviarle un comando, haz doble clic sobre el bot en la lista de usuarios para abrir un chat privado con él, o escribe el comando en el chat del canal donde esté el bot. Todos los comandos empiezan con el signo !.

Si aún no tienes TeamSpeak instalado, primero revisa la guía de instalación de TS3.

Empieza en 30 segundos

Un ejemplo de uso típico, paso a paso:

  1. Entra al canal donde está el bot.
  2. Pon una canción: !play https://www.youtube.com/watch?v=xxxxxxxx
  3. Añade más a la cola sin cortar la actual: !add https://www.youtube.com/watch?v=yyyyyyyy
  4. Ajusta el volumen: !volume 15
  5. Salta a la siguiente con !next, pausa con !pause y detén todo con !stop.

Reproducción básica

Lo esencial para poner música. Escribe el comando en el chat del bot (chat privado) o en el chat del canal donde esté el bot.

Comando Qué hace
!play <url> Reproduce un enlace: YouTube, Twitch, radio por streaming, archivo local, etc.
!play A secas, reanuda la reproducción si está en pausa.
!add <url> Añade a la cola sin cortar lo que está sonando.
!next Salta a la siguiente canción de la cola.
!previous Vuelve a la canción anterior.
!pause Pausa la reproducción.
!stop Detiene la reproducción por completo.
!seek 1:30 Salta a ese minuto de la canción. También admite valores relativos como +30 o -30 (segundos).
!song Muestra qué está sonando en este momento.
!queue Muestra las canciones que están en la cola de reproducción.
!clear Vacía la cola de reproducción.
!repeat off|one|all Modo repetición: apagado, repetir la canción actual o repetir toda la cola.
!random on|off Activa o desactiva la reproducción aleatoria.
!volume 20 Fija el volumen de 0 a 100. Por configuración suele estar limitado; subir por encima del límite requiere el permiso de "volumen alto".
!volume A secas, muestra el volumen actual.
  • Si escribes solo !play seguido de texto (sin enlace), el bot busca en YouTube y reproduce el primer resultado.
  • Los enlaces de listas de YouTube con !play solo reproducen el video. Para cargar la lista entera usa !list import (ver Playlists).

Playlists

Todos los comandos empiezan por !list y trabajan sobre un identificador de lista (<nombre>), que es cualquier nombre alfanumérico sin espacios.

Comando Qué hace
!list create <nombre> Crea una lista nueva.
!list delete <nombre> Elimina una lista.
!list add <nombre> <url> Añade una canción a la lista.
!list import <nombre> <url> Importa una playlist entera de YouTube o de una carpeta local.
!list show <nombre> Muestra el contenido de la lista.
!list play <nombre> Empieza a reproducir la lista desde el inicio.
!list play <nombre> <índice> Empieza a reproducir la lista desde una canción concreta.
!list queue <nombre> Añade toda la lista a la cola actual sin cortar lo que suena.
!list item delete <nombre> <índice> Elimina una canción de la lista por su posición.
!list item move <nombre> <de> <a> Mueve una canción de una posición a otra.
!list item get <nombre> <índice> Muestra el enlace guardado en esa posición.
!list list Muestra todas las listas guardadas.
  • Truco típico, radio 24/7: para una radio que se recupere sola si se cae el stream, mete uno o varios streams en una lista, lánzala con !list play <nombre> y activa !repeat all.
  • Los índices empiezan en 0. Usa !list show <nombre> para ver la posición de cada canción antes de moverla o borrarla.

Mover el bot y a quién escucha

Comandos para llevar el bot de un canal a otro, cambiar su apariencia y controlar en qué canales se escucha.

Comando Qué hace
!bot move <canal> Lleva el bot a otro canal. Puedes usar el nombre o el ID del canal.
!bot come Trae el bot al canal donde estás tú.
!bot name <nombre> Cambia el nombre con el que aparece el bot.
!bot description <texto> Cambia la descripción del bot.
!bot badges <valor> Cambia las insignias (badges) del bot.
!bot avatar <url> Cambia el avatar del bot por la imagen del enlace.
!bot avatar clear Quita el avatar del bot.
!whisper off|all|subscription Modo susurro. off: suena solo en su canal. all: suena en todos los canales. subscription: suena solo para quienes se hayan suscrito.
!subscribe Te suscribes tú al susurro del bot (con !whisper subscription activo).
!unsubscribe Dejas de escuchar el susurro del bot.
!subscribe channel <canal> Suscribe un canal entero al susurro del bot.
!unsubscribe channel <canal> Quita la suscripción de un canal.
!bot commander on|off Activa o desactiva el modo channel commander en el bot.
!bot info Muestra información de la instancia actual del bot.
!bot list Lista las instancias del bot que están activas (si manejas varias).
!bot connect template <nombre> Levanta una nueva instancia del bot a partir de una plantilla guardada.
!bot disconnect Desconecta la instancia actual del bot.
  • El susurro es útil para que la misma música se escuche en varios canales a la vez sin tener que mover el bot.

Historial

El bot guarda todo lo que ha reproducido. Cada entrada tiene un ID que puedes usar para volver a ponerla.

Comando Qué hace
!history last Muestra las últimas canciones reproducidas.
!history last <n> Muestra las últimas n canciones.
!history play <id> Vuelve a reproducir una canción del historial.
!history search <texto> Busca en el historial por título.
!history add <id> Añade una canción del historial a la cola.
!history from <usuario> Muestra las canciones que pidió un usuario.
!history id <id> Muestra los detalles de una entrada del historial.
!history delete <id> Elimina una entrada del historial.

Búsqueda y utilidades

Otros comandos útiles del bot.

Comando Qué hace
!search <texto> Busca en YouTube y muestra una lista de resultados numerados.
!search play <n> Reproduce el resultado número n de la última búsqueda.
!search add <n> Añade a la cola el resultado número n de la última búsqueda.
!help Muestra la lista de comandos disponibles.
!help <comando> Muestra la ayuda de un comando concreto, por ejemplo !help list.
!version Muestra la versión del bot.
!getuser name Muestra tu nombre tal como lo ve el bot.
!quiz on|off Modo quiz: el bot oculta el título de lo que está sonando para que adivines la canción.
  • Si un comando no te responde o dice que no tienes permiso, avisa a un administrador del clan para que revise los permisos del bot.

Los parámetros entre < > se reemplazan por el valor real, sin los signos. Las opciones separadas por | indican que debes elegir una. El bot es TS3AudioBot, un proyecto de código abierto.