Cómo configurar un bot de música en Discord

Antes de empezar

• Ten un bot conectado y añadido al servidor, y activa el módulo de música.
• El bot debe poder ver el canal de texto, enviar mensajes e insertar enlaces. En el canal de voz necesita Conectar y Hablar. Haz la prueba en un canal normal con una persona dentro.

1. Abre música y ajusta la reproducción

   Abre tu bot, entra en «Módulos» y activa el módulo. Abre su configuración con el botón de engranaje y elige tu «Servidor». El bot debe estar conectado y dentro del servidor para cargar sus canales y roles. Los ajustes se guardan por servidor.

   En «Reproducción», configura «Volumen Predeterminado» con un nivel moderado. «Tamaño Máximo de la Cola» fija el tamaño de la cola dentro de los límites de tu plan. «Permitir Duplicados» decide si una canción puede aparecer varias veces.

2. Decide cuándo saldrá del canal de voz

   En «Salida Automática», revisa «Salir cuando esté vacío» y «Retraso de Salida (segundos)». Si la salida está activada y no quedan personas escuchando, el bot sale tras el retraso configurado. No confundas un canal vacío con una cola que acaba de terminar.

   La opción «Permanecer en voz mientras está inactivo» corresponde al modo 24/7 de Pro. Los filtros de audio también requieren Pro. Para comprobar la reproducción básica no necesitas activar ninguna de esas funciones. Pulsa «Guardar Configuración» y espera a ver «Guardado ✓». Si aparece un aviso de error de sincronización, reinicia el bot desde su página y espera a que vuelva a estar conectado antes de probarlo.

3. Entra en voz y reproduce una canción

   Únete a un canal de voz y usa /play con el título y artista de una canción, o con un enlace admitido. Puedes usar !play con el prefijo predeterminado. Mantén play en inglés: traducir el nombre no crea un comando equivalente.

   Si el bot no entra o no se oye, comprueba Conectar y Hablar en ese canal, además del volumen. No concedas Administrador como sustituto de revisar los permisos. Repite la prueba con una sola solicitud para no llenar la cola mientras buscas el problema.

4. ¿Falló YouTube? Revisa la fuente

   La búsqueda de texto usa SoundCloud de forma predeterminada en la configuración del módulo. Algunos enlaces de YouTube pueden fallar porque el servicio exige iniciar sesión a los bots alojados, aunque se haya encontrado el título. Encontrar una canción y poder reproducirla son pasos diferentes.

   Ante ciertos fallos de YouTube, el bot intenta buscar la canción en SoundCloud y avisa del cambio. Puede elegir otra versión del mismo tema. Si no encuentra una alternativa reproducible, omite la pista. Revisa el aviso y prueba otra canción; no prometas a tus miembros que todos los enlaces funcionarán.

5. Controla la cola y termina la prueba

   Añade otra canción y usa /queue para revisar la cola. /nowplaying muestra la pista actual; /pause y /resume pausan y reanudan; /skip pasa a la siguiente. /seek permite ir a una posición como 1:30, /shuffle mezcla las pistas pendientes y /loop acepta off, track o queue.

   /stop termina la reproducción, vacía la cola y desconecta el bot. Comprueba ese resultado al acabar la prueba. Si tu bot usa otro prefijo, sustituye ! en las versiones de texto; los nombres de los comandos siguen siendo los mismos.

6. Comprueba los límites de tu plan

   Cuando se aplican los límites de Free, la cola tiene un máximo de 20 pistas y una importación de lista añade como máximo 20. Un tamaño configurado menor puede reducir la cola disponible. Las listas guardadas, los filtros de audio y el modo 24/7 requieren Pro.

   En Pro no hay un límite de cola impuesto por el plan, pero sigue aplicándose el tamaño máximo que configures. /playlist gestiona listas guardadas, /filter cambia filtros y /247 controla el modo 24/7 cuando esas funciones están disponibles. Revisa las funciones habilitadas para tu cuenta antes de anunciarlas a tu servidor.