Bot principal
01 // CONTROL
Headless
Seguridad, automatización, moderación y herramientas operativas para tu comunidad.
Headless Control Platform
Headless
Security Engine
Automation
Components V2
Headless
Seguridad • Automatización • Gestión de comunidades
Control operativo para servidores de Discord que necesitan protección, claridad y herramientas de staff en una sola plataforma.
root@headless:~$ monitor --security --live
READYMotor de protección cargado
PASSScopes y sesiones aislados
SCANAudit stream sincronizado
WATCH
Esperando telemetría pública
Red Headless
Protección activa en comunidades reales.
Una vista pública y segura de la escala operativa de Headless, sin exponer IDs, invitaciones ni configuración privada.
CORE
Revisando
estado operativo
GUILDS
--
servidores protegidos
MEMBERS
--
miembros conectados
GATEWAY
--
latencia actual
Esperando señal pública
Sincronizando comunidades
Headless Labs
Afiliados de la red.
Dos bots independientes, creados para complementar comunidades de Discord sin compartir acceso administrativo ni configuración.
Bot principal
02 // AUDIO
Headless Music
Un bot musical separado para llenar los canales de voz sin tocar la administración de Headless.
Headless Labs // Audio
Headless Music
El módulo de audio de Headless: un bot profesional para Discord con comandos slash, colas separadas por servidor, catálogo opcional de Spotify y Lavalink como motor de reproducción.
Versión 1.3.7
Licencia MIT
NOW PLAYING
UP NEXT
Headless After Dark
LIVE MIX · HEADLESS MUSIC
01
Headless + Headless Music
La dashboard y el servicio de audio permanecen separados.
Headless Dashboarddocumentación y control futuro
HTTPS + API key
Music Gatewayfuturo, autenticado
Discord / Lavalink
Headless Musicservicio de audio
La dashboard nunca recibe el token de Discord, la contraseña de Lavalink ni secretos de Spotify. La versión actual opera directamente por Discord.
02
Comandos
Todos son slash commands y las acciones de reproducción requieren estar en el mismo canal de voz que el bot.
| Comando | Parámetros | Descripción |
|---|---|---|
/play | búsqueda | Reproduce o añade canción, artista, playlist o URL. Máximo 300 caracteres. |
/pause | — | Pausa la pista actual. |
/resume | — | Reanuda una pista pausada. |
/skip | — | Salta la pista actual. |
/stop | — | Detiene y vacía la cola. |
/disconnect | — | Vacía la cola y desconecta. |
/volume | nivel 0–200 | Cambia el volumen. |
/nowplaying | — | Muestra pista, fuente, duración y progreso. |
/queue | página opcional | Muestra la cola paginada del servidor. |
/shuffle | — | Mezcla las canciones pendientes. |
/remove | posición | Elimina una pista de la cola. |
/loop | desactivado, canción, cola | Cambia el modo de repetición. |
/filter | efecto | Aplica Bass boost, Nightcore, Vaporwave, Karaoke o Suave. |
/ping | — | Muestra la latencia de Discord y Lavalink. |
/help | — | Abre la ayuda interactiva Components V2. |
/helpMusicFavourites · SOONConfigMiscellaneousLastfm · SOONSpotifyFilters
03
Flujo de audio
Resolución por servidor, con fallback cuando una fuente no entrega una pista reproducible.
- /playEl usuario ejecuta el comando dentro de un servidor.
- ValidaciónSe valida la consulta y el acceso al canal de voz.
- CatálogoSpotify / LavaSrc resuelve metadatos cuando está configurado.
- ResoluciónLavalink obtiene una pista; SoundCloud puede actuar como fallback.
- ColaLa pista se reproduce o entra en la cola independiente del servidor.
- FallbackSi una alternativa falla, se intenta otra versión de la búsqueda.
YouTube no es el flujo recomendado. Ante verificaciones anti-bot, usa nombre y artista o una URL de Spotify.
04
Seguridad e integración futura
La documentación actual describe una frontera segura; no habilita un control remoto todavía.
Headless Music funciona de forma autónoma por Discord. No expone una API HTTP pública de control.
Un gateway autenticado podrá publicar salud, servidores, player y cola usando HTTPS, API key rotatoria y rate limits.
Cada endpoint deberá validar sesión, servidor y permisos; WebSocket o SSE solo para eventos del reproductor.
- Nunca envíes secretos al frontend ni a la dashboard.
- Valida el servidor en cada petición y devuelve códigos de incidente, no trazas internas.
- Mantén Lavalink en una red privada y usa HTTPS para cualquier gateway futuro.
- El contador y el estado solo muestran información autorizada por Discord; no se publican credenciales ni datos privados.
05
Solución de problemas
Comprobaciones rápidas antes de abrir un incidente.
No aparece /play o /help
Revisa los scopes bot y applications.commands, SYNC_COMMANDS=true y el servidor de prueba.
Spotify o Lavalink no carga
Prueba una búsqueda por nombre y artista. Si el problema continúa, comprueba el estado del servicio sin compartir credenciales.
No se escucha
Comprueba View Channels, Connect, Speak, PyNaCl/DAVE y que el usuario esté en el canal de voz correcto.
El contador es incompleto
El total depende de los datos que Discord entrega al bot y puede tardar en actualizarse.
Usa Headless Music respetando las reglas de Discord, Spotify, Lavalink, SoundCloud y las licencias del contenido reproducido.
Acceso seguro
Información pública, controles privados.
La pagina publica documenta Headless y abre la dashboard administrativa real mediante Discord OAuth. Cada usuario solo puede modificar servidores y modulos para los que tenga permisos.
Importante
No pegues tokens, webhooks ni contrasenas. Las acciones se autorizan con Discord y se validan nuevamente en el backend.
Arquitectura operativa
Módulos conectados a una configuración por servidor.
Seguridad, moderación, automatización y comunidad comparten permisos, auditoría y estado sincronizado con la dashboard.
Telemetría autorizada
User History y Server Analytics.
Los resúmenes públicos se sanitizan. Las consultas completas se sirven desde la dashboard mediante OAuth2 y permisos verificados para el servidor seleccionado.
Referencia de comandos
Comandos con ejemplos y documentacion.
Dashboard publico
Manejar servidor seguro por servidor.
Iniciar con Discord abre el panel público de operadores, limitado por permisos, servidor y módulo. La Owner Dashboard es una aplicación local separada.
Control por servidor
Tu comunidad, bajo control.
Conecta Discord para administrar únicamente los servidores y módulos que tus permisos autorizan.
OAuth2
CSRF protegido
Acceso aislado
Confianza y transparencia
Tu servidor sigue siendo tuyo.
Documentación clara sobre los datos públicos, el uso responsable de Headless y los límites de seguridad.
Sin tokens públicos
Control por permisos
Owner privado
Solo datos seguros para el público.
La página muestra estado y documentación, nunca secretos internos del bot.
- Sin tokens ni URLs privadas de webhooks
- Sin logs internos ni herramientas owner
- Solicitudes de eliminación disponibles
Usa Headless responsablemente.
Las automatizaciones están diseñadas para comunidades legítimas y personal autorizado.
- Moderación y seguridad autorizadas
- Sin spam, self-bots ni abuso de permisos
- Acceso revocable por seguridad
El admin privado sigue privado.
GitHub Pages sirve la interfaz pública; las acciones reales pasan por una API protegida.
- OAuth, CSRF y sesiones seguras
- Validación de servidor y permisos
- Sin base de datos expuesta al navegador