Mi bot de música de Discord no funciona: qué comprobar

Antes de empezar

• Ten un bot de Build Discord Bots online e invitado a tu servidor. Activa Music en la pestaña Modules y espera a que el estado vuelva a online antes de probar.
• Usa un canal de voz de prueba donde el rol del bot tenga Conectar y Hablar, y un canal de texto donde tenga Ver canal, Enviar mensajes e Insertar enlaces. Únete tú también al canal de voz antes de ejecutar un comando.

1. Confirma el canal de voz y los permisos

   Únete primero al canal de voz y, desde un canal de texto donde el bot pueda responder, usa /play con un artista y título. También puedes usar !play si tu bot mantiene ese prefijo. El bot no se une si quien solicita la canción no está en un canal de voz.

   Si responde que necesita permiso para unirse o hablar, corrige Conectar y Hablar para el rol del bot en ese canal o categoría. Comprueba también Ver canal, Enviar mensajes e Insertar enlaces en el canal de texto. No concedas Administrator como sustituto: una excepción de permisos del canal puede seguir siendo la causa y los permisos mínimos son más seguros.

2. Distingue una búsqueda de la reproducción del proveedor

   El comando /play acepta el nombre de una canción o un enlace http o https. Las búsquedas por texto se envían primero a SoundCloud; si no hay coincidencia, el bot repite la búsqueda en YouTube. Una ruta de archivo u otra clase de dirección se rechaza: busca por artista y título en su lugar.

   YouTube puede exigir inicio de sesión para contenido de discográficas, con restricción de edad o región, especialmente desde centros de datos. Un bot alojado no puede iniciar sesión por una persona, así que un enlace puede encontrar un título y fallar cuando empieza a reproducirse. No anuncies que todos los enlaces de YouTube funcionarán.

3. Lee el aviso de alternativa de SoundCloud

   Ante un error de inicio de sesión, edad o disponibilidad de YouTube, el bot toma el artista y el título, busca la canción en SoundCloud y reproduce la primera coincidencia. Publica un aviso amarillo en el canal con la pista de SoundCloud elegida.

   Esa coincidencia puede ser otra subida —por ejemplo una versión en directo, una remasterización o una versión—. Si SoundCloud no encuentra una alternativa adecuada, el bot avisa y omite la pista para que una entrada problemática no bloquee la cola. Prueba otra redacción de búsqueda o un enlace de SoundCloud, en vez de repetir el mismo enlace de YouTube.

4. Espera y vuelve a probar si el sistema de audio no está disponible

   Music no descarga el audio desde tu bot. Envía la solicitud a un servidor de audio Lavalink administrado por la plataforma, que busca la pista y la transmite al canal de voz. Si el bot informa que el sistema de música no está disponible o que todos los servidores Lavalink no están disponibles y está intentando reconectarse, no es un permiso que puedas arreglar en el servidor.

   Espera un minuto y vuelve a probar una sola canción antes de cambiar ajustes. Si el sistema vuelve, usa /queue para comprobar lo que quedó esperando. Si el mensaje era de permisos, vuelve al paso del canal de voz; cambiar el volumen o el plan no recupera un servidor de audio que no está disponible.

5. Revisa la salida automática y prueba controles básicos

   En «Salida Automática», abre «Salir cuando esté vacío». Está activado de forma predeterminada: cuando no queda ninguna persona en el canal, el bot espera «Retraso de Salida (segundos)» —de 5 a 300 segundos, 30 inicialmente—, detiene la reproducción, vacía la cola y sale. Sube el retraso si la gente se desconecta y vuelve a entrar brevemente.

   Con una segunda solicitud, usa /queue y después /nowplaying, /pause, /resume y /skip. /stop termina la reproducción, vacía la cola y desconecta al bot. /seek acepta una posición como 1:30, /shuffle mezcla las pistas pendientes y /loop acepta off, track o queue. Estos comandos también tienen la forma con prefijo, como !play.

6. Comprueba los límites antes de atribuir el problema al plan

   Music es un módulo Free. En «Reproducción», cuando se aplican los límites de Free, la cola y la importación de una lista se limitan a 20 pistas. «Volumen Predeterminado» va de 0 a 100; «Tamaño Máximo de la Cola» va de 10 a 500, pero el límite de Free prevalece. «Permitir Duplicados» controla si se puede añadir la misma canción más de una vez.

   Las listas guardadas, Audio Filter y 24/7 Mode (Stay in voice when idle) requieren Pro. En Pro, tu Max Queue Size sigue siendo el límite de cola que configuras. Un límite de Free no explica que el bot no pueda Conectar o Hablar ni un mensaje de Lavalink no disponible; comprueba primero la causa indicada por la respuesta del bot.