Qué detecta y qué excluye
Headless admite actualmente un solo canal Honeypot por servidor. El setup publica su panel y habilita disparadores por mensaje; las reacciones empiezan desactivadas y se pueden activar desde Dashboard. Se ignoran bots, miembros conAdministrator o Manage Server y los roles exentos configurados. Una misma persona no puede volver a activar otra respuesta durante la ventana anti-repetición de 45 segundos. La clave interna sigue llamándose honeyspot; el comando público canónico es .honeypot.
Setup, activación y permisos
Invocar.honeypot solo consulta el estado: no crea canales ni activa la aplicación de sanciones. .honeypot setup [acción] crea o reutiliza el canal configurado, aplica los permisos de @everyone, publica el panel y habilita la detección. El bot necesita Manage Channels y Manage Roles; si Discord rechaza los permisos del canal, el setup falla en vez de informar que quedó activo. La configuración se guarda cuando el panel se publica correctamente. En una configuración nueva, omitir acción selecciona un timeout de siete días. Si el servidor ya tenía una acción guardada, setup sin argumento la conserva. Las configuraciones antiguas con una acción guardada pero sin duración mantienen el fallback anterior de 60 minutos; una duración guardada explícitamente también se conserva. Al crear un canal nuevo, Headless concede a @everyone View Channel, Send Messages y Read Message History. Al reutilizar uno existente, ajusta solo View Channel y Send Messages, sin sustituir los demás overwrites; el historial, las reacciones, los adjuntos y los enlaces dependen de los permisos existentes del canal o categoría. Usa un canal dedicado e informa al equipo que interactuar allí puede activar la respuesta. .honeypot add #canal <acción> configura un canal de texto existente sin cambiar sus overwrites; el bot debe poder verlo, leer su historial y publicar el panel.
Antes de cambiar un overwrite de
@everyone, Headless guarda su estado allow/deny/inherit en la configuración del servidor. .honeypot remove lo restaura sin borrar el canal ni sus mensajes. .honeypot add no modifica overwrites. Las configuraciones anteriores a este snapshot no contienen el permiso original; Headless desactiva la trampa y conserva la referencia para que un administrador revise manualmente el canal.Respuesta y notificación
Las acciones aceptadas sonlog, timeout, kick y ban; cualquier otra acción se rechaza. El timeout se puede configurar entre 1 minuto y 28 días. log registra sin sancionar. En disparadores por mensaje, delete_trigger está activado por defecto: después de procesar correctamente la respuesta, Headless intenta borrar el mensaje; si el procesamiento falla, lo conserva. El borrado es independiente de la sanción y un fallo al borrar no la revierte. Los disparadores por reacción nunca borran el mensaje fuente. Para timeout, kick o ban Headless necesita el permiso nativo correspondiente y una jerarquía que permita actuar sobre el miembro. También intenta enviar un DM de seguridad y registra el resultado; un fallo de DM no impide la respuesta.
Añadir, consultar y quitar la trampa
La configuración actual admite un canal. Si ya hay uno configurado, añadir otro se rechaza; primero quita el anterior.remove desactiva la aplicación de sanciones, restaura los overwrites guardados y elimina la referencia; no borra el canal de Discord, el panel ni el historial. Si Discord no permite restaurar un overwrite, Headless conserva la configuración desactivada y el snapshot para reintentar.
Administrator nativo o el permiso virtual equivalente de Headless. setup y channel necesitan que el bot tenga Manage Roles para configurar los overwrites; setup también necesita Manage Channels para crear un canal si no existe. Para add, Headless comprueba que pueda ver el canal, leer el historial y enviar el panel, además del permiso nativo requerido por la acción. La jerarquía se valida al actuar sobre cada miembro.
Limpieza opcional del historial
Está apagada inicialmente..honeyspot cleanup on [límite] (aliases clean, limpieza, cl) activa la limpieza en futuras activaciones; off la apaga. Omitir el límite usa 250; debe estar entre 25 y 1000 y los valores fuera de rango se rechazan sin cambiar la configuración. La limpieza solo se ejecuta después de una acción punitiva exitosa (timeout, kick o ban), nunca en modo log. Cada activación borra como máximo min(límite, 500) mensajes en total y solo contenido de menos de 14 días. Recorre canales de texto e hilos accesibles; Headless necesita View Channel, Read Message History y Manage Messages en cada canal. La configuración no inicia una limpieza inmediata.
Panel y configuración
.honeyspot test publica una vista previa del panel, en el canal configurado o en el actual si falta uno; no prueba el disparador ni aplica sanciones. status muestra permisos y jerarquía. Dashboard permite ajustar mensajes, exclusiones y los elementos visuales del panel (título, pie, thumbnail e imagen/banner); las imágenes remotas deben usar HTTPS y el acento del panel permanece amarillo. message cambia el texto del panel y panel lo vuelve a publicar o actualizar.
Pasos
1
Elige un canal dedicado
Informa al personal de que publicar —y, si se habilita, reaccionar— puede activar una acción automática. No uses un canal cotidiano sin revisar sus permisos.
2
Empieza en modo registro
Ejecuta
.honeypot setup log; activa el módulo sin sancionar. En una configuración nueva, setup sin acción selecciona timeout de siete días.3
Revisa la configuración
Comprueba
.honeypot list, .honeypot status, los permisos del canal, las exclusiones y los permisos del bot. .honeypot test solo muestra el panel; prueba el disparador únicamente con una cuenta de prueba no exenta y una política aprobada.4
Activa una sanción después de revisarla
Si la política del servidor lo permite, ejecuta
.honeypot off, elige la acción y duración, confirma los permisos y la jerarquía y luego ejecuta .honeypot on. Mantén apagada la limpieza de historial salvo que también se haya aprobado su alcance.Comandos y diagnóstico
Comandos principales
Comandos principales
El comando canónico es
.honeypot; .honeyspot y .honey siguen funcionando como alias. El prefijo se puede cambiar por servidor, así que sustituye . en estos ejemplos si fue modificado. El grupo incluye add, list y remove, además de los comandos existentes setup, spot, on, off, action, channel, timeout, cleanup, status, panel, message y test. El alias .honeyspot acepta las mismas operaciones, por ejemplo .honeyspot setup log y .honeyspot action log; .honeyspot test solo muestra el panel. No hay comandos slash de Honeyspot.¿Qué permiso necesita quien configura?
¿Qué permiso necesita quien configura?
Los subcomandos son solo para servidor y requieren
Administrator nativo o el permiso virtual equivalente de Headless. El bot necesita Manage Channels para crear el canal del setup y Manage Roles para configurar overwrites con setup o channel; también debe poder publicar el panel. add comprueba acceso del bot para ver el canal, leer el historial y enviar mensajes; timeout, kick y ban requieren el permiso nativo correspondiente. El rol de Headless debe estar por encima del miembro sancionado. Fake Permissions no concede permisos de Discord al bot.El comando test no activa la trampa
El comando test no activa la trampa
Es el comportamiento esperado.
test publica o previsualiza el panel sin ejecutar un evento de mensaje/reacción. Usa status para comprobar estado y permisos; el disparador solo se prueba con una cuenta no exenta que interactúe con el canal configurado.La limpieza no borró todo el historial
La limpieza no borró todo el historial
La limpieza está acotada por el límite de mensajes por canal y el tope global de hasta 500 eliminaciones por activación. Omite contenido antiguo, canales inaccesibles y eliminaciones rechazadas por Discord; el resultado puede ser parcial y aparece en Logs.
.honeypot setup
.honeyspot sigue disponible.
.honeyspot action
.honeyspot action timeout
.honeyspot off
.honeyspot timeout
.honeyspot on
Captura histórica de una respuesta anterior en español; la versión actual de Headless responde en inglés. Se ocultaron el usuario y el canal.
.honeyspot status
.honey status
.honeyspot test
.honeyspot channel
.honeyspot message
.honeyspot panel
.honeyspot cleanup
.honeyspot cleanup off
Nota:
Los ajustes de Honeyspot se guardan por servidor. La vista previa test solo publica el panel y no comprueba que el disparador o una sanción funcionen.