Documentación

Qué necesitas antes de empezar #

Debes ser el propietario del servidor de Discord o tener el permiso de Administrador en él. Krios valida esto contra la API de Discord en cada sesión del dashboard, por lo que miembros de rango inferior no pueden suplantar el acceso. También necesitas una cuenta de Discord en buen estado para completar el inicio de sesión OAuth; no se crea ninguna cuenta ni contraseña separada de Krios, y siempre puedes revocar el acceso desde la configuración de Aplicaciones Autorizadas de Discord.

Si tu comunidad usa la función de Comunidad de Discord con verificación de membresía o canales de reglas, Krios es totalmente compatible — el módulo de bienvenida se dispara después de que un miembro pasa la verificación, no antes, por lo que las tarjetas de bienvenida solo se envían a miembros que realmente completan el onboarding.

Checklist recomendado para el primer día #

Cuando el asistente termine, dedica cinco minutos extra a endurecer tu servidor: confirma que el rol de Krios está por encima de tus roles de moderador, activa el módulo Anti-Nuke desde el dashboard y revisa sus umbrales por defecto, publica un panel de tickets en tu canal de soporte con /ticket-panel y emite un /warn de prueba contra una cuenta alternativa o un moderador voluntario para verificar que el canal de logs recibe el evento. Los servidores que completan este checklist el primer día reportan muchísimos menos problemas de configuración después, porque cada subsistema se ha probado de extremo a extremo mientras la configuración aún está fresca.

Cómo funciona la detección #

Krios vigila continuamente el registro de auditoría de tu servidor y correlaciona cada acción destructiva — baneos, expulsiones, borrados de canales, borrados de roles y creaciones de webhooks — con la cuenta que la ejecutó. Cada ejecutor tiene un contador de acciones por categoría que se evalúa dentro de una ventana de tiempo configurable. Cuando cualquier contador supera su umbral dentro de esa ventana, el motor clasifica el comportamiento como un intento de nuke y dispara la respuesta configurada al instante, sin esperar confirmación humana.

Este diseño de umbrales por ventana es lo que separa la administración legítima de un ataque. Un moderador que borra un canal obsoleto nunca activa el sistema; un script que borra quince canales en diez segundos, sí. Cada umbral es configurable de forma independiente — máximo de baneos, máximo de expulsiones, máximo de borrados de canales, máximo de borrados de roles y máximo de creaciones de webhooks — para que puedas ajustar la sensibilidad a la forma real de trabajar de tu staff.

Protección contra baneos masivos #

Los ataques de baneo masivo son el vector de nuke más común porque una sola cuenta de moderador comprometida puede banear a cientos de miembros a través de la API en menos de un minuto. Krios rastrea la velocidad de baneos por ejecutor: cuando una cuenta supera el umbral de baneos configurado dentro de la ventana de detección, el motor le quita inmediatamente la capacidad de continuar — aplicando el castigo configurado (retirar sus roles, expulsar o banear al atacante, según tu configuración) — y registra un historial forense completo de lo ocurrido, incluyendo el ejecutor, los objetivos y las marcas de tiempo exactas.

Como la detección se basa en la velocidad y no en los permisos, esta protección funciona incluso cuando el atacante es un moderador de confianza cuya cuenta fue víctima de phishing. El historial de la cuenta no importa; su comportamiento en los últimos segundos, sí.

Protección contra borrado masivo de canales y roles #

La destrucción de canales y roles es el segundo pilar de un nuke: borrar todos los canales elimina conocimiento fijado, webhooks y estructuras de permisos que pueden tardar días en reconstruirse. Krios aplica los mismos contadores por ventana a los borrados de canales y de roles de forma independiente, de modo que un atacante no puede pasar desapercibido alternando entre ambos. Cuando cualquiera de los umbrales se activa, el motor detiene al ejecutor y lanza una alerta de alta prioridad en tu canal de logs de seguridad para que tu equipo sepa exactamente qué estructuras se perdieron antes de la intervención.

La creación de webhooks se monitoriza como categoría propia porque los atacantes frecuentemente crean webhooks en masa para spamear @everyone con enlaces maliciosos tras una toma de control. Superar el umbral de webhooks recibe el mismo tratamiento que cualquier otra señal de nuke.

Protección contra admins maliciosos #

La mayoría de los bots de seguridad eximen silenciosamente a los administradores, lo que los vuelve inútiles frente al modelo de amenaza real — los admins son precisamente las cuentas con el poder de hacer un nuke. Krios adopta la postura contraria: con el módulo Anti-Nuke activado, los administradores están sujetos a los mismos umbrales de comportamiento que todos los demás. El único límite duro es la propia jerarquía de Discord — Krios solo puede actuar sobre cuentas cuyo rol más alto esté por debajo del rol de Krios, y por eso colocar el rol del bot en la cima de tu jerarquía durante la configuración es innegociable para una cobertura completa.

