Bot principal
01 // CONTROL
Headless
Seguridad, automatización, moderación y herramientas operativas para tu comunidad.
HeadlessLABS
Headless Control Platform
Headless
Security Engine
Automation
Components V2
HeadlessProtección seria.
Comunidad libre.
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
01 / Seguridad, sin concesiones
El control no se delega.
El control no se delega.
Se configura.
Anti-Nuke es el núcleo de seguridad de Headless. Define qué puede hacer cada usuario, rol o aplicación, y consulta cómo se resuelve su política efectiva.
Explorar Anti-NukeANTI-NUKE / CAPABILITIESGUÍA
Usuarios y rolesAllow · Monitor · Deny
Bots y aplicacionesConfianza configurable
Acciones sensiblesPolítica por servidor
Smart SetupPreview → Confirmación
Vista conceptual de funciones documentadas. No representa el estado ni los eventos de un servidor.
Una comunidad completa.
Un solo Headless.
Moderación ↗Acciones y casos para tu staff.
Tickets ↗Soporte organizado por servidor.
Niveles & XP ↗Progreso y recompensas.
Welcome ↗La primera impresión importa.
Roles ↗Paneles y grupos exclusivos.
Logs ↗Contexto para cada acción.
Ver todos los módulos →
✦ HEADLESS PREMIUMEl siguiente capítulo.Coming soon ↗
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.8.0
Licencia MIT
MusicComprobando
DiscordComprobando
LavalinkComprobando
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 y funciones
Los 30 comandos slash disponibles. Las acciones de reproducción requieren estar en el mismo canal de voz que el bot.
| Comando | Parámetros | Descripción |
|---|---|---|
| Reproducción y conexión | ||
/play | búsqueda | Reproduce o añade canción, artista, playlist o URL. Máximo 300 caracteres. |
/connect | — | Conecta Headless Music al canal de voz del usuario. |
/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. |
/nowplaying | — | Muestra la pista actual, fuente, duración y progreso. |
| Cola y biblioteca | ||
/queue | página opcional | Muestra la cola paginada e independiente del servidor. |
/history | página opcional | Muestra las canciones reproducidas recientemente en el servidor. |
/shuffle | — | Mezcla las canciones pendientes. |
/remove | posición | Elimina una pista concreta de la cola. |
/clear | — | Vacía la cola sin detener la canción que está sonando. |
/clearliked | — | Elimina todas las canciones guardadas como favoritas por el usuario. |
| Configuración del reproductor | ||
/volume | nivel 0–200 | Cambia el volumen. |
/loop | desactivado, canción, cola | Cambia el modo de repetición. |
/247 | estado | Activa o desactiva la conexión permanente del reproductor. |
/announce | estado, canal opcional | Configura los anuncios de canciones y el canal donde se publican. |
/autoplay | estado | Activa o desactiva las recomendaciones automáticas cuando termina la cola. |
/buttons | estado | Activa o desactiva los controles interactivos del reproductor. |
/customize | nombre opcional, restablecer | Personaliza o restablece el apodo del bot en el servidor. |
| Filtros de audio | ||
/filter | efecto | Aplica o desactiva un efecto de audio desde el selector completo. |
/bassboost | — | Refuerza las frecuencias graves. |
/chipmunk | — | Eleva tono y velocidad con efecto Chipmunk. |
/darthvader | — | Aplica una voz más profunda y lenta. |
/daycore | — | Reduce velocidad y tono para un sonido DayCore. |
/deepbass | — | Aplica un perfil de graves más profundo. |
| Ayuda y diagnóstico | ||
/ping | — | Muestra la latencia de Discord y Lavalink. |
/debug | — | Genera un reporte técnico seguro para diagnóstico y soporte. |
/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.
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
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.
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