Permisos y límite
Quien ejecuta el comando necesitaManage Messages; Headless también necesita Manage Messages. Configura el máximo en Dashboard → Moderation → Max purge; el valor predeterminado del runtime es 500. Las solicitudes por encima del máximo se rechazan.
Filtros de prefijo
Puedes borrar todo, mensajes de un miembro o filtrar porbots, links, images, invites, embeds, mentions o contains <texto>. Si omites la cantidad en una búsqueda por miembro, el prefijo revisa los mensajes eliminables de ese usuario en el canal; otros usos usan el límite configurado.
.purge — 1
.purge @miembro 20 · .purge links 50
.purge — 2
.purge mentions 25
.purge [args...]
.purge @miembro 20 · .purge links 50 · .purge contains invitación 30 · .purge mentions 25
Slash
/purge admite cantidad opcional, miembro opcional y filtros all, bots, links, invites, images y embeds. No incluye los filtros textuales ni mentions del comando de prefijo.
/purge
/purge
.purge — 2
Pasos
1
Escoge canal y filtro
Comprueba el canal actual; el comando de prefijo no acepta selector de canal.
2
Establece un límite explícito
Usa una cantidad menor para búsquedas filtradas y verifica el máximo del servidor.
3
Revisa el resultado
Los mensajes inaccesibles o sujetos a límites de Discord pueden quedar sin borrar.
Límites del borrado
Mensajes antiguos y fijados
Mensajes antiguos y fijados
Headless omite mensajes fijados y mensajes con más de 14 días. Discord no permite borrarlos en bloque; revisa el conteo de omitidos en el resultado.
Ventana de búsqueda para filtros
Ventana de búsqueda para filtros
Un filtro prefix con cantidad busca en una ventana de mensajes recientes, hasta 1.500. La excepción es
.purge @miembro sin cantidad: recorre los mensajes eliminables de ese miembro hasta encontrar mensajes de más de 14 días. Si un filtro con cantidad no encuentra suficientes coincidencias en su ventana, revisa el canal antes de volver a ejecutar una búsqueda menor.Caso y registro
Caso y registro
Una operación prefix terminada genera un caso y programa el evento de Logs. Slash registra el evento de Logs, pero no crea el caso que crea la ruta prefix. Un fallo de acceso o de la API puede dejar mensajes sin borrar; el resumen no garantiza que se borraran todos los mensajes coincidentes.