Para que esta protección sea significativa, trata tu jerarquía de roles como un perímetro de seguridad: mantén el conjunto de roles por encima de Krios lo más pequeño posible (idealmente solo el propietario del servidor) y audítalo cada vez que cambie el staff. El propietario del servidor nunca puede ser objeto de la acción de ningún bot — es una garantía de la plataforma Discord — así que la cuenta del propietario debe protegerse con 2FA y usarse con moderación.

Configuración de umbrales y respuestas #

Toda la configuración anti-nuke vive en el dashboard, dentro de la configuración de módulos de tu servidor. Tú eliges el intervalo de detección, los máximos por categoría y el castigo que se aplica al atacante detectado. Umbrales más estrictos (máximos más bajos, ventanas más largas) detectan los ataques antes a costa de cuestionar ocasionalmente trabajos de limpieza legítimos inusualmente rápidos; umbrales más laxos dan más margen al staff pero permiten que un atacante haga más daño antes de activar la alarma. Un punto de partida práctico para la mayoría de comunidades es la configuración por defecto, ajustada tras una semana observando los patrones normales de actividad de tu staff en el log de seguridad.

Cuando el módulo interviene, cada acción se escribe en el sistema de registro de auditoría con metadatos completos. Puedes exportar esta evidencia en cualquier momento con /audit-export en formato JSON o CSV, algo invaluable para la revisión post-incidente, para apelaciones y para decidir si un umbral activado fue un ataque o un falso positivo que merece ajuste.

Anti-Spam #

El sistema anti-spam monitoriza la velocidad y repetición de mensajes por usuario y por canal. Cuando un miembro supera las heurísticas de spam — mensajes idénticos en ráfaga, menciones masivas o inundaciones sostenidas de mensajes — Krios elimina los mensajes infractores y aplica una respuesta graduada, comenzando con un silencio mediante el rol de mute creado durante /setup. Como las anulaciones de canal del rol de mute fueron aprovisionadas por el asistente, un spammer silenciado queda mudo en todas partes a la vez, incluidos hilos y canales de texto de voz, sin necesidad de configuración por canal.

El anti-spam funciona completamente por comportamiento, así que atrapa tanto a spammers humanos como a scripts de self-bots. Cada eliminación se registra con el contenido del mensaje original preservado en el embed del log, permitiendo a los moderadores revisar exactamente qué se borró y revertir la acción si ocurre un falso positivo.

Anti-Link #

El módulo anti-link bloquea enlaces no autorizados para prevenir phishing, sorteos fraudulentos y spam de publicidad de servidores — los tres payloads más comunes que llegan a las comunidades de Discord. Cuando se activa desde el dashboard, Krios elimina los mensajes con enlaces de los miembros que no tienen un rol exento y notifica brevemente en el canal para que el miembro entienda por qué desapareció su mensaje. Los enlaces de invitación de Discord reciben un escrutinio especial, ya que son el vector principal de reclutamiento para raids y de captación por parte de la competencia.

Los moderadores y administradores están exentos por defecto, y el módulo está diseñado para activarse y desactivarse al instante: muchas comunidades lo mantienen activado permanentemente en los canales generales mientras dejan libres los canales dedicados a multimedia o promoción, usando la configuración de integraciones por comando y por canal de Discord para un control fino.

Advertencias y umbrales de escalado #

El comando /warn emite una advertencia formal a un miembro con una razón obligatoria, almacenada permanentemente en la base de datos y visible para todo tu equipo de staff. Las advertencias son el tejido conectivo de una moderación justa: en lugar de que cada moderador actúe con conocimiento parcial, cada advertencia queda registrada centralmente con el moderador emisor, la razón y la marca de tiempo, de modo que las decisiones de escalado se basan en el historial completo del miembro y no en la memoria de un solo moderador.

El escalado es automático y basado en umbrales: a medida que un miembro acumula advertencias, Krios aplica consecuencias progresivamente más fuertes — un timeout en el primer umbral, una expulsión en el siguiente y un baneo en el último. Esto elimina la incomodidad de que el staff tenga que decidir personalmente cuándo 'ya es suficiente' y garantiza un trato idéntico ante comportamientos idénticos. Los miembros reciben una notificación por DM cuando son advertidos, incluyendo la razón, lo que reduce de forma consistente las reincidencias.

Anti-Raid #

Los raids — oleadas coordinadas de cuentas que se unen simultáneamente para spamear, acosar o explorar oportunidades de nuke — se detectan monitorizando la velocidad de entradas y las características de las cuentas. Cuando una oleada de entradas coincide con patrones de raid (muchas cuentas uniéndose en segundos, cuentas recién creadas, avatares por defecto), Krios puede bloquear automáticamente la entrada eliminando las cuentas sospechosas antes de que lleguen a publicar. El módulo es Premium porque requiere un análisis sostenido y en tiempo real del flujo de miembros, y se complementa de forma natural con Anti-Nuke: los raids son frecuentemente la fase de reconocimiento de un intento de nuke posterior.

