# Headless

## Descripción general

- [Introducción](https://docs.headlesslabs.xyz/docs/introduction.md): Headless es un bot de Discord con moderación, protección del servidor, automatización y herramientas de comunidad. Esta guía describe su propio prefijo, comandos y módulos; no asume compatibilidad con otro bot.
- [Primeros pasos](https://docs.headlesslabs.xyz/docs/getting-started.md): Invita Headless, comprueba su acceso y prueba los comandos básicos. La Dashboard es opcional para empezar.

## Configuración de seguridad

- [Anti-Nuke](https://docs.headlesslabs.xyz/docs/security/anti-nuke.md): Configura las protecciones Anti-Nuke de Headless y entiende cuándo una detección puede generar una respuesta automática.
- [Anti-Raid / Join Gate](https://docs.headlesslabs.xyz/docs/security/anti-raid.md): Join Gate evalúa cada ingreso con reglas independientes para oleadas, cuentas sin avatar personalizado y antigüedad de la cuenta. Su configuración es por servidor e independiente del interruptor de Anti-Nuke.
- [Configuración de moderación](https://docs.headlesslabs.xyz/docs/security/moderation.md): Prepara moderación, roles de mute y mensajes de acción con los permisos reales de Headless.
- [Advertencias](https://docs.headlesslabs.xyz/docs/security/warnings.md): Advertencias conserva un historial auditable por servidor y miembro. Las advertencias retiradas siguen visibles y no activan sanciones automáticas por cantidad.
- [Purge](https://docs.headlesslabs.xyz/docs/security/purge.md): Purge elimina mensajes del canal actual con filtros opcionales. La operación está limitada por el máximo configurado para el servidor y registra el resultado en Logs.
- [Cases](https://docs.headlesslabs.xyz/docs/moderation/cases.md): Los casos unifican acciones de moderación de Headless en un historial por servidor. Usa el ID del caso para revisar el detalle, anotar seguimiento o corregir su motivo.
- [Herramientas de usuario](https://docs.headlesslabs.xyz/docs/moderation/user-tools.md): Consulta perfiles y historiales observados por Headless, y conoce el alcance y los permisos de cada comando de usuario.
- [Seguridad del contenido](https://docs.headlesslabs.xyz/docs/security/content-filters.md): Configura los filtros de mensajes de Sentinel y distingue sus excepciones de las reglas AutoMod nativas de Discord y de la whitelist Anti-Nuke.
- [Permisos ficticios](https://docs.headlesslabs.xyz/docs/security/fake-permissions.md): Fake Permissions asigna capacidades virtuales a un rol para las comprobaciones compatibles de comandos Headless. No cambia los permisos nativos de Discord ni convierte el rol en administrador del servidor.
- [Honeypot](https://docs.headlesslabs.xyz/docs/security/honeyspot.md): Configura un único canal señuelo por servidor para detectar mensajes de miembros no exentos y aplicar una respuesta compatible con Headless.
- [Jail](https://docs.headlesslabs.xyz/docs/security/jail.md): Jail aísla a un miembro con un rol del servidor, guarda sus roles previos y luego intenta restaurar los que sigan disponibles y el bot pueda gestionar. No programa la salida: un moderador debe ejecutar `unjail`.
- [Link Guard & Vanity](https://docs.headlesslabs.xyz/docs/security/link-guard.md): Configura el detector de invitaciones y enlaces, el tracker de invitaciones y los rewards de Vanity Status con sus límites reales.

## Configuración del servidor

- [Moderación de canales](https://docs.headlesslabs.xyz/docs/server/channels.md): Bloquea o restaura canales, configura slowmode, aplica lockdown al servidor y consulta las limitaciones del comando de recreación.
- [Registros](https://docs.headlesslabs.xyz/docs/server/logging.md): Configura la entrega de eventos de Headless, consulta el historial del servidor y revisa el diagnóstico de canales y webhooks.
- [Marca y prefijo](https://docs.headlesslabs.xyz/docs/server/branding.md): Brand configura el pie, emojis de respuesta y perfil visual del servidor que Headless usa en superficies compatibles. Los ajustes de servidor no cambian la identidad global del bot.
- [Aliases de comandos](https://docs.headlesslabs.xyz/docs/server/command-aliases.md): Los aliases crean atajos persistentes por servidor para invocar comandos registrados de Headless. No reemplazan los controles ni permisos del comando original.
- [Niveles](https://docs.headlesslabs.xyz/docs/server/levels.md): Configura el XP por mensajes y voz, las tarjetas de rango y las recompensas de nivel de Headless.
- [Conteo](https://docs.headlesslabs.xyz/docs/server/counting.md): Counting es un juego persistente por servidor y canal. La comunidad envía el siguiente entero; también se aceptan expresiones aritméticas simples validadas sin ejecutar código del usuario.
- [Starboard](https://docs.headlesslabs.xyz/docs/server/starboard.md): Destaca mensajes públicos con reacciones ⭐ y un umbral por servidor.
- [Bump Reminder](https://docs.headlesslabs.xyz/docs/server/bump-reminder.md): Programa recordatorios seguros después de bumps verificados de DISBOARD.
- [Sorteos](https://docs.headlesslabs.xyz/docs/server/giveaways.md): Giveaways crea sorteos con botones de participación, duración y uno o más ganadores. Los datos y roles de managers se guardan por servidor; el proceso de cierre continúa al reiniciar el bot.

### Tickets

- [Sistema de Tickets](https://docs.headlesslabs.xyz/docs/server/tickets.md): Cómo Headless mantiene el estado de Tickets por servidor y dónde encontrar la guía de cada parte del flujo.
- [Resumen de tickets](https://docs.headlesslabs.xyz/docs/server/tickets/overview.md): Configura el panel privado de soporte de Headless, conoce sus límites y prueba el flujo antes de anunciarlo.
- [Comandos y permisos de tickets](https://docs.headlesslabs.xyz/docs/server/tickets/commands.md): Referencia de los comandos prefix de Tickets, las autorizaciones de cada acción y los permisos que necesita el bot.
- [Paneles de tickets](https://docs.headlesslabs.xyz/docs/server/tickets/panels.md): Publica y actualiza el único panel Components V2 de apertura que admite cada servidor.
- [Opciones de tickets](https://docs.headlesslabs.xyz/docs/server/tickets/options.md): Valores iniciales, límites efectivos, controles del Dashboard y opciones de Tickets que Headless no implementa.
- [Formularios de tickets](https://docs.headlesslabs.xyz/docs/server/tickets/forms.md): El modal inicial de Tickets solicita un motivo obligatorio y permite adjuntar evidencia opcional antes de crear el canal privado.
- [Acceso a tickets](https://docs.headlesslabs.xyz/docs/server/tickets/access.md): Permisos del solicitante, Headless, roles de soporte y canal de logs, comprobados contra la creación real de canales privados.
- [Ciclo de vida de tickets](https://docs.headlesslabs.xyz/docs/server/tickets/lifecycle.md): Cómo Headless abre, reclama, transcribe y cierra un ticket y qué conserva cuando elimina el canal.
- [Mensajes de tickets](https://docs.headlesslabs.xyz/docs/server/tickets/messages.md): Personaliza el panel Components V2 y el mensaje del canal privado, con límites de texto, controles de mención y enlaces HTTPS.
- [Variables de tickets](https://docs.headlesslabs.xyz/docs/server/tickets/variables.md): Las variables de Tickets solo se resuelven en eventos y plantillas donde Headless realmente tiene contexto de ticket.

### Roles

- [Roles](https://docs.headlesslabs.xyz/docs/server/roles.md): Headless separa los roles asignados automáticamente, los paneles de selección voluntaria y los roles por reacción.
- [Roles automáticos](https://docs.headlesslabs.xyz/docs/server/roles/auto.md): Auto Role reúne la asignación automática al entrar, los roles previos a la verificación y los selectores voluntarios de roles. La configuración se guarda por servidor. Los comandos editan esa configuración; no se aplican a miembros que ya estaban en el servidor.
- [Roles autoasignables](https://docs.headlesslabs.xyz/docs/server/roles/self-assignable.md): Configura menús persistentes de selección de roles con grupos exclusivos o multiselección, límites, permisos y controles reales de Headless.
- [Roles por reacción](https://docs.headlesslabs.xyz/docs/server/roles/reaction-roles.md): Configura asignaciones seguras de roles mediante reacciones en mensajes de tu servidor.
- [Roles de booster](https://docs.headlesslabs.xyz/docs/server/roles/booster.md): Configura un rol cosmético por booster, su jerarquía, cambios, uso compartido con aceptación y anuncios reales de boost.

### Mensajes

- [Messages](https://docs.headlesslabs.xyz/docs/server/messages.md): Headless tiene tres flujos de mensajería con disparadores y controles diferentes: mensajes al entrar una persona, respuestas a texto y avisos persistentes que vuelven a publicarse después de actividad.
- [Bienvenidas](https://docs.headlesslabs.xyz/docs/server/welcome.md): Welcome publica un saludo cuando entra un miembro al servidor. Configura el canal, el formato y el contenido, revisa la vista previa y activa el módulo cuando el bot tenga los permisos necesarios.
- [Respuestas automáticas](https://docs.headlesslabs.xyz/docs/server/auto-responders.md): Auto Responder guarda reglas por servidor y responde al primer trigger habilitado que coincida con un mensaje. Puedes elegir coincidencia exacta o parcial, limitar la regla por canal y rol, y enviar texto o un embed script.
- [Mensajes persistentes](https://docs.headlesslabs.xyz/docs/server/sticky-messages.md): Sticky mantiene un aviso de canal destacado. Tras actividad de una persona, Headless espera el intervalo configurado y vuelve a publicar el aviso; no ejecuta mensajes con un horario de reloj.

## Comunidad

- [AFK](https://docs.headlesslabs.xyz/docs/community/afk.md): AFK permite que una persona publique su estado de ausencia y da contexto cuando otros la mencionan. El estado es persistente y por servidor.
- [Disparadores de reacciones](https://docs.headlesslabs.xyz/docs/community/reactions.md): Añade reacciones manualmente o configura disparadores por frase y por canal en tu servidor de Discord.
- [Social](https://docs.headlesslabs.xyz/docs/community/social.md): Social reúne comandos de interacción y consultas manuales de perfiles públicos de Instagram y Roblox. La lectura de Instagram requiere la integración oficial de Meta; no se publican alertas automáticas de actividad.
- [Analítica del servidor](https://docs.headlesslabs.xyz/docs/community/analytics.md): Server Analytics presenta métricas agregadas observadas por Headless para el servidor. Requiere Manage Server; no reconstruye actividad anterior a la recolección.
- [Citas](https://docs.headlesslabs.xyz/docs/community/quote.md): Quote crea una imagen estilizada a partir de una frase o un mensaje citado. Si el mensaje fuente incluye imagen, sticker o emoji personalizado compatible, el renderizador puede usar esos recursos como fondo o elementos visuales.
- [Snipes](https://docs.headlesslabs.xyz/docs/community/snipes.md): Snipes consulta eventos recientes de mensajes eliminados y reacciones guardados en una caché en memoria por servidor. El historial depende de la sesión y del tamaño de esa caché.
- [Emoji](https://docs.headlesslabs.xyz/docs/community/emoji.md): Headless ofrece dos funciones relacionadas con emojis: copiar emojis personalizados al servidor y configurar emojis de respuesta del bot. No son el mismo catálogo ni tienen los mismos permisos.
- [Historial de usuarios](https://docs.headlesslabs.xyz/docs/community/user-history.md): Headless registra un historial local de nombres y un historial global de avatares a partir de eventos que observa. No recupera cambios anteriores a la observación del bot.
- [Utilidades](https://docs.headlesslabs.xyz/docs/community/utilities.md): Las utilidades reúnen ayuda, latencia, encuestas y recordatorios. Los comandos de prefijo usan el prefijo actual del servidor.

## Headless VC

- [Headless VC](https://docs.headlesslabs.xyz/docs/voice.md): Headless VC crea salas temporales controladas por su propietario. Es distinto de Headless Music, que es un servicio de reproducción independiente con comandos slash.
- [Resumen](https://docs.headlesslabs.xyz/docs/voice/overview.md): Headless VC crea una sala temporal al entrar de verdad al lobby configurado, registra el canal para ese servidor y mueve allí a la persona. El propietario actual controla su sala activa; el valor inicial hace las salas visibles.
- [Comandos y controles](https://docs.headlesslabs.xyz/docs/voice/commands.md): Headless VC registra un grupo de prefijo con los alias `vcprivado` y `pc`; el prefijo predeterminado es `.` y puede cambiar por servidor. Las 22 entradas siguientes corresponden al grupo raíz y a sus subcomandos reales.
- [Permisos](https://docs.headlesslabs.xyz/docs/voice/permissions.md): Headless VC separa los permisos de quien configura el módulo, del propietario de cada sala y del propio bot. Los comandos de sala se limitan al servidor y comprueban el ownership actual.

## Headless Music

- [Headless Music](https://docs.headlesslabs.xyz/docs/voice/music.md): Guía del servicio de música independiente de Headless, con colas por servidor, controles slash y reproducción mediante Lavalink.
- [Instalación](https://docs.headlesslabs.xyz/docs/voice/music/installation.md): Invita el bot de música y concede únicamente los permisos de Discord que necesita para entrar y reproducir en canales de voz.
- [Inicio rápido](https://docs.headlesslabs.xyz/docs/voice/music/quick-start.md): Inicia una sesión de música y administra la cola del servidor con comandos slash registrados.
- [Reproducir música](https://docs.headlesslabs.xyz/docs/voice/music/playing-music.md): Usa `/play` con una búsqueda o enlace admitido; el bot resuelve la pista y la reproduce o la añade a la cola del servidor.
- [Administrar la cola](https://docs.headlesslabs.xyz/docs/voice/music/queue-management.md): Consulta y modifica las pistas pendientes sin alterar la sesión de otro servidor.
- [Controles del reproductor](https://docs.headlesslabs.xyz/docs/voice/music/player-controls.md): Controla una sesión activa con comandos slash; los botones del mensaje se pueden habilitar o deshabilitar por servidor.
- [Filtros de audio](https://docs.headlesslabs.xyz/docs/voice/music/audio-filters.md): Aplica o desactiva un filtro de audio registrado con `/filter` o los comandos directos disponibles.
- [Favoritos](https://docs.headlesslabs.xyz/docs/voice/music/favorites.md): Guarda pistas desde los controles interactivos del reproductor y limpia tu propia lista cuando sea necesario.
- [Volumen](https://docs.headlesslabs.xyz/docs/voice/music/volume.md): Ajusta el volumen del reproductor activo con un número entero entre 0 y 200.
- [Reproducción automática](https://docs.headlesslabs.xyz/docs/voice/music/autoplay.md): Activa o desactiva por servidor las recomendaciones automáticas cuando termina la cola.
- [Modo 24/7](https://docs.headlesslabs.xyz/docs/voice/music/247-mode.md): Mantén Headless Music conectado al canal de voz seleccionado cuando la cola termine.
- [Anuncios](https://docs.headlesslabs.xyz/docs/voice/music/announcements.md): Configura si se anuncian las pistas y qué canal de texto recibirá los mensajes.
- [Permisos](https://docs.headlesslabs.xyz/docs/voice/music/permissions.md): Revisa los permisos de Discord del bot y de los miembros antes de habilitar controles de música.
- [Arquitectura de audio](https://docs.headlesslabs.xyz/docs/voice/music/audio-architecture.md): Conoce qué partes de la sesión administra Headless Music y qué responsabilidades corresponden a Lavalink y a proveedores opcionales.
- [Solución de problemas](https://docs.headlesslabs.xyz/docs/voice/music/troubleshooting.md): Diagnostica por separado la sincronización de comandos, los permisos de voz, Lavalink y el proveedor de audio.
- [Seguridad e integración](https://docs.headlesslabs.xyz/docs/voice/music/security-integration.md): Headless Music se controla desde Discord y no es una extensión de reproducción remota del Dashboard de Headless.
- [Comandos slash](https://docs.headlesslabs.xyz/docs/voice/music/commands.md): Catálogo completo de 31 comandos slash registrados en Headless Music, con descripción, sintaxis y permisos.
- [Parámetros de los comandos](https://docs.headlesslabs.xyz/docs/voice/music/parameters.md): Parámetros, obligatoriedad, elecciones, límites y valores por defecto del catálogo de comandos registrado.
- [Ejemplos](https://docs.headlesslabs.xyz/docs/voice/music/examples.md): Ejemplos reproducibles derivados directamente de los metadatos de comandos registrados.

## Integraciones

- [Integraciones](https://docs.headlesslabs.xyz/docs/integrations.md): Headless ofrece consultas públicas y conexiones de cuenta con permisos explícitos. Tener una página de integración no implica alertas automáticas ni lectura de datos privados.
- [YouTube](https://docs.headlesslabs.xyz/docs/integrations/youtube.md): YouTube permite buscar videos públicos, consultar un video por ID/URL, leer canales y listar hasta cinco publicaciones recientes. No requiere conectar una cuenta personal.
- [TikTok](https://docs.headlesslabs.xyz/docs/integrations/tiktok.md): TikTok consulta solamente la cuenta que la misma persona vinculó mediante Headless Dashboard y los scopes que autorizó. La integración usa TikTok Login Kit y Display API en modo de lectura.
- [Pinterest](https://docs.headlesslabs.xyz/docs/integrations/pinterest.md): Pinterest ofrece consultas de solo lectura para la cuenta que el usuario vinculó a Headless. Requiere OAuth configurado y los scopes `boards:read`, `pins:read` y `user_accounts:read`.
- [Roblox Avatar](https://docs.headlesslabs.xyz/docs/integrations/roblox-avatar.md): Roblox Avatar busca un usuario público de Roblox y devuelve su avatar, nombre visible, ID y enlace al perfil. No necesita vincular una cuenta ni guarda datos de servidor.

## Recursos

- [Sintaxis](https://docs.headlesslabs.xyz/docs/resources/syntax.md): Esta página resume la sintaxis real de Headless. Los ejemplos usan el prefijo predeterminado `.`; los comandos slash aparecen en el selector de Discord cuando están registrados.
- [Permisos y acceso](https://docs.headlesslabs.xyz/docs/permissions.md): Los permisos de Headless se comprueban por comando y por acción. Tener permiso para configurar una función no otorga permisos al bot ni cambia las sobrescrituras de Discord.
- [Dashboard](https://docs.headlesslabs.xyz/docs/dashboard.md): La Dashboard de Headless es una superficie web autenticada para las opciones que cada módulo expone. La configuración sigue asociada al servidor seleccionado; no todos los comandos tienen equivalente en la web.

### Scripts de mensajes

- [Message scripting](https://docs.headlesslabs.xyz/docs/resources/scripting.md): Headless usa plantillas de texto y un parser de embeds de datos. No evalúa código arbitrario ni admite etiquetas de paginación en mensajes personalizados.
- [Embeds](https://docs.headlesslabs.xyz/docs/resources/scripting/embeds.md): Las plantillas de embed de Headless convierten bloques de texto con una gramática limitada en contenido de Discord. El parser nunca ejecuta código del usuario.
- [Variables](https://docs.headlesslabs.xyz/docs/resources/scripting/variables.md): Las variables reemplazan tokens de llaves con datos que el evento actual proporciona. El parser no consulta otras cuentas ni ejecuta expresiones arbitrarias.
- [Paginación](https://docs.headlesslabs.xyz/docs/resources/scripting/pagination.md): El scripting de mensajes de Headless no admite etiquetas de plantilla de paginación para convertir un mensaje en páginas navegables. Algunas respuestas independientes del bot sí usan vistas paginadas; eso no agrega paginación a plantillas personalizadas.
- [Plantillas de tickets](https://docs.headlesslabs.xyz/docs/resources/scripting/tickets.md): Los textos de Tickets pueden usar las plantillas y variables de Headless dentro del contexto real del ticket. No hay que asumir que una plantilla puede ejecutar lógica arbitraria.

## Problemas comunes

- [Preguntas frecuentes](https://docs.headlesslabs.xyz/docs/common-issues.md): Esta guía combina respuestas prácticas con diferencias de Headless. No presume que los motivos o soluciones de otro bot apliquen aquí.

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English (88 pages)](https://docs.headlesslabs.xyz/docs/_llms/en.txt): Documentation for English.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.