Todas las intervenciones de raid aparecen en el log de seguridad con la lista completa de cuentas afectadas, de modo que los usuarios legítimos atrapados en una oleada (sucede — un streamer popular mencionando tu servidor se parece mucho a un raid) pueden ser identificados y reinvitados rápidamente.

El sistema de registro de auditoría #

Cada acción automatizada y manual que Krios realiza — advertencias, silencios, eliminaciones, intervenciones anti-nuke, eventos de tickets — fluye hacia un registro de auditoría unificado almacenado en la base de datos, independiente de la retención de 45 días del registro de auditoría propio de Discord. El comando /audit-export exporta este historial como archivo adjunto JSON o CSV, filtrable por categoría y limitado a la cantidad que elijas, dándote evidencia duradera y offline para disputas, informes de transparencia o revisiones de staff. Trata la exportación como la caja negra de tu servidor: cuando ocurre algo controvertido, la respuesta a 'quién hizo qué y cuándo' siempre está a un comando de distancia.

Publicar un panel de tickets #

Ejecuta /ticket-panel en el canal donde quieres que aparezca el panel — normalmente un canal dedicado de #soporte o #abre-un-ticket que los miembros pueden leer pero no escribir. El comando acepta opciones que definen el panel por completo: un título mostrado en la parte superior del embed, una descripción que explica para qué sirve el ticket y qué información deben preparar los miembros, el rol de staff al que se concederá acceso a cada ticket abierto desde este panel, la categoría bajo la cual se crean los canales de tickets y un color de acento para que combine con la imagen de tu servidor.

Una vez publicado, el panel es persistente: sobrevive a los reinicios del bot y no requiere mantenimiento. Los miembros hacen clic en el botón y Krios crea al instante un canal privado visible solo para el miembro, el rol de staff configurado y el propio bot. Si tus paneles alguna vez quedan en un estado roto — por ejemplo tras borrados de canales fuera del bot — el comando /reset-panels los reconstruye limpiamente.

Organización con categorías #

Cada panel se vincula a una categoría de Discord, y cada ticket abierto desde ese panel se crea dentro de ella. Esta es la clave para escalar el soporte: crea un panel por cada tipo de consulta — ayuda general, reportes de miembros, solicitudes de partnership, preguntas de facturación — cada uno apuntando a su propia categoría y, si quieres, a su propio rol de staff. Tu equipo de moderación ve los tickets de reportes, tu equipo de administración ve los tickets de partnership, y nadie tiene que vadear canales que no le conciernen. El asistente /setup aprovisiona una categoría de tickets por defecto, pero eres libre de crear otras adicionales y referenciarlas al publicar paneles especializados.

Los canales de tickets se nombran de forma predecible según el miembro que los abre, de modo que el staff puede ver de un vistazo a quién pertenece un ticket. Cuando un ticket se resuelve, cerrarlo elimina el canal — manteniendo tu categoría limpia — mientras el registro de la conversación pervive en el transcript.

Transcripts y trazabilidad #

La rendición de cuentas es lo que diferencia un sistema de tickets de un simple canal privado. En los servidores Premium, cada ticket cerrado genera un transcript HTML completo: un archivo autocontenido y con estilo que reproduce toda la conversación — mensajes, embeds, marcas de tiempo y participantes — y que puede archivarse, compartirse con el miembro afectado o revisarse durante auditorías de staff. Los transcripts convierten 'un moderador fue grosero conmigo en un ticket' en una afirmación verificable en lugar de una disputa de palabra contra palabra, protegiendo tanto a los miembros como al staff.

Los eventos del ciclo de vida del ticket — abierto, reclamado, cerrado, por quién y cuándo — también se escriben en el registro de auditoría unificado, de modo que la actividad de tickets aparece en /audit-export junto a las acciones de moderación. Para comunidades con SLAs formales de soporte, esta es la fuente de datos para medir tiempos de respuesta y volumen de tickets.

Buenas prácticas para equipos de soporte #

Mantén la descripción del panel específica: indica a los miembros qué deben incluir (su ID de pedido, el usuario que reportan, capturas de pantalla) para que el staff no gaste los tres primeros mensajes extrayendo lo básico. Restringe el propio comando /ticket-panel a administradores mediante la configuración de integraciones de Discord, concediendo al rol de staff del día a día solo la capacidad de participar en los tickets. Y establece una disciplina de cierre — los tickets que permanecen abiertos indefinidamente saturan la categoría y entierran las conversaciones realmente activas; cierra los tickets resueltos con prontitud y apóyate en los transcripts cuando necesites el historial.