# NearSecurity — Documentación completa Versión documentada: 3.1.0. Generado desde el inventario real de 60 comandos raíz. Sitio: https://nearsecurity.citymoon.org Documentación: https://nearsecurity.citymoon.org/docs/empezar/introduccion Índice Markdown por página: https://nearsecurity.citymoon.org/docs/index.md Cada página de documentación tiene una versión Markdown individual agregando `.md` a su URL. # Empezar Qué es NearSecurity y cómo dejarlo configurado. ## [Introducción a NearSecurity](https://nearsecurity.citymoon.org/docs/empezar/introduccion) Qué es NearSecurity, qué módulos incluye y cómo está organizada la documentación. NearSecurity es un bot gratuito de moderación y seguridad para servidores de Discord. Combina protecciones automáticas contra ataques, herramientas de moderación, registros de auditoría, sistemas de comunidad y un dashboard web para configurar el servidor sin depender de comandos. ### Qué incluye - **Anti-raid:** Anti-Ban, Anti-Kick, Anti-Canales, Anti-Roles, Anti-Webhooks y Anti-Bots. - **Automoderación:** filtros de enlaces, NSFW, palabras ofensivas, spam, ghost pings y cuentas infectadas. - **Moderación:** bans, kicks, timeouts, roles temporales, purgas, notas e historial de sanciones. - **Auditoría:** logs de eventos del servidor, canal de moderación y alertas por MD al propietario. - **Comunidad:** bienvenidas, niveles, sorteos, tickets, sugerencias, recordatorios y seguimientos. - **Recuperación:** backups de la estructura del servidor y `/unnuke` para revertir ataques. ### Cómo está organizada la documentación - **[Guías](https://nearsecurity.citymoon.org/docs/empezar/primeros-pasos.md):** Flujos de configuración y explicaciones de cada módulo. - **[Seguridad](https://nearsecurity.citymoon.org/docs/seguridad/protecciones.md):** Protecciones anti-raid, filtros y respuesta ante incidentes. - **[Referencia de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos.md):** Todos los comandos, opciones y permisos disponibles. - **[Dashboard](https://nearsecurity.citymoon.org/docs/empezar/dashboard.md):** Qué se configura desde la web y cómo se guardan los cambios. > **Sobre esta documentación** > Las guías describen el comportamiento de NearSecurity 3.0.0. Los comandos y las opciones pueden cambiar con nuevas versiones; la referencia se genera a partir del inventario real del bot. ## [Primeros pasos](https://nearsecurity.citymoon.org/docs/empezar/primeros-pasos) Invitá el bot, configurá lo esencial y dejá el servidor protegido en pocos minutos. Antes de activar protecciones automáticas conviene preparar los canales de auditoría y revisar los permisos. Este orden evita sanciones sin registro y facilita la revisión de incidentes. ### Requisitos - Una cuenta de Discord con permiso para gestionar el servidor. - El bot invitado con los permisos que se describen más abajo. - Un canal privado para logs y otro para moderación, visibles solo para el staff. ### Paso a paso 1. Iniciá sesión en el dashboard con Discord y seleccioná el servidor. Si el bot todavía no está, usá el botón **Invitar bot**. 2. Ejecutá `/empezar` para abrir el menú de bienvenida y conocer los módulos disponibles. 3. Configurá el canal de logs en **Logs** o con `/setup logs estado:activar canal:#logs`. 4. Definí el canal de moderación en **Moderación → Canal de Moderadores (Modlog)**. 5. Revisá las listas blancas en **Avanzado** antes de activar sanciones automáticas. 6. Activá las protecciones en **Seguridad** o ejecutá `/autoconfig` si preferís una base recomendada. 7. Probá una acción de moderación en un canal de prueba y verificá que el registro llegue al canal correcto. ### Permisos recomendados | Permiso | Para qué se usa | | --- | --- | | Ver canales | Leer mensajes y detectar infracciones. | | Enviar mensajes e insertar enlaces | Responder, publicar paneles y enviar embeds. | | Gestionar mensajes | Eliminar mensajes, purgar y aplicar filtros. | | Gestionar canales | Modo Pánico, Anti-Canales y restauración de estructura. | | Gestionar roles | Roles temporales, autoroles y Anti-Roles. | | Expulsar miembros y banear miembros | Sanciones y protecciones anti-raid. | | Moderar miembros | Timeouts y sanciones temporales. | | Ver registro de auditoría | Identificar al ejecutor de acciones masivas. | | Gestionar webhooks | Anti-Webhooks y recuperación. | | Leer historial de mensajes | Transcripciones de tickets y contexto de moderación. | | Adjuntar archivos | Transcripciones y paneles con imágenes. | > **Sobre el permiso Administrador** > Algunas funciones, como `/backup`, `/setup` y `/channel nuke`, requieren `Administrador`. Si no querés otorgarlo, podés usar el resto del bot con permisos granulares, pero esas funciones no estarán disponibles. ### Checklist inicial - Canal de logs y canal de moderación separados del chat público. - Lista blanca revisada: solo personas y roles de confianza. - Anti-Ban, Anti-Kick, Anti-Canales y Anti-Roles activados. - Anti-ClientApp y detección de Ghost Ping activados. - Backup manual creado antes de otorgar permisos nuevos. - Equipo de moderación informado sobre los comandos y el flujo de sanciones. > **Bienvenidas** > El sistema de bienvenida se configura únicamente desde el dashboard. El comando `/setup welcome` solo muestra el enlace al panel. ## [El dashboard](https://nearsecurity.citymoon.org/docs/empezar/dashboard) Cómo funciona el panel web, qué se configura en cada pestaña y cómo se guardan los cambios. El dashboard permite configurar el bot desde el navegador. Se accede con Discord y muestra los servidores donde tenés permisos de administración. Cada servidor tiene su propia configuración y sus propios canales. ![Dashboard de NearSecurity con la lista de servidores](https://nearsecurity.citymoon.org/docs/dashboard-overview.webp) *El dashboard muestra los servidores donde tenés permisos de administración.* ### Acceso y guardado - Iniciá sesión en **Dashboard** y elegí un servidor con el bot instalado. - Los cambios se mantienen en pantalla hasta que los guardes. El aviso **Tenés cambios sin guardar** indica que hay diferencias pendientes. - El autoguardado está desactivado por defecto. Activalo con el interruptor **Autoguardado** para guardar automáticamente después de cada cambio. - El botón **Descartar** vuelve a la última configuración guardada. **Guardar cambios** aplica la configuración actual. ![Configuración de seguridad de un servidor](https://nearsecurity.citymoon.org/docs/guild-security.webp) *Cada servidor tiene sus propias pestañas de configuración.* ### Pestañas | Pestaña | Qué se configura | | --- | --- | | Seguridad | Anti-Canales, Anti-Ban, Anti-Kick, Anti-Roles, filtro de bots, webhooks, Anti-ClientApp, ghost pings y detección de spam. | | Bienvenida | Activación, canal, tipo de mensaje (texto o embed), contenido, color e imagen. | | Logs | Canal de auditoría, eventos individuales y alertas por MD al propietario. | | Moderación | Canal de modlog, filtro NSFW, filtro de enlaces con sus opciones y lista de malas palabras. | | Comunidad | Sistema de sugerencias, canal de sugerencias, niveles, XP y canal de subida de nivel. | | Paneles | Paneles de tickets y roles por botones publicados en Discord. | | Avanzado | Dominios permitidos, roles inmunes y usuarios inmunes. | ### Paneles y autoroles La pestaña Paneles permite editar el embed del sistema de tickets y crear paneles de roles por botones. Al guardar, el bot publica o actualiza el mensaje en el canal elegido. ![Editor del panel de tickets](https://nearsecurity.citymoon.org/docs/guild-panels.webp) *El editor del panel de tickets con el embed y el canal de publicación.* ### Buenas prácticas - Usá canales privados para logs y moderación. Nunca los expongas al público. - No agregues `@everyone` ni roles administrativos a las listas blancas. - Activá el autoguardado solo después de revisar la configuración; para cambios delicados, guardá manualmente. - Después de un cambio grande, ejecutá `/estado` para verificar el resultado. - Si un ajuste no se refleja en Discord, revisá que el bot tenga permisos en el canal correspondiente. > **Modo Pánico** > El dashboard muestra el estado y la fecha de expiración del Modo Pánico, pero no lo activa ni lo desactiva. Esas acciones se hacen desde Discord con `/panic`. # Seguridad Protecciones anti-raid, filtros y respuesta ante incidentes. ## [Protecciones anti-raid](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) Cómo funcionan las defensas automáticas, qué sanciones aplican y cómo dejar el servidor preparado. Las protecciones anti-raid observan acciones masivas y reaccionan antes de que un ataque destruya la estructura del servidor. Cada protección se activa por separado y puede aplicar una sanción al ejecutor cuando el bot puede identificarlo. ### Protecciones disponibles | Protección | Qué vigila | Valor inicial | | --- | --- | --- | | Anti-Canales | Creación, eliminación y edición masiva de canales. | Desactivado | | Anti-Ban | Baneos masivos o injustificados. | Desactivado | | Anti-Kick | Expulsiones masivas. | Desactivado | | Anti-Roles | Creación, eliminación y modificación de roles. | Desactivado | | Filtro de Bots | Ingreso de bots no permitidos. | Desactivado | | Creación de Webhooks | Webhooks creados por cuentas maliciosas. | Desactivado | | Spam de Webhooks | Uso excesivo de webhooks. | Desactivado | | Anti-NSFW | Contenido explícito en mensajes y archivos. | Desactivado | | Anti-Links | Enlaces no permitidos o en exceso. | Desactivado | | Anti-Badwords | Palabras de la lista negra. | Desactivado | | Anti-ClientApp | Cuentas infectadas que spamean imágenes o scams. | Desactivado | | Ghost Ping | Menciones que se borran rápidamente. | Activado | ### Cómo se aplican las sanciones Cuando una protección detecta una acción, el bot consulta el registro de auditoría para identificar al ejecutor. Si la persona no es el propietario, el propio bot, otro bot o un usuario inmune, aplica la sanción configurada. Anti-Ban, Anti-Kick, Anti-Roles, Anti-Bots y Anti-Webhook Create permiten elegir entre ban y expulsión. > **Sin registro de auditoría no hay contexto** > Si NearSecurity no puede ver el registro de auditoría, no puede saber quién ejecutó la acción. Las protecciones pueden seguir bloqueando o revirtiendo, pero la sanción al responsable puede fallar. ### Listas blancas Los usuarios y roles inmunes quedan excluidos de las protecciones. Se configuran en **Avanzado** o con `/setup whitelist`. Mantené la lista corta y revisala cada vez que cambie el equipo. ### Configuración recomendada - Activá Anti-Ban, Anti-Kick, Anti-Canales y Anti-Roles desde el primer día. - Usá el filtro de bots en **Solo no verificados** si aceptás integraciones de forma habitual. - Activá Anti-Webhook Create y Anti-Webhook Spam si no usás webhooks propios. - Activá Anti-ClientApp y Ghost Ping; cubren patrones que las protecciones de estructura no detectan. - Configurá el canal de moderación antes de activar sanciones automáticas. - Creá un backup manual después de dejar la configuración estable. ### Atajos útiles | Acción | Comando | | --- | --- | | Ver toda la configuración de seguridad | `/estado` | | Activar una base recomendada | `/autoconfig` | | Activar o desactivar una protección | `/antiban`, `/antikick`, `/antichannels`, `/antirole`, `/antiwebhookcreate`, `/antiwebhookspam`, `/antinsfw`, `/ghostping` | | Configurar el filtro de bots | `/antibot` | | Ver el estado de las alertas por MD | `/owneralerts` | > **Las protecciones no son infalibles** > NearSecurity reduce el impacto de un ataque, pero no puede evitar todos los daños ni recuperar mensajes borrados. Mantené backups, revisá los permisos del equipo y actuá rápido cuando recibas una alerta. ## [Anti-ClientApp](https://nearsecurity.citymoon.org/docs/seguridad/anticlientapp) Protección contra cuentas infectadas que spamean imágenes, GIFs y scams de Steam. **Anti-ClientApp** no es el cliente oficial de Discord ni un sistema que revisa tu computadora. Es el nombre interno de la protección contra cuentas comprometidas por software malicioso que se hace pasar por un cliente de Discord y usa la cuenta para enviar spam masivo. Las cuentas infectadas suelen publicar imágenes y GIFs en varios canales, o mensajes con falsos sorteos y juegos gratis de Steam. El objetivo es que la mayor cantidad de personas haga clic y también termine infectada. ### Cómo se activa | Lugar | Acción | Alcance | | --- | --- | --- | | Dashboard | **Seguridad → Anti-ClientApp** | Activa o desactiva la protección del servidor. | | Discord | `/anticlientapp` | Muestra el estado actual y pide confirmación para cambiarlo. | | Configuración | `antiClientApp` | Se guarda por servidor y viene desactivado por defecto. | > **No requiere configuración adicional** > La protección usa la configuración de seguridad del servidor. Para recibir los registros, configurá el canal de moderación o el canal de logs. ### Qué detecta - Spam de imágenes o GIFs desde una misma cuenta en **3 o más canales distintos** en una ventana corta. - Mensajes con enlaces a imágenes o GIFs de dominios habituales, además de archivos adjuntos de imagen. - Patrones de scam de Steam: descuentos falsos del 100%, juegos gratis, sorteos, regalos y enlaces a sitios de Steam falsos. ### Qué hace cuando detecta el patrón | Acción | Detalle | | --- | --- | | Timeout | Silencia la cuenta durante **7 días**. | | Limpieza | Borra los mensajes recientes de esa cuenta en los canales afectados. | | Aviso por MD | Le informa que la cuenta podría estar infectada o comprometida. | | Registro | Envía un embed al canal de moderación o, si no existe, al canal de logs. | > **No aplica un ban automático** > El sistema prefiere silenciar y conservar el historial antes que expulsar a una persona que puede haber perdido el control de su cuenta. El equipo de moderación decide si corresponde un ban después de revisar el caso. ### Qué no hace - No escanea archivos ni detecta malware en la computadora del usuario. - No protege las conversaciones privadas ni las cuentas fuera del servidor. - No reemplaza un antivirus, la verificación en dos pasos ni las buenas prácticas de seguridad. - No elimina todos los mensajes históricos: limpia los recientes en los canales donde se detectó el patrón. ### Configuración recomendada 1. Activá Anti-ClientApp desde el dashboard o con `/anticlientapp`. 2. Asegurate de tener un canal de moderación configurado para revisar los casos. 3. Mantené activos Anti-Links y Anti-Spam para cubrir otros vectores del mismo ataque. 4. Avisá a la comunidad que no hagan clic en sorteos de Steam enviados por usuarios desconocidos. 5. Si un miembro recupera su cuenta, revisá el timeout y el historial antes de levantarlo. > **Falsos positivos** > Si un usuario legítimo publica muchas imágenes en varios canales, puede alcanzar el umbral. En ese caso, revisá el registro, levantá el timeout y considerá agregarlo a la lista blanca solo si es parte del equipo de confianza. ## [Anti-Links y filtros](https://nearsecurity.citymoon.org/docs/seguridad/antilinks) Configurá Anti-Links, filtros NSFW, palabras prohibidas y anti-spam. Listas blancas, sanciones y modo estricto desde el dashboard. Los filtros de contenido complementan las protecciones anti-raid. Mientras las defensas de estructura evitan que alguien destruya el servidor, los filtros evitan que el contenido malicioso llegue a los miembros. ### Filtro de enlaces Anti-Links analiza los enlaces de los mensajes y puede eliminarlos o sancionar según la configuración. La lista blanca define qué dominios se permiten; el resto se considera sospechoso si el filtro está activo. | Opción | Valor inicial | Qué hace | | --- | --- | --- | | Permitir enlaces de Discord | Activado | Permite invitaciones y enlaces de Discord. | | Permitir imágenes | Activado | Permite enlaces a imágenes. | | Permitir videos | Activado | Permite enlaces a videos. | | Modo estricto | Desactivado | Aplica un criterio más restrictivo a los enlaces. | | Máximo de enlaces por mensaje | 3 | Limita la cantidad de URLs en un mismo mensaje. | ### Lista blanca de dominios La lista inicial incluye `youtube.com`, `youtu.be`, `discord.com`, `discord.gg`, `github.com`, `stackoverflow.com`, `imgur.com`, `giphy.com` y `tenor.com`. Podés agregar hasta 100 dominios desde **Avanzado** o con `/antilinks whitelist`. > **Los subdominios** > El bot normaliza los dominios antes de compararlos. Si agregás `ejemplo.com`, los enlaces a `www.ejemplo.com` o `cdn.ejemplo.com` se evalúan según la misma entrada. ### NSFW y palabras ofensivas - **Filtro NSFW:** elimina contenido explícito detectado en mensajes y archivos. - **Filtro de palabras ofensivas:** compara el contenido con la lista negra configurada. La lista se edita en **Moderación** o con `/setup badwords`. - **Ghost Ping:** detecta menciones que se borran rápido y conserva la evidencia. ### Detección de spam La configuración adicional de seguridad permite controlar la detección de spam, los mensajes duplicados, los límites de ratio y el auto-timeout. Estos controles se aplican junto con los filtros y las protecciones anti-raid. | Ajuste | Valor inicial | Qué controla | | --- | --- | --- | | Detección de spam | Activado | Analiza patrones de spam en los mensajes. | | Mensajes duplicados | Activado | Detecta contenido repetido. | | Límites de ratio | Activado | Limita la cantidad de mensajes por minuto. | | Auto-Timeout | Activado | Aplica timeout automático según la severidad. | | Máximo de mensajes por minuto | 10 | Umbral del límite de ratio. | > **El contexto importa** > Un servidor de memes y un servidor de soporte necesitan umbrales distintos. Ajustá los filtros según la actividad real de tu comunidad y revisá los falsos positivos antes de aumentar las sanciones. ## [Modo Pánico](https://nearsecurity.citymoon.org/docs/seguridad/panic) Bloqueo de emergencia para detener un ataque en curso sin perder la configuración del servidor. El Modo Pánico bloquea el envío de mensajes en todos los canales de texto y guarda una instantánea de los permisos para poder restaurarlos después. Está pensado para ataques en curso, cuando cada segundo cuenta. ### Cómo se activa 1. Ejecutá `/panic` en el servidor. Solo el propietario puede hacerlo. 2. Elegí la duración: 1, 6, 12 o 24 horas. El valor predeterminado es 6 horas. 3. Seleccioná **Activar Pánico** y confirmá la acción en el segundo paso. 4. El bot bloquea los canales de texto y muestra cuántos fueron afectados. > **Confirmación doble** > La activación requiere dos confirmaciones para evitar bloqueos accidentales. El desbloqueo manual también se confirma desde el mismo panel. ### Qué pasa durante el bloqueo - Los miembros no pueden enviar mensajes en los canales de texto. - Las nuevas cuentas no autorizadas no pueden ingresar. - El bot registra el evento en el canal de moderación y en las alertas internas. - El estado y la fecha de expiración se muestran en el dashboard. ### Cómo se desactiva El modo se revierte automáticamente al cumplirse la duración. También se puede desbloquear manualmente con `/panic`, eligiendo **Desactivar Pánico**. En ambos casos, el bot restaura los permisos guardados en la instantánea. > **Si falla la restauración** > Si el bot no pudo restaurar algunos canales, el Modo Pánico sigue activo para permitir un reintento. Revisá que tenga `Gestionar canales` en todos los canales afectados. ### Recomendaciones - Usalo solo durante un ataque o una emergencia real. - Avisá al staff por un canal alternativo antes de bloquear. - Después del ataque, revisá el registro de auditoría, los webhooks y los roles comprometidos. - Si hubo destrucción de canales o roles, combiná con `/unnuke` o `/backup load`. ## [Logs y auditoría](https://nearsecurity.citymoon.org/docs/seguridad/logs) Canales de logs, modlog, historial de infracciones y alertas por mensaje directo. NearSecurity registra eventos del servidor, acciones de moderación y violaciones de seguridad. Hay tres destinos distintos y conviene no mezclarlos: logs de auditoría, canal de moderación e historial interno de infracciones. ### Tipos de registro | Registro | Dónde se configura | Qué contiene | | --- | --- | --- | | Logs de auditoría | **Logs → Canal de Logs** o `/setup logs` | Eventos de canales, roles, miembros, mensajes, webhooks, servidor y modo pánico. | | Modlog | **Moderación → Canal de Moderadores** | Sanciones y acciones automáticas con contexto para el staff. | | Historial de infracciones | Interno del bot | Metadatos de violaciones: usuario, tipo, severidad, fecha y canal. | | Alertas por MD | **Logs → Alertas por DM al Fundador** | Avisos directos al propietario ante intrusiones críticas. | ### Eventos de logs | Evento | Valor inicial | | --- | --- | | Canal creado | Activado | | Canal eliminado | Activado | | Canal editado | Activado | | Rol creado | Activado | | Rol eliminado | Activado | | Rol editado | Activado | | Usuario entra | Activado | | Usuario sale | Activado | | Usuario editado | Activado | | Mensaje eliminado | Activado | | Mensaje editado | Activado | | Webhook editado | Activado | | Servidor editado | Activado | | Modo Pánico | Activado | | Sanciones | Activado | ### Historial de infracciones El historial interno se consulta con `/securitylogs`. Permite ver las violaciones de un usuario, las estadísticas del servidor y limpiar registros por tipo. A diferencia del modlog, no se publica en un canal: se muestra bajo demanda a quienes tienen `Gestionar mensajes`. | Comando | Función | | --- | --- | | `/securitylogs usuario` | Historial de un usuario, agrupado por tipo. | | `/securitylogs servidor` | Totales, últimos siete días, tipos, severidades y usuarios con más registros. | | `/securitylogs limpiar` | Elimina registros por usuario o tipo. | ### Buenas prácticas - Usá un canal privado solo para el staff; los logs pueden contener IDs y datos sensibles. - Separar logs de auditoría y modlog facilita la búsqueda durante un incidente. - Verificá que el bot pueda escribir en ambos canales antes de activar sanciones automáticas. - Revisá el historial de infracciones antes de aplicar una sanción larga. - No compartas capturas de logs con datos personales fuera del equipo. > **Retención** > El historial de infracciones se guarda en la base de datos del bot y puede limpiarse con `/securitylogs limpiar`. Los mensajes de Discord se conservan según la configuración del servidor, no del bot. ## [Respuesta ante incidentes](https://nearsecurity.citymoon.org/docs/seguridad/incidentes) Qué hacer durante y después de un ataque: contener, auditar, revertir y restaurar. Un ataque no se resuelve con un solo comando. La respuesta tiene un orden: contener el daño, identificar al responsable, revertir los cambios y restaurar lo que se perdió. Este flujo reduce el impacto y evita que la recuperación empeore la situación. > **Durante el ataque, primero contener** > Si los canales se están borrando o se están aplicando baneos masivos, activá el Modo Pánico antes de investigar. Cada minuto sin contención puede multiplicar el daño. ### 1. Contener 1. Ejecutá `/panic` con la duración adecuada. Bloquea el envío de mensajes y el ingreso de cuentas no autorizadas. 2. Quitá permisos peligrosos a los roles comprometidos y revisá los webhooks. 3. Desconectá integraciones sospechosas y cambiá las contraseñas de las cuentas afectadas. 4. Avisá al staff por un canal alternativo si el servidor está bloqueado. > **El Modo Pánico no expulsa al atacante** > El bloqueo impide que la comunidad siga escribiendo, pero no elimina sesiones ni permisos existentes. Si el atacante conserva un rol con permisos, sigue pudiendo actuar. Revisá la jerarquía y los roles antes de confiar en el bloqueo. ### 2. Auditar - Ejecutá `/estado` para revisar las protecciones y las listas blancas. - Revisá el registro de auditoría de Discord para identificar al ejecutor y la hora de cada acción. - Consultá `/securitylogs servidor` para ver las detecciones automáticas. - Revisá los webhooks, los bots y las invitaciones recientes. - Guardá capturas y registros antes de eliminar cualquier elemento. ### 3. Revertir | Daño | Herramienta | Alcance | | --- | --- | --- | | Canales o roles duplicados | `/unnuke channels` o `/unnuke roles` | Ventana de hasta 24 horas. | | Canales o roles borrados | `/unnuke channels` o `/unnuke roles` | Solo si el bot registró la eliminación. | | Baneos masivos | `/unnuke bans` | Ventana de hasta 24 horas; `todos` es peligroso. | | Emojis duplicados | `/unnuke emojis` | Ventana de hasta 24 horas. | | Estructura completa | `/backup load` | Restauración parcial o total. | > **Revisá la vista previa** > `/unnuke` y `/backup load` muestran una vista previa antes de ejecutar. Leela completa. Una restauración completa elimina la estructura actual y no se puede deshacer. ### 4. Restaurar Si hay un respaldo reciente, usá primero **Restaurar solo lo faltante** para recuperar canales y roles sin borrar lo que quedó en pie. La restauración completa queda para casos en los que la estructura actual ya no es confiable. ### 5. Revisar y prevenir - Desactivá el Modo Pánico cuando el ataque haya terminado y los permisos estén corregidos. - Revisá que Anti-Ban, Anti-Kick, Anti-Canales, Anti-Roles y Anti-Webhooks estén activos. - Revisá la lista blanca: el atacante pudo haber agregado usuarios o roles. - Rotá los tokens de bots y las credenciales que hayan estado expuestas. - Documentá el incidente y actualizá el procedimiento del equipo. > **Después del incidente** > Una comunidad puede recuperar la estructura, pero no la confianza perdida. Comunicá qué pasó, qué se hizo y qué cambios se aplicaron. Evitá prometer que no volverá a ocurrir; explicá qué protecciones nuevas están en marcha. # Moderación Sanciones, historial y herramientas del equipo. ## [Sanciones y moderación](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) Cómo aplicar bans, kicks, timeouts, roles temporales y purgas con registro y evidencia. Las herramientas de moderación de NearSecurity están pensadas para que cada acción quede registrada con contexto: quién la aplicó, sobre quién, con qué motivo, durante cuánto tiempo y con qué prueba. El bot no reemplaza el criterio del equipo; reduce el trabajo repetitivo y deja un rastro verificable. - **Sanciones:** Ban, kick y timeout con formulario guiado. - **Registro:** Historial de casos y canal de moderación. - **Aviso al sancionado:** Mensaje directo cuando la configuración de privacidad lo permite. - **Evidencia:** URL `https` o descripción textual. ### Flujo de una sanción 1. Ejecutá el comando en el servidor. NearSecurity verifica tus permisos y la jerarquía de roles. 2. Completá el formulario con la razón, la duración y la prueba. La razón admite hasta 512 caracteres. 3. Revisá la vista previa y confirmá la acción. El bot vuelve a validar que el objetivo sea moderable. 4. La sanción se aplica, se envía un mensaje directo al usuario y se registra el caso. 5. El caso aparece en `/historial` y en el canal de moderación si está configurado. > **Jerarquía de roles** > NearSecurity no puede sancionar al propietario del servidor, a sí mismo ni a alguien con un rol igual o superior al suyo. Tampoco puede actuar si el rol del bot está por debajo del objetivo. Revisá la posición de los roles antes de culpar al bot. ### Comandos disponibles | Comando | Acción | Permiso requerido | Duración | | --- | --- | --- | --- | | `/ban` | Banea con razón, duración y prueba. | Banear miembros | Temporal o permanente. | | `/kick` | Expulsa al miembro del servidor. | Expulsar miembros | No aplica. | | `/timeout` | Silencia al miembro. | Moderar miembros | Temporal; 10 minutos por defecto. | | `/temprole` | Asigna un rol y lo retira al vencer. | Gestionar roles | Máximo 30 días. | | `/purge` | Elimina mensajes en masa. | Gestionar mensajes | No aplica. | | `/notas` | Guarda notas internas del usuario. | Gestionar mensajes | No aplica. | | `/historial` | Consulta los casos registrados. | Moderar miembros | No aplica. | ### Duraciones aceptadas | Formato | Significado | Ejemplo | | --- | --- | --- | | `10m` | 10 minutos. | `/timeout usuario:@nombre` → duración `10m`. | | `1h` | 1 hora. | `/ban usuario:@nombre` → duración `1h`. | | `7d` | 7 días. | `/temprole` → tiempo `7d`. | | `perma` | Permanente, solo para bans. | `/ban usuario:@nombre` → duración `perma`. | > **Bans temporales** > Cuando un ban tiene duración, NearSecurity programa el desbaneo automático y lo registra en el caso. Si el bot se reinicia antes del vencimiento, la tarea se recupera desde la base de datos al arrancar. ### Evidencia y privacidad - La prueba puede ser una URL `https` o texto sin enlaces. Los enlaces `http` se rechazan. - No adjuntes capturas con datos personales que no sean necesarios para el caso. - El mensaje directo al sancionado incluye la razón, la duración y la prueba. Si el usuario tiene los MD cerrados, el envío falla sin bloquear la sanción. - Las notas internas de `/notas` no se envían al miembro ni se publican en el servidor. ### Buenas prácticas - Usá una razón concreta y verificable; evitá textos como «mal comportamiento». - Guardá la prueba antes de borrar mensajes con `/purge`. - Para faltas leves, preferí timeout o advertencia antes que un ban permanente. - Revisá `/historial` antes de decidir una reincidencia. - Separar el canal de moderación del canal de logs evita mezclar sanciones con eventos técnicos. > **Sanciones automáticas** > Las protecciones anti-raid y los filtros también aplican sanciones. Esas acciones se registran en el mismo historial y se distinguen por el contexto del caso. Si una sanción automática te parece incorrecta, revisá la configuración y la lista blanca antes de desactivar la protección. ## [Historial, casos y notas](https://nearsecurity.citymoon.org/docs/moderacion/historial) Consulta sanciones, entiende los casos y diferencia el historial de moderación del historial de infracciones. NearSecurity guarda dos historiales distintos: los casos de moderación, que registran sanciones aplicadas por personas o por el bot, y el historial de infracciones de seguridad, que registra detecciones de filtros y protecciones. Se consultan con comandos diferentes y tienen propósitos diferentes. ### Historial de sanciones `/historial` muestra los casos más recientes del servidor. Podés filtrar por usuario y limitar la cantidad de resultados entre 1 y 10; por defecto se muestran 5. Los casos se navegan con botones y cada uno incluye usuario, moderador, acción, razón, duración, prueba y fecha. | Campo | Qué muestra | | --- | --- | | Usuario | Mención, nombre e ID del sancionado. | | Moderador | Responsable de la acción. Puede ser el bot en sanciones automáticas. | | Acción | Ban, kick, timeout u otra sanción registrada. | | Razón | Motivo indicado en el formulario. | | Duración | Tiempo de la sanción y fecha de expiración cuando corresponde. | | Prueba | URL o descripción adjunta al caso. | > **Casos temporales** > Los casos con duración guardan una fecha de expiración. Cuando el ban expira y el desbaneo automático se ejecuta, el caso se actualiza para reflejar que ya no está vigente. El historial no elimina el registro. ### Notas internas `/notas` permite guardar observaciones que no constituyen una sanción: contexto familiar, acuerdos con el miembro, seguimiento de una situación o advertencias informales. Las notas se numeran por usuario y se pueden añadir, listar y eliminar. | Comando | Función | | --- | --- | | `/notas añadir` | Agrega una nota al usuario indicado. | | `/notas ver` | Muestra todas las notas guardadas del usuario. | | `/notas eliminar` | Elimina una nota por su número. | > **Las notas no son secretas para el staff** > Cualquier persona con `Gestionar mensajes` puede leer y modificar las notas. No guardes contraseñas, tokens ni información sensible que no corresponda a la moderación. ### Historial de infracciones `/securitylogs` es el historial de detecciones automáticas. Guarda metadatos de cada violación: usuario, tipo, severidad, fecha y canal. No guarda el contenido completo de los mensajes. Se usa para detectar patrones de reincidencia y para auditar la eficacia de los filtros. | Comando | Función | | --- | --- | | `/securitylogs usuario` | Historial de un usuario, agrupado por tipo de violación. | | `/securitylogs servidor` | Totales del servidor, últimos siete días, tipos y severidades. | | `/securitylogs limpiar` | Elimina registros por usuario o tipo. | | Historial | Qué registra | Se consulta con | | --- | --- | --- | | Casos de moderación | Sanciones aplicadas por personas o por el bot. | `/historial` | | Infracciones de seguridad | Detecciones de filtros y protecciones automáticas. | `/securitylogs` | > **Diferencia clave** > Un timeout por spam puede aparecer en ambos historiales: como caso de moderación y como infracción de seguridad. No son duplicados; cada uno guarda información distinta y se conserva por separado. ### Buenas prácticas - Consultá el historial antes de aplicar una sanción larga o permanente. - Usá notas para el contexto que no merece una sanción formal. - No limpies el historial de infracciones durante una investigación activa. - Revisá periódicamente las estadísticas del servidor para detectar canales problemáticos. - Documentá en el caso qué prueba se revisó y dónde está guardada. # Comunidad Bienvenidas, niveles, sorteos, tickets y más. ## [Bienvenida](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) Configura el mensaje de entrada, las variables disponibles y la tarjeta de bienvenida. El sistema de bienvenida envía un mensaje cuando alguien entra al servidor. Se configura únicamente desde el dashboard: el comando `/setup welcome` solo muestra el enlace al panel. Podés usar un mensaje de texto simple o un embed con imagen, miniatura, color y pie. ### Dónde se configura | Ajuste | Dónde | Qué hace | | --- | --- | --- | | Activación | **Bienvenida → Activar Sistema** | Envía el mensaje a los nuevos miembros. | | Canal | **Bienvenida → Canal de Bienvenida** | Canal donde se publica el mensaje. | | Tipo | **Bienvenida → Tipo de mensaje** | Texto normal o embed. | | Contenido | **Bienvenida → Mensaje** | Texto o campos del embed. | | Apariencia | **Bienvenida → Color, miniatura, imagen y pie** | Solo para el formato embed. | ### Variables disponibles | Variable | Se reemplaza por | | --- | --- | | `{user}` | Mención del nuevo miembro. | | `{server}` | Nombre del servidor. | | `{user.tag}` | Nombre de usuario sin discriminador. | | `{user.id}` | ID de la cuenta. | | `{user.avatar}` | URL del avatar. | | `{server.memberCount}` | Cantidad de miembros al momento del ingreso. | > **Las variables funcionan en ambos formatos** > En un embed, las variables se reemplazan en el título, la descripción y el pie. Si una variable no se puede resolver, se reemplaza por un valor vacío. ### Mensaje normal o embed | Formato | Ventajas | Cuándo usarlo | | --- | --- | --- | | Texto normal | Rápido de editar y compatible con cualquier canal. | Comunidades que prefieren un saludo breve. | | Embed | Permite color, imagen, miniatura y pie. | Servidores con identidad visual definida. | ### Tarjeta de bienvenida Si elegís el formato embed y no definís una imagen personalizada, NearSecurity genera una tarjeta con el avatar y el nombre del miembro. Si definís una imagen `https`, se usa esa imagen y no se genera la tarjeta. La generación de la tarjeta puede fallar si el servidor no tiene los recursos de imagen disponibles; en ese caso el mensaje se envía sin la tarjeta. > **Permisos del canal** > El bot necesita `Ver canales`, `Enviar mensajes` e `Insertar enlaces` en el canal de bienvenida. Si el canal es privado, verificá que el rol del bot tenga acceso. Un error de permisos no se anuncia en el servidor; revisá el estado del canal si el mensaje no llega. ### Buenas prácticas - Mencioná al nuevo miembro con `{user}` para que la bienvenida sea visible. - Incluí una referencia breve a las normas y al canal de soporte. - No prometas roles ni beneficios que el servidor no entrega automáticamente. - Probá el mensaje con una cuenta de prueba antes de activarlo en producción. - Revisá la bienvenida cuando cambien el nombre, el icono o la identidad del servidor. ## [Niveles y experiencia](https://nearsecurity.citymoon.org/docs/comunidad/niveles) Configura XP, roles por nivel, rankings, perfiles, personalización y duelos. El sistema de niveles otorga experiencia por actividad y desbloquea roles, rankings y personalización de la tarjeta de perfil. Viene activado por defecto en las configuraciones nuevas, con valores conservadores para que el progreso sea visible sin premiar el spam. - **XP por mensaje:** 15 - **XP por minuto en voz:** 10 - **Cooldown entre mensajes:** 60 segundos - **Mensaje de subida de nivel:** Activado ### Cómo se gana XP - Cada mensaje válido otorga XP si pasó el cooldown configurado. - La permanencia en canales de voz otorga XP por minuto. - Los mensajes duplicados, los comandos y el spam no deberían usarse para farmear XP; el cooldown y los filtros reducen el abuso. - El progreso se calcula con una curva creciente: el primer nivel requiere 100 XP y cada nivel siguiente aumenta el requisito un 50 %. | Ajuste | Rango | Predeterminado | | --- | --- | --- | | XP por mensaje | 1–100 | 15 | | XP por minuto en voz | 1–50 | 10 | | Cooldown entre mensajes | 10–300 segundos | 60 | La configuración se puede cambiar desde el dashboard o con `/nivel config`. El comando requiere `Administrador` y muestra un resumen de los valores aplicados. ### Roles automáticos por nivel Podés asociar uno o varios roles a un nivel con `/nivel autorol`. Cuando un miembro alcanza ese nivel, el bot le otorga los roles configurados. Si el rol del bot está por debajo del rol que intenta asignar, la entrega falla. > **Revisá la jerarquía** > Los roles automáticos deben estar por debajo del rol del bot. Si un rol otorga permisos administrativos, cualquier miembro que llegue a ese nivel los recibirá. Usá roles cosméticos o de acceso, no roles de staff. ### Rankings y perfil | Comando | Función | | --- | --- | | `/nivel leaderboard` | Ranking del servidor, con paginación. | | `/nivel global` | Ranking global entre servidores, con paginación. | | `/nivel perfil` | Perfil de nivel propio o de otro miembro. | | `/perfil` | Acceso rápido a tu tarjeta de perfil. | ### Personalización y tienda La tienda usa el XP total acumulado como moneda. Podés comprar fondos, fuentes y el pase de banner personalizado. Los objetos comprados quedan asociados a la cuenta y se aplican con `/nivel personalizar`. | Artículo | Qué permite | | --- | --- | | Fondos | Cambiar el fondo de la tarjeta de perfil. | | Fuentes | Cambiar la tipografía de la tarjeta. | | Pase de banner personalizado | Usar una URL propia como banner; cuesta 100.000 XP. | > **Las compras descuentan XP** > Al comprar un artículo se descuenta XP de tu total. El nivel y el progreso se recalculan según el XP restante. No se puede comprar un artículo que ya está en la colección. ### Duelos `/duelo` permite apostar XP contra otro miembro. Ambos deben tener XP suficiente y el retado tiene 30 segundos para aceptar o rechazar. El resultado se decide al azar y el ganador recibe la apuesta; el perdedor la pierde. No se puede retar a bots ni a uno mismo. ### Buenas prácticas - No uses XP por mensaje muy alto en servidores grandes: incentiva el spam. - Configurá el canal de subida de nivel en un canal de bajo tráfico. - Revisá los roles automáticos cada vez que cambie la estructura de permisos. - Avisá a la comunidad cómo funciona la tienda y cuánto cuesta el pase de banner. - Si el ranking no se actualiza, verificá que el sistema de niveles esté activo. ## [Sorteos](https://nearsecurity.citymoon.org/docs/comunidad/sorteos) Crea sorteos con requisitos, editalos, finalizalos y volvé a sortear ganadores. El sistema de sorteos permite crear un sorteo con premio, duración, cantidad de ganadores, canal y requisitos opcionales. Los participantes se registran con un botón y el sorteo se finaliza automáticamente al vencer el plazo. ### Crear un sorteo `/giveaway create` requiere `Gestionar eventos`. La duración acepta formatos como `30m`, `2h`, `7d` o `1w`, con un mínimo de 10 segundos y un máximo de 30 días. La imagen, si se indica, debe ser una URL `http` o `https` que termine en `.jpg`, `.jpeg`, `.png`, `.gif` o `.webp`. | Opción | Obligatoria | Qué hace | | --- | --- | --- | | Premio | Sí | Nombre del premio que se muestra en el embed. | | Duración | Sí | Tiempo hasta la finalización automática. | | Ganadores | Sí | Cantidad de ganadores a seleccionar. | | Canal | Sí | Canal donde se publica el sorteo. | | Descripción | No | Texto adicional del sorteo. | | Rol requerido | No | Solo participan miembros con ese rol. | | Solo boosters | No | Restringe la participación a server boosters. | | Edad de cuenta | No | Edad mínima de la cuenta, por ejemplo `30d`. | | Tiempo en servidor | No | Permanencia mínima en el servidor, por ejemplo `7d`. | | Imagen | No | URL de imagen para el embed. | | Privado | No | Oculta la lista de participantes. | > **Requisitos acumulativos** > Si configurás varios requisitos, el participante debe cumplir todos. Un miembro sin el rol requerido no puede participar aunque cumpla la edad de cuenta y el tiempo en el servidor. ### Administrar sorteos | Comando | Función | Permiso | | --- | --- | --- | | `/giveaway list` | Lista los sorteos activos. | Sin permiso especial. | | `/giveaway participants` | Muestra hasta 20 participantes. | Sin permiso especial; falla si el sorteo es privado. | | `/giveaway edit` | Cambia premio, duración, ganadores, imagen o descripción. | Gestionar eventos. | | `/giveaway end` | Finaliza el sorteo antes del plazo. | Gestionar eventos. | | `/giveaway reroll` | Vuelve a sortear los ganadores de un sorteo finalizado. | Gestionar eventos. | ### Cómo se eligen los ganadores NearSecurity mezcla la lista de participantes y selecciona la cantidad de ganadores indicada. Si hay menos participantes que ganadores, todos los participantes ganan. El resultado se publica en el canal del sorteo y el sorteo deja de aceptar nuevos participantes. > **Editar un sorteo activo** > Cambiar la duración de un sorteo activo reprograma la finalización. Si acortás el plazo, el sorteo puede finalizar casi de inmediato. Verificá el cambio antes de confirmarlo. ### Buenas prácticas - Usá requisitos que puedas verificar y explicá las reglas en la descripción. - No exijas roles que se obtienen después de participar: el requisito se evalúa al momento de entrar. - Para sorteos grandes, usá un canal dedicado y evitá mezclar el anuncio con conversación. - Guardá el ID del mensaje del sorteo si necesitás editarlo o rerollearnlo después. - Revisá que el bot pueda enviar mensajes e insertar enlaces en el canal del sorteo. ## [Tickets de soporte](https://nearsecurity.citymoon.org/docs/comunidad/tickets) Configura el panel, los límites, los permisos y las transcripciones del sistema de tickets. El sistema de tickets crea un canal privado por consulta, con permisos para el creador, el bot y el staff. Los usuarios abren tickets con un botón del panel o con `/ticket create`; el equipo puede reclamarlos, añadir o quitar participantes, renombrarlos y cerrarlos con transcripción. ### Configuración inicial `/ticket setup` abre un panel con botones para configurar la información básica, personalizar el embed, definir los mensajes, enviar el panel y el canal de logs, ver la configuración o restablecerla. El comando requiere `Administrador` o ser propietario del servidor. 1. Ejecutá `/ticket setup` y elegí **Configurar Básico** para definir título, descripción, texto del botón y límite de tickets por usuario. 2. Usá **Personalizar Embed** para cambiar color, pie, imagen y miniatura del panel. 3. Configurá el **Mensaje de bienvenida** que verá el usuario dentro del ticket. 4. Elegí **Enviar Panel + Logs** para publicar el panel y definir el canal de transcripciones. 5. Probá el flujo con una cuenta de prueba antes de anunciarlo. > **El panel y los logs** > El panel se publica en el canal que indiques. El canal de logs es opcional; si no lo configurás, las transcripciones no se envían a ningún canal y solo quedan asociadas al ticket. ### Límites El límite de tickets abiertos por usuario se define en la configuración básica o con `/ticket setlimit`, entre 1 y 10. El valor predeterminado es 1. El bot cuenta solo los tickets abiertos o reclamados y, además, rechaza la creación si el usuario ya tiene un ticket sin cerrar. | Comando | Función | Quién puede usarlo | | --- | --- | --- | | `/ticket create` | Crea un ticket privado. | Cualquier miembro. | | `/ticket claim` | Marca el ticket como reclamado por el staff. | Creador o staff con acceso al canal. | | `/ticket adduser` | Da acceso a otro miembro. | Creador o staff con acceso al canal. | | `/ticket removeuser` | Quita el acceso a un miembro. | Creador o staff con acceso al canal. | | `/ticket rename` | Cambia el nombre del canal. | Creador o staff con acceso al canal. | | `/ticket done` | Cierra el ticket y genera la transcripción. | Creador o staff con acceso al canal. | | `/ticket updatepanel` | Vuelve a publicar el panel con la configuración actual. | Administrador o propietario del servidor. | ### Cierre y transcripción Al cerrar un ticket, NearSecurity recopila los mensajes del canal, genera una transcripción HTML y la envía al canal de logs configurado. Después elimina el canal del ticket. La transcripción incluye autor, contenido, fecha y adjuntos; no incluye los mensajes eliminados antes del cierre. > **La transcripción no es un backup** > El archivo HTML se envía al canal de logs y luego se descarta del almacenamiento temporal. Si necesitás conservarlo, descargalo del canal de logs. El canal del ticket se elimina y no se puede recuperar. ### Buenas prácticas - Usá un canal de logs privado, separado del canal de moderación. - Definí un límite bajo si el equipo es pequeño; evita acumular tickets sin atender. - Explicá en el panel qué información debe incluir el usuario para agilizar la respuesta. - Revisá los permisos del bot en la categoría donde se crean los tickets. - No uses tickets para conversaciones que deben quedar en un canal público; el ticket nace privado. ## [Sugerencias](https://nearsecurity.citymoon.org/docs/comunidad/sugerencias) Activa el canal de sugerencias, publica propuestas y permite que el staff las valide. El sistema de sugerencias publica las propuestas de la comunidad en un canal dedicado y abre un hilo de discusión por cada una. El staff puede validar o denegar la sugerencia con los botones del mensaje. ### Activación 1. Activá **Comunidad → Activar Sugerencias** en el dashboard. 2. Elegí el canal de sugerencias en el mismo panel o ejecutá `/setup sugerencias canal:#sugerencias`. 3. Verificá que el bot pueda crear hilos en ese canal. 4. Publicá una sugerencia de prueba con `/sugerir`. > **El canal debe permitir hilos** > El bot intenta crear un hilo público por cada sugerencia. Si el canal no permite hilos o el bot no tiene permisos, la sugerencia se publica igual pero la discusión no se crea. ### Cómo funciona | Paso | Qué ocurre | | --- | --- | | 1. Envío | El usuario ejecuta `/sugerir` con un texto de hasta 1.000 caracteres. | | 2. Publicación | El bot publica un embed en el canal configurado. | | 3. Discusión | Se crea un hilo con el nombre del autor para comentar la propuesta. | | 4. Revisión | El staff usa los botones **Validar** o **Denegar**. | | 5. Resultado | El estado del embed cambia a validada o denegada y los botones se desactivan. | Solo los administradores pueden validar o denegar una sugerencia. El estado se actualiza en el mensaje original; no se envía un mensaje adicional al autor. ### Buenas prácticas - Definí en las normas qué tipo de sugerencias se aceptan y cuáles se eliminan. - No prometas que todas las sugerencias validadas se implementarán. - Usá el hilo para preguntar por el contexto antes de validar. - Revisá el canal de sugerencias antes de cambiar la configuración. - Si el sistema no está configurado, `/sugerir` responde con un error efímero y no publica nada. ## [Recordatorios](https://nearsecurity.citymoon.org/docs/comunidad/recordatorios) Crea recordatorios por mensaje directo, con repetición diaria o semanal. Los recordatorios envían un mensaje directo en la fecha indicada. Se administran con `/recordatorio` y se guardan por usuario; no se publican en el servidor. ### Crear un recordatorio `/recordatorio crear` pide el mensaje, la fecha y, opcionalmente, la repetición. El mensaje admite hasta 500 caracteres. La fecha debe estar en el futuro y se interpreta en la zona horaria del servidor donde corre el bot. | Formato | Ejemplo | | --- | --- | | `YYYY-MM-DD HH:MM` | `2026-12-25 15:30` | | `DD/MM/YYYY HH:MM` | `25/12/2026 15:30` | | `DD-MM-YYYY HH:MM` | `25-12-2026 15:30` | | Repetición | Comportamiento | | --- | --- | | No repetir | Se envía una sola vez y se elimina de la lista. | | Todos los días | Se reprograma para el día siguiente a la misma hora. | | Cada semana | Se reprograma para la misma fecha de la semana siguiente. | ### Administrar recordatorios | Comando | Función | | --- | --- | | `/recordatorio listar` | Muestra tus recordatorios activos y su próxima fecha. | | `/recordatorio eliminar` | Elimina un recordatorio por ID. | > **Mensajes directos** > Si el usuario tiene los mensajes directos cerrados, el recordatorio no se puede entregar. NearSecurity no publica un aviso alternativo en el servidor. ### Buenas prácticas - Usá recordatorios para eventos, plazos o seguimientos personales, no para spam. - Verificá la fecha antes de guardar; un error de mes puede programar el aviso para el año siguiente. - Revisá la lista si cambió la zona horaria del servidor. - Los recordatorios son personales: cada usuario ve y elimina los suyos. ## [Seguimientos de creadores](https://nearsecurity.citymoon.org/docs/comunidad/seguimientos) Notifica nuevas publicaciones o directos de YouTube, Twitch y Kick en un canal de Discord. `/seguir` permite suscribir un canal de Discord a las nuevas publicaciones o directos de un creador. NearSecurity consulta la plataforma periódicamente y publica la novedad en el canal indicado. | Plataforma | Objetivo que se indica | Qué se notifica | | --- | --- | --- | | YouTube | ID del canal, por ejemplo `UC...` | Videos nuevos del feed del canal. | | Twitch | Nombre de usuario de Twitch. | Inicio de un directo. | | Kick | Nombre de usuario de Kick. | Inicio de un directo. | No se permiten objetivos duplicados: si ya existe un seguimiento para la misma plataforma y el mismo objetivo, el bot rechaza el alta. El canal de destino puede ser distinto del canal donde se ejecuta el comando. > **Dependencia de servicios externos** > Las notificaciones dependen de las API públicas de YouTube, Twitch y Kick. Si una plataforma cambia su respuesta o limita las consultas, el seguimiento puede dejar de recibir novedades sin que el bot pueda evitarlo. ### Buenas prácticas - Usá un canal de anuncios para evitar que las notificaciones se pierdan en el chat. - Verificá el identificador del canal de YouTube: el nombre visible no siempre coincide con el ID. - No sigas a varios creadores en el mismo canal si el volumen de avisos es alto. - Revisá el seguimiento después de un cambio de nombre o de plataforma del creador. # Utilidades Consultas y herramientas puntuales. ## [Información del servidor](https://nearsecurity.citymoon.org/docs/utilidades/servidor) Consultá datos de servidores, usuarios y canales, y verificá la configuración de seguridad. NearSecurity incluye comandos de consulta que no modifican el servidor. Sirven para revisar estructura, permisos y actividad antes de tomar una decisión de moderación o configuración. ### Servidor | Comando | Qué muestra | | --- | --- | | `/server info` | Nombre, ID, propietario, fecha de creación, miembros, canales, roles y boosts. | | `/server icon` | Icono del servidor en tamaño completo. | | `/server banner` | Banner del servidor, si tiene uno. | ### Usuarios | Comando | Qué muestra | | --- | --- | | `/user info` | Nombre, ID, fecha de creación, apodo, rol más alto y estado. | | `/user avatar` | Avatar del usuario. | | `/user banner` | Banner del perfil, si tiene uno. | | `/user roles` | Roles del miembro en el servidor. | | `/user permissions` | Permisos efectivos en el servidor. | | `/osint` | Panel con información pública, badges, antigüedad y estado en blacklist. | ### Canales | Comando | Qué muestra | | --- | --- | | `/channel info` | Nombre, ID, tipo, categoría, tema, posición y límites. | | `/channel permissions` | Permisos del canal y diferencias respecto de la categoría. | | `/channel roles` | Roles con acceso al canal. | | `/channel nuke` | Recrea el canal y borra todos sus mensajes. | > **`/channel nuke` es irreversible** > El comando elimina el canal y crea uno nuevo con el mismo nombre, categoría, tema y permisos. Se pierden todos los mensajes y los hilos. Requiere `Administrador`. Confirmá dos veces el canal antes de ejecutarlo. ### Bot y estado | Comando | Qué muestra | | --- | --- | | `/bot info` | Versión, servidores, usuarios, plataforma, uptime, ping, RAM y acceso al detalle técnico. | | `/bot icon` | Icono del bot. | | `/stats` | Panel visual con miembros, mensajes, top de XP y actividad de los últimos 14 días. | | `/estado` | Resumen paginado de toda la configuración de seguridad del servidor. | `/estado` requiere `Administrador` y muestra seis páginas con protecciones, sanciones, logs, filtros, listas blancas y el estado de Anti-ClientApp. Es la forma más rápida de verificar que un cambio se aplicó. ### Onboarding `/empezar` abre un menú interactivo con las categorías de comandos y enlaces al dashboard y al servidor de soporte. Es el punto de entrada recomendado para nuevos administradores. > **Privacidad** > Los comandos de consulta muestran datos que ya están visibles en Discord. `/osint` además consulta la blacklist local. Usá estas herramientas para moderar, no para recopilar información personal innecesaria. ## [Herramientas](https://nearsecurity.citymoon.org/docs/utilidades/herramientas) Cifrá mensajes, escaneá archivos y URLs con VirusTotal, traducí texto y enviá reportes de errores desde Discord. Estas herramientas están pensadas para tareas puntuales: compartir un texto cifrado, analizar un archivo sospechoso, traducir un mensaje o reportar un fallo del bot. Ninguna modifica la configuración del servidor. ### Cifrado de mensajes `/encrypt` cifra un texto con AES-256-GCM y una contraseña. El resultado es un hash que se puede descifrar con `/decrypt` usando el mismo hash y la misma contraseña. Sin la contraseña correcta no se puede recuperar el contenido. | Comando | Entrada | Salida | | --- | --- | --- | | `/encrypt` | Mensaje y contraseña. | Hash cifrado. | | `/decrypt` | Hash y contraseña. | Mensaje original o error de descifrado. | > **La contraseña no se puede recuperar** > NearSecurity no guarda la contraseña ni puede restaurarla. Si la perdés, el hash queda inutilizable. No compartas la contraseña por el mismo canal que el hash. ### Análisis con VirusTotal `/filescan` analiza archivos y URLs con VirusTotal. La API key se configura una vez por despliegue con `/filescan config`; debe tener 64 caracteres y se guarda localmente en el host del bot. Los escaneos se ejecutan con el permiso `Gestionar mensajes`. | Comando | Qué analiza | Límite | | --- | --- | --- | | `/filescan scan` | Un archivo adjunto. | Máximo 32 MB. | | `/filescan scanurl` | Una URL. | La URL se envía a VirusTotal. | | `/filescan config` | La API key global del bot. | 64 caracteres. | > **Servicio externo** > El archivo o la URL se envía a VirusTotal. No escanees documentos privados ni enlaces internos sin autorización. El resultado depende de los motores y de la disponibilidad del servicio. ### Traducción `/traducir` abre un formulario para pegar el texto y elegir el idioma de destino. Usa Google Translate y depende de la disponibilidad del servicio. No se garantiza la precisión de la traducción. ### Reporte de bugs `/bugs` envía un reporte al equipo de desarrollo con título y descripción. El formulario pide pasos para reproducir el problema y tiene un límite de un reporte por minuto por usuario. - Incluí el comando exacto, el resultado esperado y el resultado obtenido. - Si el error ocurre en un servidor, indicá el nombre del servidor y el canal. - No incluyas tokens, contraseñas ni datos personales en la descripción. - Para problemas de permisos, adjuntá una captura de la configuración de roles. > **Soporte** > Los reportes de bugs llegan al equipo de desarrollo. Para consultas de configuración, usá el servidor de soporte o la documentación antes de abrir un reporte. # Recuperación Respaldos y reversión de ataques. ## [Respaldos del servidor](https://nearsecurity.citymoon.org/docs/recuperacion/backups) Crea, revisa y restaura copias de la estructura de roles, canales y permisos. Los respaldos guardan la estructura del servidor: roles, canales, categorías, permisos y ajustes de canales como el tema o el límite de usuarios. No guardan mensajes, miembros, reacciones ni historial de sanciones. Cada usuario tiene sus propios respaldos y puede restaurarlos en un servidor donde tenga permisos. > **Un respaldo no es una copia de seguridad completa** > Si el servidor se pierde, el respaldo permite reconstruir la estructura, pero no recuperar conversaciones, archivos ni miembros. Para conservar conversaciones importantes, usá las herramientas de Discord o exportaciones propias. ### Requisitos - El comando `/backup` requiere `Administrador`. - El bot necesita `Gestionar canales` y `Gestionar roles` para restaurar. - El rol del bot debe estar por encima de los roles que intenta crear o modificar. - La restauración se ejecuta en el servidor donde se invoca el comando, no en el servidor de origen del respaldo. ### Comandos | Comando | Función | | --- | --- | | `/backup create` | Crea un respaldo con el nombre indicado. El nombre es opcional. | | `/backup list` | Lista los respaldos guardados en tu cuenta. | | `/backup info` | Genera una vista previa en HTML del contenido del respaldo. | | `/backup load` | Selecciona un respaldo y elige el modo de restauración. | | `/backup delete` | Elimina uno de tus respaldos. | ### Modos de restauración | Modo | Qué hace | Riesgo | | --- | --- | --- | | Restaurar solo lo faltante | Crea los roles y canales que no existan. No borra ni modifica los actuales. | Bajo. Puede duplicar elementos con nombres distintos. | | Restauración completa | Elimina los canales y roles actuales y aplica el respaldo. | Alto. Es irreversible y puede borrar canales con actividad. | > **La restauración completa borra la estructura actual** > NearSecurity elimina primero los canales y roles existentes y después recrea los del respaldo. Los mensajes de los canales eliminados se pierden. Usá este modo solo en un servidor de prueba o cuando la estructura actual ya no sea recuperable. ### Flujo recomendado 1. Creá un respaldo antes de cualquier cambio grande de estructura. 2. Revisá el respaldo con `/backup info` para confirmar que contiene los roles y canales esperados. 3. Si vas a restaurar, elegí primero **Restaurar solo lo faltante**. 4. Revisá el resultado y los permisos de los canales creados. 5. Si necesitás una restauración completa, hacelo en una ventana de mantenimiento y avisá al equipo. > **Los respaldos son personales** > Cada usuario ve solo sus propios respaldos. Si un administrador crea un respaldo y luego pierde el acceso al servidor, puede seguir usándolo en otro servidor donde tenga permisos. No compartas tu cuenta ni el ID de un respaldo con personas que no deban restaurarlo. ### Limitaciones - No se guardan mensajes, adjuntos ni reacciones. - No se guardan miembros, sanciones ni notas de moderación. - Los roles administrados por integraciones no se recrean automáticamente. - Los permisos de un rol que ya no existe se pierden si el respaldo no los incluye. - La restauración no garantiza el orden exacto de los roles si la jerarquía del servidor cambió. ## [Revertir un ataque](https://nearsecurity.citymoon.org/docs/recuperacion/unnuke) Limpia duplicados, restaura canales y roles borrados y levanta baneos recientes. `/unnuke` es la herramienta de recuperación para después de un ataque. Permite eliminar canales, roles y emojis duplicados creados durante el ataque, restaurar canales y roles borrados desde el registro automático del bot y levantar baneos recientes. Está reservada al propietario del servidor. > **Primero contené el ataque** > No ejecutes `/unnuke` mientras el atacante sigue activo. Activá el Modo Pánico, quitá permisos comprometidos y revisá los webhooks antes de revertir. Si limpiás la estructura mientras el ataque continúa, el atacante puede volver a crear los elementos. ### Comandos | Comando | Qué limpia | Ventana | | --- | --- | --- | | `/unnuke channels` | Canales duplicados y canales borrados que el bot pueda restaurar. | 1–1440 minutos; 60 por defecto. | | `/unnuke roles` | Roles duplicados y roles borrados que el bot pueda restaurar. | 1–1440 minutos; 60 por defecto. | | `/unnuke emojis` | Emojis duplicados creados durante el ataque. | 1–1440 minutos; 60 por defecto. | | `/unnuke bans` | Baneos recientes aplicados durante el ataque. | 1–1440 minutos; 60 por defecto. | Cada comando muestra una vista previa con los elementos que va a eliminar o restaurar. La acción se ejecuta solo después de una confirmación. La restauración crea lo que falta; no borra ni modifica los elementos que ya existen. ### Cómo detecta los duplicados NearSecurity agrupa canales, roles y emojis por nombre normalizado dentro de la ventana de tiempo indicada. Si encuentra más de un elemento con el mismo nombre, conserva el más antiguo y marca los demás como duplicados. También consulta el registro de auditoría para identificar elementos creados durante el ataque. > **Los duplicados legítimos no son ataque** > Un servidor puede tener canales con el mismo nombre en categorías distintas. La detección agrupa por nombre, no por categoría. Revisá siempre la vista previa antes de confirmar para no eliminar un canal legítimo. ### Restauración de estructura - El bot registra los canales y roles eliminados desde que está en el servidor. - La restauración solo alcanza elementos borrados dentro de la ventana indicada. - Se recrean el nombre, el tipo, la categoría, el tema y los permisos cuando están disponibles. - Los mensajes de un canal restaurado no se recuperan: el canal se crea vacío. - Los roles restaurados pueden quedar por debajo del rol del bot si la jerarquía cambió. ### Baneos recientes `/unnuke bans` levanta los baneos aplicados dentro de la ventana. La opción `todos` desbanea absolutamente a todos los usuarios y es peligrosa: puede readmitir a personas que fueron baneadas legítimamente antes del ataque. Usala solo si el ataque comprometió la lista completa de baneos. > **La ventana máxima es de 24 horas** > Los cambios de estructura y los baneos anteriores a la ventana no se pueden revertir con `/unnuke`. Si el ataque ocurrió hace más tiempo, usá `/backup load` o restaurá manualmente desde el registro de auditoría de Discord. ### Después de revertir - Revisá los permisos de los canales y roles restaurados. - Cambiá los tokens de bots e integraciones que puedan estar comprometidos. - Revisá los webhooks y eliminá los que no reconozcas. - Ejecutá `/estado` para confirmar que las protecciones siguen activas. - Documentá el ataque y las acciones tomadas para el equipo. # Referencia Índice de comandos, permisos y preguntas frecuentes. ## [Índice de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) Referencia completa de los 145 comandos y subcomandos de NearSecurity. NearSecurity expone 145 declaraciones de comandos agrupadas en 60 comandos raíz. Cada comando raíz tiene su propia página con el uso, las opciones, los permisos y las notas de sus subcomandos. El índice se genera a partir del inventario real del bot, por lo que refleja la versión documentada. - **Declaraciones:** 145 - **Comandos raíz:** 60 - **Categorías:** 5 - **Versión:** 3.0.0 > **Cómo leer la referencia** > Los comandos con subcomandos se agrupan en una sola página. Por ejemplo, `/ticket setup` y `/ticket done` se documentan dentro de `/ticket`. Las opciones obligatorias se muestran con `< >` y las opcionales con `[ ]`. ### Comandos de seguridad - [`/antiban`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antiban.md): Detiene baneos masivos ejecutados por cuentas comprometidas o roles mal configurados. - [`/antibot`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antibot.md): Controla qué bots pueden unirse al servidor y sanciona al invitador. - [`/antichannels`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antichannels.md): Frena la creación, eliminación y edición masiva de canales. - [`/anticlientapp`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/anticlientapp.md): Silencia cuentas comprometidas que spamean imágenes o scams de Steam en varios canales. - [`/antikick`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antikick.md): Detiene expulsiones masivas y sanciona al ejecutor. - [`/antilinks`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antilinks.md): Filtra enlaces no permitidos y permite definir dominios de confianza. - [`/antinsfw`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antinsfw.md): Elimina contenido explícito detectado en mensajes y archivos. - [`/antirole`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antirole.md): Protege contra la creación, eliminación y modificación masiva de roles. - [`/antiwebhookcreate`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antiwebhookcreate.md): Detecta la creación de webhooks maliciosos y sanciona al responsable. - [`/antiwebhookspam`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antiwebhookspam.md): Corta el uso excesivo de webhooks para enviar mensajes masivos. - [`/auditoria`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/auditoria.md): Consulta el historial de cambios de configuración hechos con comandos del bot. - [`/autoconfig`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/autoconfig.md): Activa una base recomendada de protecciones y prepara el canal de logs. - [`/estado`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/estado.md): Muestra un resumen paginado de toda la configuración de seguridad. - [`/ghostping`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/ghostping.md): Detecta menciones que se borran rápido para acosar sin dejar rastro. - [`/honeypot`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/honeypot.md): Configura un canal trampa que alerta al staff cuando alguien escribe en él. - [`/owneralerts`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/owneralerts.md): Envía alertas por mensaje directo al propietario cuando ocurre una intrusión crítica. - [`/panic`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/panic.md): Bloquea el envío de mensajes en todos los canales de texto durante una emergencia. - [`/securitylogs`](https://nearsecurity.citymoon.org/docs/comandos/seguridad/securitylogs.md): Consulta y limpia el historial de infracciones de seguridad. ### Comandos de moderación - [`/ban`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/ban.md): Banea a un miembro con motivo, duración y prueba opcional. - [`/historial`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/historial.md): Muestra las sanciones registradas de un usuario. - [`/kick`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/kick.md): Expulsa a un miembro con motivo y prueba opcional. - [`/massrole`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/massrole.md): Asigna un rol a todos los miembros del servidor. - [`/notas`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/notas.md): Guarda notas internas sobre miembros para el equipo de moderación. - [`/purge`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/purge.md): Elimina mensajes en masa con filtros por usuario o tipo de autor. - [`/reportar`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/reportar.md): Envía un reporte de un usuario malicioso al equipo de NearSecurity. - [`/temprole`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/temprole.md): Asigna un rol durante un tiempo limitado y lo retira automáticamente. - [`/timeout`](https://nearsecurity.citymoon.org/docs/comandos/moderacion/timeout.md): Silencia temporalmente a un miembro. ### Comandos de comunidad - [`/8ball`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/8ball.md): Responde una pregunta con la bola mágica 8. - [`/abrazo`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/abrazo.md): Envía un abrazo a otro miembro. - [`/afk`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/afk.md): Marca a un miembro como ausente con una razón opcional. - [`/ahorcado`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/ahorcado.md): Juega al ahorcado con diferentes niveles de dificultad. - [`/ajedrez`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/ajedrez.md): Juega partidas de ajedrez por turnos dentro de Discord. - [`/amor`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/amor.md): Calcula un porcentaje de compatibilidad entre dos miembros. - [`/beso`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/beso.md): Envía un beso a otro miembro. - [`/duelo`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/duelo.md): Reta a otro miembro a un duelo con una apuesta de XP. - [`/giveaway`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/giveaway.md): Crea y administra sorteos con requisitos y botones de participación. - [`/golpe`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/golpe.md): Da un golpe divertido a otro miembro. - [`/howgay`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/howgay.md): Genera un resultado humorístico sobre un miembro. - [`/invites`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/invites.md): Consulta quién invitó a cada miembro, cuántos siguen y cuántos salieron. - [`/nivel`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/nivel.md): Sistema de experiencia, niveles, rankings y personalización de perfiles. - [`/perfil`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/perfil.md): Muestra la tarjeta de perfil y el nivel de un miembro. - [`/recordatorio`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/recordatorio.md): Crea y administra recordatorios que se envían por mensaje directo. - [`/seguir`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/seguir.md): Notifica nuevas publicaciones de YouTube, Twitch o Kick en un canal. - [`/stats`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/stats.md): Genera un panel visual con las estadísticas de actividad del servidor. - [`/sugerir`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/sugerir.md): Publica una sugerencia en el canal configurado. - [`/ticket`](https://nearsecurity.citymoon.org/docs/comandos/comunidad/ticket.md): Sistema de tickets con panel, categorías, límites y transcripciones. ### Comandos de servidor y utilidades - [`/bot`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/bot.md): Muestra información del bot, su icono y el estado de la infraestructura. - [`/bugs`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/bugs.md): Reporta un bug del bot al equipo de desarrollo. - [`/channel`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/channel.md): Consulta información de canales y permite recrearlos con `/channel nuke`. - [`/decrypt`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/decrypt.md): Descifra un texto generado con `/encrypt` usando AES-256-GCM. - [`/empezar`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/empezar.md): Presenta NearSecurity y permite explorar sus módulos desde un menú interactivo. - [`/encrypt`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/encrypt.md): Cifra un mensaje con AES-256-GCM y una contraseña. - [`/filescan`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/filescan.md): Escanea archivos y URLs con VirusTotal. - [`/osint`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/osint.md): Reúne información pública de un usuario de Discord. - [`/server`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/server.md): Muestra información del servidor, su icono y su banner. - [`/setup`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/setup.md): Agrupa las configuraciones principales del servidor. - [`/traducir`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/traducir.md): Traduce texto usando Google Translate. - [`/user`](https://nearsecurity.citymoon.org/docs/comandos/utilidades/user.md): Muestra información de usuarios: avatar, banner, roles, permisos y datos generales. ### Comandos de respaldos - [`/backup`](https://nearsecurity.citymoon.org/docs/comandos/respaldos/backup.md): Crea y restaura respaldos personales de la estructura del servidor. - [`/unnuke`](https://nearsecurity.citymoon.org/docs/comandos/respaldos/unnuke.md): Revierte un ataque: elimina duplicados y restaura canales o roles borrados. > **Los permisos del servidor no son los permisos del bot** > Que un comando esté disponible no significa que el bot pueda ejecutarlo. NearSecurity también necesita los permisos de Discord correspondientes en el canal o en el servidor. Revisá la página de cada comando y la guía de permisos. ## [Permisos y niveles de acceso](https://nearsecurity.citymoon.org/docs/referencia/permisos) Matriz de permisos por comando y diferencia entre owner del servidor y administradores. Los comandos de NearSecurity combinan dos capas de autorización: los permisos de Discord del ejecutor y la propiedad del servidor. Si una capa falla, el comando se rechaza aunque la otra esté bien. ### Permisos de Discord | Comando | Permiso requerido | Alcance | | --- | --- | --- | | `/ban` | Banear miembros | Servidor. | | `/kick` | Expulsar miembros | Servidor. | | `/timeout` | Moderar miembros | Servidor. | | `/temprole` | Gestionar roles | Servidor. | | `/purge` | Gestionar mensajes | Canal. | | `/notas` | Gestionar mensajes | Servidor. | | `/historial` | Moderar miembros | Servidor. | | `/channel nuke` | Administrador | Servidor. | | `/estado` | Administrador | Servidor. | | `/backup` | Administrador | Servidor. | | `/setup` | Administrador | Servidor. | | `/ticket setup`, `/ticket setlimit`, `/ticket updatepanel` | Administrador | Servidor. | | `/nivel config`, `/nivel autorol`, `/nivel setlevelupchannel` | Administrador | Servidor. | | `/giveaway create`, `/giveaway edit`, `/giveaway end`, `/giveaway reroll` | Gestionar eventos | Servidor. | | `/filescan config`, `/filescan scan`, `/filescan scanurl` | Gestionar mensajes | Servidor. | > **Los permisos del canal también cuentan** > Un moderador con `Gestionar mensajes` no puede purgar en un canal donde no tiene acceso. El bot tampoco puede actuar en un canal donde no puede ver mensajes o borrarlos. ### Solo el propietario del servidor Estas acciones están reservadas al propietario del servidor aunque otro miembro tenga `Administrador`. La comprobación se hace contra el owner real del servidor, no contra un rol. - `/panic` — Modo Pánico. - `/autoconfig` — Configuración automática de protecciones. - `/massrole` — Asignación masiva de un rol. - `/unnuke` — Reversión de ataques. - `/antibot` — Configuración del filtro de bots. - `/owneralerts` — Alertas por MD al fundador. - `/antiban`, `/antikick`, `/antichannels`, `/antirole`, `/antinsfw`, `/antiwebhookcreate`, `/antiwebhookspam` — Activación y sanción de protecciones. - `/antilinks toggle`, `/antilinks config`, `/antilinks whitelist` — Filtro de enlaces y dominios. - `/setup whitelist` — Agregar o quitar usuarios y roles inmunes. ### Administrador Estos comandos aceptan `Administrador` o, en algunos casos, al propietario del servidor como alternativa. No están disponibles para moderadores sin ese permiso. - `/anticlientapp` y `/ghostping` — Activación de esas protecciones. - `/setup` y sus subcomandos de configuración. - `/ticket setup`, `/ticket setlimit` y `/ticket updatepanel`. - `/nivel config`, `/nivel autorol` y `/nivel setlevelupchannel`. - `/channel nuke`, `/estado` y `/backup`. > **La jerarquía manda** > Para banear, expulsar, aplicar timeout o asignar roles, el rol más alto del bot debe estar por encima del rol más alto del objetivo. Si el bot está por debajo, el comando falla aunque el ejecutor tenga el permiso. ## [Preguntas frecuentes](https://nearsecurity.citymoon.org/docs/referencia/preguntas) Respuestas a los problemas más comunes de configuración, permisos y funcionamiento. Esta sección reúne las dudas que aparecen con más frecuencia al instalar y configurar NearSecurity. Si el problema no está aquí, revisá la guía del módulo correspondiente o abrí un reporte con `/bugs`. #### El bot no responde a los comandos Verificá que el bot esté en línea, que los comandos slash estén sincronizados y que tenga `Usar comandos de aplicación` en el canal. Si el bot acaba de entrar, la sincronización puede tardar unos minutos. También revisá que el canal no esté bloqueado por el Modo Pánico. #### No veo los comandos slash en Discord Los comandos globales pueden tardar en propagarse. Cerrá y abrí Discord, cambiá de servidor y volvé, o esperá unos minutos. Si el problema persiste, expulsá y volvé a invitar al bot con los scopes `bot` y `applications.commands`. #### El dashboard no guarda los cambios El autoguardado está desactivado por defecto. Después de modificar una opción, usá **Guardar cambios**. El aviso **Tenés cambios sin guardar** indica que todavía hay diferencias pendientes. Si el guardado falla, revisá que tu sesión siga activa y que tengas permisos de administración en el servidor. #### La bienvenida no se envía El sistema se configura solo desde el dashboard. Revisá que esté activado, que el canal exista y que el bot pueda verlo y escribir en él. Las variables se reemplazan al momento del ingreso; si usás una variable con un error de escritura, se envía vacía. #### ¿Qué es Anti-ClientApp? Es una protección contra cuentas comprometidas que spamean imágenes o GIFs en varios canales y mensajes con falsos sorteos de Steam. Aplica un timeout de 7 días, borra los mensajes recientes, avisa por MD y registra el caso. No es un antivirus ni banea automáticamente. Está explicado en detalle en la guía de Anti-ClientApp. #### ¿Cuál es la diferencia entre Modo Pánico y las protecciones anti-raid? Las protecciones anti-raid reaccionan a acciones concretas y sancionan al ejecutor. El Modo Pánico bloquea el servidor completo durante una emergencia y se revierte al vencer la duración. El primero es preventivo y selectivo; el segundo es una contención temporal. #### El bot no puede banear o expulsar Revisá tres cosas: que el bot tenga el permiso correspondiente, que su rol esté por encima del rol del objetivo y que el objetivo no sea el propietario del servidor. NearSecurity tampoco puede sancionarse a sí mismo ni a un miembro con un rol igual o superior al suyo. #### El usuario sancionado no recibió el MD El mensaje directo falla si el usuario tiene los MD cerrados, si bloqueó al bot o si la cuenta ya no comparte servidor. La sanción se aplica igual y queda registrada. El MD es un aviso, no un requisito para que la sanción sea válida. #### ¿Cómo restauro un backup sin borrar todo? Usá `/backup load` y elegí **Restaurar solo lo faltante**. Ese modo crea los roles y canales que no existan y no toca los actuales. La restauración completa elimina la estructura actual y solo debería usarse en un servidor de prueba o en una recuperación total. #### El ticket no genera la transcripción La transcripción se envía al canal de logs configurado en `/ticket setup`. Si no hay canal de logs, o el bot no puede escribir en él, el archivo no se publica. Revisá la configuración y los permisos del canal antes de cerrar el próximo ticket. #### ¿Cómo reporto un bug o un problema de seguridad? Usá `/bugs` para errores del bot y `/reportar` para reportar un usuario malicioso al staff. Incluí pasos para reproducir el problema, el servidor y el canal. No incluyas tokens, contraseñas ni datos personales innecesarios. #### ¿NearSecurity es gratuito? Sí. El bot y el dashboard son gratuitos. Algunas funciones dependen de servicios externos, como VirusTotal, Google Translate o las API de YouTube, Twitch y Kick, que pueden tener sus propios límites o condiciones. > **Antes de abrir un reporte** > Revisá la guía del módulo, los permisos del bot y el canal de logs. Muchos problemas de configuración se resuelven verificando esos tres puntos. Si el problema persiste, adjuntá el comando usado y el mensaje de error exacto. # Equipo Quién desarrolla NearSecurity y cómo se mantiene el proyecto. ## [Equipo y proyecto](https://nearsecurity.citymoon.org/docs/staff/equipo) NearSecurity es desarrollado y mantenido por Citymoon Dynamics. Conocé cómo se organiza el proyecto, qué tecnología usa y cómo se mantiene. NearSecurity es un proyecto de [Citymoon Dynamics](https://citymoon.org), un estudio independiente de software enfocado en herramientas para comunidades digitales. El bot, el dashboard, la infraestructura y esta documentación se desarrollan y mantienen desde ese equipo. - **Proyecto:** NearSecurity - **Desarrollo:** Citymoon Dynamics - **Producto:** Bot de moderación y seguridad para Discord con dashboard web. - **Estado:** Activo y gratuito. ### Qué hace el equipo - **Desarrollo del bot:** protecciones anti-raid, moderación, comunidad, tickets, respaldos y utilidades. - **Dashboard:** configuración web, permisos, diagnóstico y publicación de paneles. - **Infraestructura:** MongoDB, respaldos, despliegues y monitoreo del servicio. - **Documentación:** guías, referencia de comandos y páginas de ayuda generadas desde el inventario real del bot. - **Soporte:** servidor de Discord, centro de reportes y seguimiento de incidentes. ### Cómo se construye El bot está escrito en TypeScript sobre Node.js y Seyfert. El dashboard usa Vue 3, Vite y Tailwind CSS. La persistencia corre sobre MongoDB y el sitio se despliega en Vercel. La documentación se versiona junto al código para que los comandos y las guías no queden desactualizados. - TypeScript y Node.js para el bot y la API. - Vue 3, Vite y Tailwind CSS para el panel. - MongoDB para configuración, respaldos y registros. - Documentación generada desde el inventario de comandos. > **Código privado** > El código del bot es privado. Publicamos documentación y reportes, pero no pedimos tokens, contraseñas ni credenciales de Discord. ### Filosofía NearSecurity es gratuito y sin planes pagos. La idea es que las funciones de seguridad estén disponibles para cualquier comunidad, sin depender de su tamaño o presupuesto. Priorizamos una configuración clara, cambios pequeños y verificables, y documentación que explique el comportamiento real del bot. - Sin funciones bloqueadas detrás de un pago. - Configuración desde el dashboard, sin depender de comandos. - Cambios acotados y comprobables en cada versión. - Documentación tratada como parte del producto. ### Soporte y comunidad El equipo atiende dudas, errores y pedidos de funciones desde el servidor de Discord y el centro de reportes. Las respuestas y los tiempos dependen de la disponibilidad del equipo, pero los incidentes de seguridad tienen prioridad. - **[Servidor de Discord](https://discord.gg/SPRBHdwS):** Soporte, anuncios y conversación con la comunidad. - **[Reportes](https://nearsecurity.citymoon.org/issues):** Errores, sugerencias y seguimiento de casos. - **[Contacto](https://nearsecurity.citymoon.org/contact):** Consultas sobre el proyecto y temas de seguridad. - **[Documentación](https://nearsecurity.citymoon.org/docs/empezar/introduccion.md):** Guías y referencia de todos los comandos. ### Créditos Gracias a las comunidades que prueban cada versión, reportan errores y proponen mejoras. NearSecurity existe gracias a ese uso real. El nombre y el logo del proyecto forman parte de Citymoon Dynamics. > **¿Querés colaborar?** > Si encontrás un error o tenés una idea, abrí un reporte con el mayor detalle posible. Los reportes con pasos de reproducción y capturas se resuelven más rápido. # Comandos de seguridad Referencia de comandos de seguridad. ## [/antiban](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antiban) Detiene baneos masivos ejecutados por cuentas comprometidas o roles mal configurados. Cuando alguien banea a varios miembros en poco tiempo, NearSecurity consulta el registro de auditoría, identifica al ejecutor y le aplica la sanción configurada: ban o expulsión. La protección se puede activar desde el dashboard o con el comando. La sanción se elige en **Seguridad → Anti-Ban → Sanción a aplicar**. > **Permisos** > Solo el propietario del servidor puede activarlo. El bot necesita `Ver registro de auditoría` y el permiso de la sanción elegida. ### Uso ``` /antiban ``` ### Notas - El propietario del servidor, el propio bot y los usuarios o roles inmunes quedan excluidos. - Si el bot no tiene `Ver registro de auditoría`, no puede identificar al ejecutor y la protección pierde eficacia. ### Ejemplo ``` /antiban ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/antibot](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antibot) Controla qué bots pueden unirse al servidor y sanciona al invitador. Tiene tres modos: desactivado, solo bots no verificados y todos los bots. La sanción puede ser ban o expulsión. Cuando un bot no permitido entra, NearSecurity intenta identificar a quien lo invitó mediante el registro de auditoría y también lo sanciona. > **Permisos** > Solo el propietario del servidor puede cambiar la configuración. ### Uso ``` /antibot ``` ### Notas - El modo **Todos los bots** puede bloquear integraciones legítimas. Usalo solo si tenés un flujo controlado de altas. - El propietario, el propio bot y los usuarios inmunes no son sancionados. ### Ejemplo ``` /antibot ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/antichannels](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antichannels) Frena la creación, eliminación y edición masiva de canales. Vigila los cambios de canales y actúa cuando detecta actividad compatible con un ataque. Es una de las protecciones que conviene mantener activa incluso en servidores pequeños. > **Permisos** > Solo el propietario del servidor puede activarlo. El bot necesita `Gestionar canales` y `Ver registro de auditoría` para revertir y sancionar. ### Uso ``` /antichannels ``` ### Notas - Revisá los permisos del bot después de reorganizar categorías o canales para evitar falsos positivos. ### Ejemplo ``` /antichannels ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/anticlientapp](https://nearsecurity.citymoon.org/docs/comandos/seguridad/anticlientapp) Silencia cuentas comprometidas que spamean imágenes o scams de Steam en varios canales. No es el cliente oficial de Discord. El nombre se usa para identificar el patrón de cuentas infectadas por software malicioso que publica imágenes y GIFs de forma masiva. El interruptor **Seguridad → Anti-ClientApp** del dashboard y el comando `/anticlientapp` modifican el mismo ajuste del servidor. Detecta spam de imágenes o GIFs en tres o más canales distintos, además de mensajes con patrones de falsos sorteos o estafas de Steam. Aplica un timeout de 7 días, borra los mensajes recientes del usuario, le envía un MD y registra el caso en el canal de moderación y en los logs. > **Permisos** > Requiere `Administrador` para activarlo con el comando; también se activa desde el dashboard. ### Uso ``` /anticlientapp ``` ### Notas - No reemplaza un antivirus ni protege las cuentas de tus miembros fuera del servidor. - El sistema no banea: aplica timeout y conserva el historial para que el equipo revise el caso. - El umbral principal es la actividad multimedia en tres o más canales, no un antivirus sobre el contenido de cada archivo. ### Ejemplo ``` /anticlientapp ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/antikick](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antikick) Detiene expulsiones masivas y sanciona al ejecutor. Funciona igual que Anti-Ban, pero observa eventos de expulsión. La sanción puede ser ban o expulsión y se configura desde el dashboard. > **Permisos** > Solo el propietario del servidor puede activarlo. El bot necesita `Ver registro de auditoría` y el permiso de la sanción elegida. ### Uso ``` /antikick ``` ### Notas - Los usuarios y roles inmunes no son sancionados por esta protección. ### Ejemplo ``` /antikick ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/antilinks](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antilinks) Filtra enlaces no permitidos y permite definir dominios de confianza. El filtro analiza los enlaces de cada mensaje, aplica la lista blanca de dominios y puede eliminar o sancionar según la configuración. También permite limitar la cantidad de enlaces por mensaje y activar un modo estricto. La configuración avanzada y la lista blanca están reservadas al propietario del servidor. > **Permisos** > `/antilinks toggle`, `/antilinks config` y `/antilinks whitelist` requieren ser propietario del servidor. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/antilinks config](#cmd-antilinks-config) | Configura opciones avanzadas del anti-links | | [/antilinks toggle](#cmd-antilinks-toggle) | Activa o desactiva el sistema anti-links | | [/antilinks whitelist](#cmd-antilinks-whitelist) | Gestiona la lista blanca de dominios permitidos | #### /antilinks config Configura opciones avanzadas del anti-links Permite habilitar o deshabilitar enlaces de Discord, imágenes y videos, y activar el modo estricto. ``` /antilinks config ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | opcion | Texto | Sí | Opción a configurar Valores: `discord`, `images`, `videos`, `strict`. | | valor | Booleano | Sí | Valor para la opción | > **Permisos** > Solo el propietario del servidor. #### /antilinks toggle Activa o desactiva el sistema anti-links Activa o desactiva el filtro de enlaces. La configuración avanzada y la whitelist se gestionan por separado. ``` /antilinks toggle ``` #### /antilinks whitelist Gestiona la lista blanca de dominios permitidos Agrega, elimina o lista dominios permitidos. La lista admite hasta 100 dominios. ``` /antilinks whitelist [dominio] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | accion | Texto | Sí | Acción a realizar Valores: `add`, `remove`, `list`. | | dominio | Texto | No | Dominio a añadir/eliminar (ej: youtube.com) | > **Permisos** > Solo el propietario del servidor. ### Notas - La lista inicial incluye dominios habituales como YouTube, Discord, GitHub, Stack Overflow, Imgur, Giphy y Tenor. - Un dominio permitido no exime al mensaje del resto de los filtros. ### Ejemplo ``` /antilinks ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/antinsfw](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antinsfw) Elimina contenido explícito detectado en mensajes y archivos. El filtro actúa sobre el contenido de los mensajes y los adjuntos. Está pensado como una barrera automática, no como un reemplazo de la revisión humana. > **Permisos** > Solo el propietario del servidor puede activarlo. El bot necesita `Gestionar mensajes`. ### Uso ``` /antinsfw ``` ### Notas - Podés combinar el filtro con el canal de moderación para revisar cada eliminación. ### Ejemplo ``` /antinsfw ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/antirole](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antirole) Protege contra la creación, eliminación y modificación masiva de roles. La sanción al ejecutor se configura desde el dashboard y puede ser ban o expulsión. Los cambios hechos por el propio bot o por miembros inmunes se ignoran. > **Permisos** > Solo el propietario del servidor puede activarlo. El bot necesita `Gestionar roles` y `Ver registro de auditoría`. ### Uso ``` /antirole ``` ### Notas - Los roles administrados por integraciones no se recrean automáticamente. ### Ejemplo ``` /antirole ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/antiwebhookcreate](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antiwebhookcreate) Detecta la creación de webhooks maliciosos y sanciona al responsable. Los atacantes usan webhooks para enviar spam sin depender de una cuenta. NearSecurity revisa la creación de webhooks y aplica la sanción configurada. > **Permisos** > Solo el propietario del servidor puede activarlo. El bot necesita `Gestionar webhooks` y `Ver registro de auditoría`. ### Uso ``` /antiwebhookcreate ``` ### Notas - Rotá o eliminá webhooks desconocidos si el ataque ya ocurrió. ### Ejemplo ``` /antiwebhookcreate ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/antiwebhookspam](https://nearsecurity.citymoon.org/docs/comandos/seguridad/antiwebhookspam) Corta el uso excesivo de webhooks para enviar mensajes masivos. Complementa a Anti-Webhook Create. Mientras una protección controla la creación, esta vigila el volumen de mensajes enviados por webhooks. > **Permisos** > Solo el propietario del servidor puede activarlo. El bot necesita `Gestionar webhooks` y `Gestionar mensajes`. ### Uso ``` /antiwebhookspam ``` ### Notas - Si usás integraciones legítimas con webhooks, revisá su frecuencia antes de activarlo. ### Ejemplo ``` /antiwebhookspam ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/auditoria](https://nearsecurity.citymoon.org/docs/comandos/seguridad/auditoria) Consulta el historial de cambios de configuración hechos con comandos del bot. Registra quién cambió qué, cuándo y los valores anteriores y nuevos. Se puede filtrar por categoría, usuario y cantidad de registros. Solo guarda cambios aplicados mediante comandos del bot. Las modificaciones directas en MongoDB o en el dashboard no aparecen en este historial. > **Permisos** > Solo el propietario del servidor o un miembro con `Administrador`. ### Uso ``` /auditoria [categoria] [usuario] [limite] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | categoria | Texto | No | Filtrar por categoría Valores: `toggles`, `logs`, `whitelist`, `antilinks`, `badwords`, `antibot`, `panic`, `securitylogs`, `blacklist`, `autoroles`, `sugerencias`, `backups`. | | usuario | Usuario | No | Filtrar por el usuario que hizo el cambio | | limite | Entero (1–20) | No | Cantidad de registros a mostrar (1-20) | ### Ejemplo ``` /auditoria ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/autoconfig](https://nearsecurity.citymoon.org/docs/comandos/seguridad/autoconfig) Activa una base recomendada de protecciones y prepara el canal de logs. Activa Anti-Ban, Anti-Kick, Anti-Bot en modo **todos**, Anti-NSFW, Anti-Links, Anti-Role, Anti-Webhook Create, Anti-Webhook Spam, Anti-Badwords y detección de Ghost Ping. También activa los logs y crea el canal `server-logs` si no existe. No activa Anti-ClientApp, no configura bienvenidas y no reemplaza una revisión manual de las listas blancas. > **Permisos** > Solo el propietario del servidor. ### Uso ``` /autoconfig ``` ### Notas - Revisá el resultado y ajustá las protecciones que no se adapten a tu comunidad. ### Ejemplo ``` /autoconfig ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/estado](https://nearsecurity.citymoon.org/docs/comandos/seguridad/estado) Muestra un resumen paginado de toda la configuración de seguridad. El resumen incluye protecciones, sanciones, logs, filtros, listas blancas, eventos de registro y el estado de Anti-ClientApp. Es útil para auditar el servidor después de un cambio. > **Permisos** > Requiere `Administrador`. ### Uso ``` /estado ``` ### Notas - Se muestra en un mensaje efímero con botones para navegar entre las seis páginas. ### Ejemplo ``` /estado ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/ghostping](https://nearsecurity.citymoon.org/docs/comandos/seguridad/ghostping) Detecta menciones que se borran rápido para acosar sin dejar rastro. Cuando alguien menciona a un usuario y elimina el mensaje casi inmediatamente, NearSecurity conserva la evidencia y expone la acción en el canal de moderación. > **Permisos** > Requiere `Administrador` para activarlo con el comando; también se activa desde el dashboard. El bot necesita `Gestionar mensajes`. ### Uso ``` /ghostping ``` ### Notas - Está activado por defecto en las configuraciones nuevas. ### Ejemplo ``` /ghostping ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/honeypot](https://nearsecurity.citymoon.org/docs/comandos/seguridad/honeypot) Configura un canal trampa que alerta al staff cuando alguien escribe en él. El honeypot vigila un canal de texto. Cualquier miembro no autorizado que escriba allí genera una alerta y, en modo sancionar, recibe un timeout y su mensaje se elimina. La duración se indica en formato corto: `30m`, `7h`, `3d`, `2w` o combinaciones como `1d 12h`. El máximo es `4w` (28 días). Los bots, el propietario del servidor, el staff fijo, los usuarios y roles de la lista blanca y quienes tengan `Administrador` o `Gestionar servidor` son inmunes. > **Permisos** > Solo el propietario del servidor o un miembro con `Administrador`. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/honeypot config](#cmd-honeypot-config) | Configura y activa el honeypot del servidor | | [/honeypot desactivar](#cmd-honeypot-desactivar) | Desactiva el honeypot del servidor | | [/honeypot estado](#cmd-honeypot-estado) | Muestra el estado actual del honeypot | #### /honeypot config Configura y activa el honeypot del servidor ``` /honeypot config [modo] [duracion] [alertas] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | canal | Canal | Sí | Canal trampa donde se detectarán los mensajes | | modo | Texto | No | Acción a aplicar cuando alguien escriba en el canal trampa Valores: `alertar`, `sancionar`. | | duracion | Texto | No | Duración del timeout en modo sancionar (ej: 30m, 7h, 3d, 2w) | | alertas | Canal | No | Canal donde enviar las alertas (opcional) | #### /honeypot desactivar Desactiva el honeypot del servidor ``` /honeypot desactivar ``` #### /honeypot estado Muestra el estado actual del honeypot ``` /honeypot estado ``` ### Notas - El bot necesita `Gestionar mensajes` para borrar el mensaje y `Moderar miembros` para aplicar el timeout. - Si el canal trampa se elimina, el honeypot se desactiva automáticamente y avisa por el canal de alertas. ### Ejemplo ``` /honeypot ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/owneralerts](https://nearsecurity.citymoon.org/docs/comandos/seguridad/owneralerts) Envía alertas por mensaje directo al propietario cuando ocurre una intrusión crítica. Las alertas se envían al propietario del servidor. El comando permite activarlas o desactivarlas y está reservado a esa persona. > **Permisos** > Solo el propietario del servidor. ### Uso ``` /owneralerts ``` ### Notas - El propietario debe tener los MD abiertos para recibirlas. ### Ejemplo ``` /owneralerts ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/panic](https://nearsecurity.citymoon.org/docs/comandos/seguridad/panic) Bloquea el envío de mensajes en todos los canales de texto durante una emergencia. El Modo Pánico se activa con doble confirmación, guarda una instantánea de los permisos y se revierte automáticamente al vencer la duración elegida. También impide el ingreso de nuevas cuentas no autorizadas. Está pensado para ataques en curso, no para uso permanente. > **Permisos** > Solo el propietario del servidor. ### Uso ``` /panic [duracion] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | duracion | Texto | No | Duración antes de desactivar el modo pánico automáticamente Valores: `1h`, `6h`, `12h`, `24h`. | ### Notas - Requiere `Gestionar canales`. Si el bot no puede editar un canal, se informa el error y el modo puede quedar activo para reintentar. - El dashboard muestra el estado y la fecha de expiración, pero la activación se hace desde Discord. ### Ejemplo ``` /panic ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/securitylogs](https://nearsecurity.citymoon.org/docs/comandos/seguridad/securitylogs) Consulta y limpia el historial de infracciones de seguridad. Permite ver las violaciones de un usuario, las estadísticas del servidor y limpiar registros por usuario o tipo. El historial guarda metadatos como tipo, severidad, fecha y canal, no el contenido completo de los mensajes. > **Permisos** > Requiere `Gestionar mensajes`. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/securitylogs limpiar](#cmd-securitylogs-limpiar) | Limpiar historial de violaciones | | [/securitylogs servidor](#cmd-securitylogs-servidor) | Ver estadísticas de violaciones del servidor | | [/securitylogs usuario](#cmd-securitylogs-usuario) | Ver historial de violaciones de un usuario específico | #### /securitylogs limpiar Limpiar historial de violaciones Elimina registros del historial de violaciones. Podés filtrar por usuario y por tipo de infracción. ``` /securitylogs limpiar [usuario] [tipo] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | Usuario específico (opcional) | | tipo | Texto | No | Tipo de violación a limpiar Valores: `all`, `SPAM`, `LINK`, `NSFW`, `BADWORD`, `TOXIC`. | > **Permisos** > Requiere `Gestionar mensajes`. #### /securitylogs servidor Ver estadísticas de violaciones del servidor Resume el total de violaciones, las de los últimos siete días, los tipos, las severidades y los usuarios con más registros. ``` /securitylogs servidor ``` > **Permisos** > Requiere `Gestionar mensajes`. #### /securitylogs usuario Ver historial de violaciones de un usuario específico Muestra las violaciones agrupadas por tipo, con severidad y fecha. ``` /securitylogs usuario ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario del cual ver el historial | > **Permisos** > Requiere `Gestionar mensajes`. ### Notas - Limpiar el historial no revierte sanciones ni elimina mensajes de Discord. ### Ejemplo ``` /securitylogs ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/seguridad/protecciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) # Comandos de moderación Referencia de comandos de moderación. ## [/ban](https://nearsecurity.citymoon.org/docs/comandos/moderacion/ban) Banea a un miembro con motivo, duración y prueba opcional. El comando abre un formulario para indicar razón, duración y prueba. La duración acepta formatos como `10m`, `1h`, `7d` o `perma`; si es temporal, el bot programa el desbaneo. Antes de ejecutar, verifica la jerarquía de roles y que el objetivo no sea el propietario ni el propio bot. > **Permisos** > Requiere `Banear miembros`. ### Uso ``` /ban ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a banear | ### Notas - La sanción se registra en el historial y en el canal de moderación si está configurado. ### Ejemplo ``` /ban @usuario ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/historial](https://nearsecurity.citymoon.org/docs/comandos/moderacion/historial) Muestra las sanciones registradas de un usuario. Podés consultar el historial de cualquier miembro e indicar un límite de resultados. Incluye bans, kicks, timeouts y otras sanciones registradas por el bot. > **Permisos** > Requiere `Moderar miembros`. ### Uso ``` /historial [usuario] [limit] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | Usuario a consultar | | limit | Entero (1–10) | No | Cantidad de casos a mostrar (máx 10) | ### Notas - El historial no incluye sanciones aplicadas manualmente desde Discord. ### Ejemplo ``` /historial ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/kick](https://nearsecurity.citymoon.org/docs/comandos/moderacion/kick) Expulsa a un miembro con motivo y prueba opcional. Abre un formulario de confirmación, verifica la jerarquía y envía la sanción al historial y al modlog. > **Permisos** > Requiere `Expulsar miembros`. ### Uso ``` /kick ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a expulsar | ### Notas - La expulsión no impide que el usuario vuelva a entrar. ### Ejemplo ``` /kick @usuario ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/massrole](https://nearsecurity.citymoon.org/docs/comandos/moderacion/massrole) Asigna un rol a todos los miembros del servidor. Es una operación de alto impacto. Se recomienda usarla solo en servidores pequeños o con un rol que no otorgue permisos sensibles. > **Permisos** > Solo el propietario del servidor. ### Uso ``` /massrole ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | rol | Rol | Sí | El rol que deseas asignar. | ### Notas - Puede tardar varios minutos y consume el límite de peticiones de Discord. ### Ejemplo ``` /massrole @rol ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/notas](https://nearsecurity.citymoon.org/docs/comandos/moderacion/notas) Guarda notas internas sobre miembros para el equipo de moderación. Las notas se guardan por usuario y son visibles solo para quienes tienen permisos de moderación. Se pueden añadir, listar y eliminar por número. > **Permisos** > Requiere `Gestionar mensajes`. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/notas añadir](#cmd-notas-anadir) | Añadir una nota a un usuario | | [/notas eliminar](#cmd-notas-eliminar) | Eliminar una nota de un usuario por número | | [/notas ver](#cmd-notas-ver) | Ver notas de un usuario | #### /notas añadir Añadir una nota a un usuario Agrega una nota interna al usuario indicado. Las notas se numeran por usuario. ``` /notas añadir ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a añadir nota | | nota | Texto | Sí | Contenido de la nota | > **Permisos** > Requiere `Gestionar mensajes`. #### /notas eliminar Eliminar una nota de un usuario por número Elimina una nota por su número dentro de la lista del usuario. ``` /notas eliminar ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a eliminar nota | | numero | Entero (mín. 1) | Sí | Número de la nota a eliminar (1 en adelante) | > **Permisos** > Requiere `Gestionar mensajes`. #### /notas ver Ver notas de un usuario Muestra todas las notas guardadas para un usuario. ``` /notas ver ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a ver notas | > **Permisos** > Requiere `Gestionar mensajes`. ### Notas - Las notas no se envían al miembro ni se publican en el servidor. ### Ejemplo ``` /notas ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/purge](https://nearsecurity.citymoon.org/docs/comandos/moderacion/purge) Elimina mensajes en masa con filtros por usuario o tipo de autor. Permite borrar entre 1 y 100 mensajes. Podés limitar la limpieza a un usuario, a bots o a usuarios humanos. > **Permisos** > Requiere `Gestionar mensajes`. ### Uso ``` /purge [usuario] [solo_bots] [solo_usuarios] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | cantidad | Entero (1–100) | Sí | Cantidad de mensajes a eliminar (1-100) | | usuario | Usuario | No | Eliminar solo mensajes de este usuario | | solo_bots | Booleano | No | Eliminar solo mensajes de bots | | solo_usuarios | Booleano | No | Eliminar solo mensajes de usuarios (no bots) | ### Notas - Discord no permite borrar mensajes de más de 14 días con este método. ### Ejemplo ``` /purge 10 ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/reportar](https://nearsecurity.citymoon.org/docs/comandos/moderacion/reportar) Envía un reporte de un usuario malicioso al equipo de NearSecurity. El formulario pide ID, nombre, razón y prueba. El reporte se envía al staff mediante un webhook y tiene un límite de un envío por minuto por usuario. ### Uso ``` /reportar ``` ### Notas - La prueba debe ser una URL `https` si incluye enlaces. ### Ejemplo ``` /reportar ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/temprole](https://nearsecurity.citymoon.org/docs/comandos/moderacion/temprole) Asigna un rol durante un tiempo limitado y lo retira automáticamente. Indicá usuario, rol, tiempo y razón. El bot programa la retirada del rol al vencer el plazo. > **Permisos** > Requiere `Gestionar roles` y que el rol del bot esté por encima del rol asignado. ### Uso ``` /temprole [razon] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario al que asignar el rol | | rol | Rol | Sí | Rol a asignar temporalmente | | tiempo | Texto | Sí | Duración del rol (ej: 10m, 1h, 2d) | | razon | Texto | No | Razón por la que se asigna el rol | ### Notas - Si el miembro sale del servidor antes del vencimiento, la tarea puede no encontrar el rol. ### Ejemplo ``` /temprole @usuario @rol ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/timeout](https://nearsecurity.citymoon.org/docs/comandos/moderacion/timeout) Silencia temporalmente a un miembro. Solicita razón, duración y prueba. La duración predeterminada es `10m` y se aceptan formatos como `1h` o `7d`. > **Permisos** > Requiere `Moderar miembros`. ### Uso ``` /timeout ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a silenciar | ### Notas - El timeout no borra mensajes; combiná con `/purge` si hace falta. ### Ejemplo ``` /timeout @usuario ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/moderacion/sanciones) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) # Comandos de comunidad Referencia de comandos de comunidad. ## [/8ball](https://nearsecurity.citymoon.org/docs/comandos/comunidad/8ball) Responde una pregunta con la bola mágica 8. ### Uso ``` /8ball ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | pregunta | Texto | Sí | Tu pregunta para la bola 8 | ### Ejemplo ``` /8ball ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/abrazo](https://nearsecurity.citymoon.org/docs/comandos/comunidad/abrazo) Envía un abrazo a otro miembro. ### Uso ``` /abrazo ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | El usuario al que quieres abrazar | ### Ejemplo ``` /abrazo @usuario ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/afk](https://nearsecurity.citymoon.org/docs/comandos/comunidad/afk) Marca a un miembro como ausente con una razón opcional. El estado AFK se muestra cuando otros usuarios mencionan al miembro y se retira al volver a interactuar. ### Uso ``` /afk [razon] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | razon | Texto | No | Razón de tu AFK | ### Ejemplo ``` /afk ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/ahorcado](https://nearsecurity.citymoon.org/docs/comandos/comunidad/ahorcado) Juega al ahorcado con diferentes niveles de dificultad. El juego se desarrolla en el canal donde se ejecuta el comando y tiene una lista amplia de palabras. ### Uso ``` /ahorcado ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | dificultad | Texto | Sí | Selecciona la dificultad del juego Valores: `facil`, `medio`, `dificil`, `aleatoria`. | ### Ejemplo ``` /ahorcado ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/ajedrez](https://nearsecurity.citymoon.org/docs/comandos/comunidad/ajedrez) Juega partidas de ajedrez por turnos dentro de Discord. Permite retar a otro miembro, ver el tablero, mover piezas, consultar el estado de la partida y rendirse. Las posiciones se indican en notación algebraica, por ejemplo `e2` a `e4`. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/ajedrez estado](#cmd-ajedrez-estado) | Ver información de tu partida activa | | [/ajedrez mover](#cmd-ajedrez-mover) | Hacer un movimiento en tu partida activa | | [/ajedrez rendirse](#cmd-ajedrez-rendirse) | Rendirse en tu partida activa | | [/ajedrez retar](#cmd-ajedrez-retar) | Reta a otro jugador a una partida de ajedrez | | [/ajedrez tablero](#cmd-ajedrez-tablero) | Ver el estado actual del tablero | #### /ajedrez estado Ver información de tu partida activa ``` /ajedrez estado ``` #### /ajedrez mover Hacer un movimiento en tu partida activa Usa coordenadas algebraicas para indicar el origen y el destino, por ejemplo `e2` y `e4`. La promoción se indica solo cuando corresponde. ``` /ajedrez mover [promocion] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | desde | Texto | Sí | Posición inicial de la pieza (ej: e2) | | hasta | Texto | Sí | Posición final de la pieza (ej: e4) | | promocion | Texto | No | Pieza para promocionar un peón (por defecto dama) Valores: `q`, `r`, `b`, `n`. | #### /ajedrez rendirse Rendirse en tu partida activa ``` /ajedrez rendirse ``` #### /ajedrez retar Reta a otro jugador a una partida de ajedrez Envía una invitación al oponente. La partida comienza cuando el otro jugador acepta. ``` /ajedrez retar ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | oponente | Usuario | Sí | El jugador al que quieres retar | #### /ajedrez tablero Ver el estado actual del tablero ``` /ajedrez tablero ``` ### Ejemplo ``` /ajedrez ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/amor](https://nearsecurity.citymoon.org/docs/comandos/comunidad/amor) Calcula un porcentaje de compatibilidad entre dos miembros. ### Uso ``` /amor ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario1 | Usuario | Sí | Primer usuario | | usuario2 | Usuario | Sí | Segundo usuario | ### Ejemplo ``` /amor @usuario @usuario ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/beso](https://nearsecurity.citymoon.org/docs/comandos/comunidad/beso) Envía un beso a otro miembro. ### Uso ``` /beso ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | El usuario al que quieres besar | ### Ejemplo ``` /beso @usuario ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/duelo](https://nearsecurity.citymoon.org/docs/comandos/comunidad/duelo) Reta a otro miembro a un duelo con una apuesta de XP. El resultado se resuelve con el sistema de niveles. No se puede apostar más XP de la disponible. ### Uso ``` /duelo ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a retar | | cantidad | Entero (mín. 1) | Sí | Cantidad de XP a apostar | ### Ejemplo ``` /duelo @usuario 10 ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/giveaway](https://nearsecurity.citymoon.org/docs/comandos/comunidad/giveaway) Crea y administra sorteos con requisitos y botones de participación. Permite crear sorteos con premio, duración, cantidad de ganadores, canal y requisitos opcionales: rol, boosters, edad mínima de cuenta, tiempo mínimo en el servidor, imagen y lista privada de participantes. Los sorteos se finalizan automáticamente, pero también se pueden editar, terminar o volver a sortear manualmente. > **Permisos** > Crear, editar, terminar y rerollear requiere `Gestionar eventos`. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/giveaway create](#cmd-giveaway-create) | Crear un nuevo sorteo | | [/giveaway edit](#cmd-giveaway-edit) | Editar un sorteo activo | | [/giveaway end](#cmd-giveaway-end) | Finalizar un sorteo manualmente | | [/giveaway list](#cmd-giveaway-list) | Ver sorteos activos | | [/giveaway participants](#cmd-giveaway-participants) | Ver participantes de un sorteo | | [/giveaway reroll](#cmd-giveaway-reroll) | Volver a sortear ganadores | #### /giveaway create Crear un nuevo sorteo Los requisitos opcionales permiten limitar la participación por rol, boosters, edad de cuenta y tiempo en el servidor. ``` /giveaway create [descripcion] [rol_requerido] [solo_boosters] [edad_cuenta] [tiempo_servidor] [imagen] [privado] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | premio | Texto | Sí | ¿Qué se gana? | | duracion | Texto | Sí | Duración (ej: 1h, 30m, 2d, 1w) | | ganadores | Entero (1–20) | Sí | Cantidad de ganadores (1-20) | | canal | Canal | Sí | Canal donde publicar | | descripcion | Texto | No | Descripción adicional del sorteo | | rol_requerido | Rol | No | Rol requerido para participar | | solo_boosters | Booleano | No | Solo server boosters pueden participar | | edad_cuenta | Texto | No | Edad mínima de cuenta (ej: 30d) | | tiempo_servidor | Texto | No | Tiempo mínimo en servidor (ej: 7d) | | imagen | Texto | No | URL de imagen para el sorteo | | privado | Booleano | No | Ocultar lista de participantes | > **Permisos** > Requiere `Gestionar eventos`. > **Notas** > - La duración acepta formatos como `30m`, `2h`, `7d` o `1w`. #### /giveaway edit Editar un sorteo activo Permite cambiar premio, duración, cantidad de ganadores, imagen o descripción de un sorteo activo usando el ID del mensaje. ``` /giveaway edit [nuevo_premio] [nueva_duracion] [nuevos_ganadores] [nueva_imagen] [nueva_descripcion] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | mensaje_id | Texto | Sí | ID del mensaje del sorteo | | nuevo_premio | Texto | No | Nuevo premio | | nueva_duracion | Texto | No | Nueva duración | | nuevos_ganadores | Entero (1–20) | No | Nueva cantidad de ganadores | | nueva_imagen | Texto | No | Nueva URL de imagen | | nueva_descripcion | Texto | No | Nueva descripción | #### /giveaway end Finalizar un sorteo manualmente ``` /giveaway end ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | mensaje_id | Texto | Sí | ID del mensaje del sorteo | #### /giveaway list Ver sorteos activos ``` /giveaway list ``` #### /giveaway participants Ver participantes de un sorteo ``` /giveaway participants ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | mensaje_id | Texto | Sí | ID del mensaje del sorteo | #### /giveaway reroll Volver a sortear ganadores Vuelve a sortear los ganadores de un sorteo finalizado usando el ID del mensaje. ``` /giveaway reroll ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | mensaje_id | Texto | Sí | ID del mensaje del sorteo | ### Notas - La duración mínima es de 10 segundos y la máxima de 30 días. ### Ejemplo ``` /giveaway ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/golpe](https://nearsecurity.citymoon.org/docs/comandos/comunidad/golpe) Da un golpe divertido a otro miembro. ### Uso ``` /golpe ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | El usuario al que quieres golpear | ### Ejemplo ``` /golpe @usuario ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/howgay](https://nearsecurity.citymoon.org/docs/comandos/comunidad/howgay) Genera un resultado humorístico sobre un miembro. ### Uso ``` /howgay [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | El usuario a analizar (opcional) | ### Ejemplo ``` /howgay ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/invites](https://nearsecurity.citymoon.org/docs/comandos/comunidad/invites) Consulta quién invitó a cada miembro, cuántos siguen y cuántos salieron. NearSecurity guarda un registro de cada unión y salida, junto con la invitación utilizada y su creador. Todos los miembros pueden consultar los contadores. El seguimiento es solo informativo: no expulsa, banea ni borra invitaciones automáticamente. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/invites contador](#cmd-invites-contador) | Muestra los usuarios invitados por una persona y cuántos siguen en el servidor | | [/invites invitaciones](#cmd-invites-invitaciones) | Muestra las invitaciones activas y sus usos | | [/invites ranking](#cmd-invites-ranking) | Muestra el ranking de invitadores del servidor | | [/invites recientes](#cmd-invites-recientes) | Muestra las uniones recientes con su invitación de origen | | [/invites usuario](#cmd-invites-usuario) | Muestra los usuarios invitados por una persona, incluyendo quiénes salieron | #### /invites contador Muestra los usuarios invitados por una persona y cuántos siguen en el servidor ``` /invites contador [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | Usuario del que quieres ver las invitaciones (por defecto tú) | #### /invites invitaciones Muestra las invitaciones activas y sus usos ``` /invites invitaciones ``` #### /invites ranking Muestra el ranking de invitadores del servidor ``` /invites ranking [limite] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | limite | Entero (1–20) | No | Cantidad de invitadores a mostrar (1-20) | #### /invites recientes Muestra las uniones recientes con su invitación de origen ``` /invites recientes [limite] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | limite | Entero (1–20) | No | Cantidad de uniones a mostrar (1-20) | #### /invites usuario Muestra los usuarios invitados por una persona, incluyendo quiénes salieron ``` /invites usuario [limite] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario que hizo las invitaciones | | limite | Entero (1–20) | No | Cantidad de uniones a mostrar (1-20) | ### Notas - El bot necesita `Gestionar servidor` para leer las invitaciones del servidor. - Requiere el intent privilegiado `Guild Invites` en el portal de desarrolladores de Discord. ### Ejemplo ``` /invites ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/nivel](https://nearsecurity.citymoon.org/docs/comandos/comunidad/nivel) Sistema de experiencia, niveles, rankings y personalización de perfiles. Los miembros ganan XP por mensajes y por tiempo en voz. El sistema permite configurar la XP por mensaje, la XP por voz, el cooldown, el canal de subida de nivel y los roles automáticos por nivel. Incluye ranking del servidor, ranking global, tarjeta de perfil, tienda de personalización y duelos por XP. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/nivel autorol](#cmd-nivel-autorol) | Roles automáticos por nivel (Solo administradores) | | [/nivel config](#cmd-nivel-config) | Configurar el sistema de niveles (Solo administradores) | | [/nivel global](#cmd-nivel-global) | Ver el ranking global de niveles | | [/nivel leaderboard](#cmd-nivel-leaderboard) | Ver el ranking de niveles del servidor | | [/nivel perfil](#cmd-nivel-perfil) | Ver tu perfil de nivel o el de otro usuario | | [/nivel personalizar](#cmd-nivel-personalizar) | Personaliza tu tarjeta de perfil | | [/nivel setlevelupchannel](#cmd-nivel-setlevelupchannel) | Establece el canal de subida de nivel (Solo administradores) | | [/nivel tienda](#cmd-nivel-tienda) | Tienda de personalización para tu perfil | #### /nivel autorol Roles automáticos por nivel (Solo administradores) Asocia roles a niveles para que se asignen automáticamente al alcanzarlos. ``` /nivel autorol [nivel] [rol] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | accion | Texto | Sí | Acción a realizar Valores: `add`, `remove`, `list`. | | nivel | Entero (1–1000) | No | Nivel al alcanzar el rol | | rol | Rol | No | Rol a otorgar | > **Permisos** > Requiere `Administrador`. #### /nivel config Configurar el sistema de niveles (Solo administradores) Configura el sistema de niveles: activación, XP por mensaje, XP por voz y cooldown. ``` /nivel config [activado] [xp_mensaje] [xp_voz] [cooldown] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | activado | Booleano | No | Activar o desactivar el sistema de niveles | | xp_mensaje | Entero (1–100) | No | XP por mensaje (1-100) | | xp_voz | Entero (1–50) | No | XP por minuto en voz (1-50) | | cooldown | Entero (10–300) | No | Cooldown entre mensajes en segundos (10-300) | > **Permisos** > Requiere `Administrador`. #### /nivel global Ver el ranking global de niveles ``` /nivel global [pagina] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | pagina | Entero (mín. 1) | No | Página del leaderboard global | #### /nivel leaderboard Ver el ranking de niveles del servidor ``` /nivel leaderboard [pagina] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | pagina | Entero (mín. 1) | No | Página del leaderboard | #### /nivel perfil Ver tu perfil de nivel o el de otro usuario ``` /nivel perfil [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | Usuario cuyo perfil quieres ver | #### /nivel personalizar Personaliza tu tarjeta de perfil ``` /nivel personalizar [fondo] [fuente] [banner_url] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | fondo | Texto | No | ID del fondo | | fuente | Texto | No | Nombre de la fuente | | banner_url | Texto | No | URL de tu banner custom (necesita pase) | #### /nivel setlevelupchannel Establece el canal de subida de nivel (Solo administradores) Define el canal donde se anuncian las subidas de nivel. Si no se configura, se usa el canal del mensaje. ``` /nivel setlevelupchannel ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | canal | Canal | Sí | Canal de subida de nivel | > **Permisos** > Requiere `Administrador`. #### /nivel tienda Tienda de personalización para tu perfil Muestra los elementos de personalización disponibles y permite comprarlos con la moneda del sistema de niveles. ``` /nivel tienda ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | tipo | Texto | Sí | Qué quieres comprar Valores: `backgrounds`, `fonts`, `custom_banner`. | ### Notas - Los valores iniciales son 15 XP por mensaje, 10 XP por voz y 60 segundos de cooldown. - El sistema está activado por defecto en las configuraciones nuevas. ### Ejemplo ``` /nivel ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/perfil](https://nearsecurity.citymoon.org/docs/comandos/comunidad/perfil) Muestra la tarjeta de perfil y el nivel de un miembro. Podés ver tu propio perfil o el de otro usuario, con nivel, XP y personalización de la tarjeta. ### Uso ``` /perfil [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | Usuario a consultar | ### Ejemplo ``` /perfil ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/recordatorio](https://nearsecurity.citymoon.org/docs/comandos/comunidad/recordatorio) Crea y administra recordatorios que se envían por mensaje directo. Acepta fechas como `2026-12-25 15:30`, `25/12/2026 15:30` o `25-12-2026 15:30`. Se pueden repetir a diario, semanalmente o cada mes. Se administran con `/recordatorio listar`, `/recordatorio editar`, `/recordatorio pausar`, `/recordatorio reanudar` y `/recordatorio eliminar`. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/recordatorio crear](#cmd-recordatorio-crear) | Crea un nuevo recordatorio | | [/recordatorio editar](#cmd-recordatorio-editar) | Edita el mensaje, la fecha o la repetición de un recordatorio | | [/recordatorio eliminar](#cmd-recordatorio-eliminar) | Elimina un recordatorio específico | | [/recordatorio listar](#cmd-recordatorio-listar) | Muestra tus recordatorios activos | | [/recordatorio pausar](#cmd-recordatorio-pausar) | Pausa un recordatorio sin eliminarlo | | [/recordatorio reanudar](#cmd-recordatorio-reanudar) | Reanuda un recordatorio pausado | #### /recordatorio crear Crea un nuevo recordatorio La fecha debe estar en el futuro. Si elegís repetición diaria o semanal, el recordatorio se reprograma automáticamente después de cada envío. ``` /recordatorio crear [repetir] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | mensaje | Texto | Sí | El mensaje del recordatorio | | fecha | Texto | Sí | Fecha y hora del recordatorio (ej: 2024-12-25 15:30) | | repetir | Texto | No | Repetir el recordatorio Valores: `none`, `daily`, `weekly`. | #### /recordatorio editar Edita el mensaje, la fecha o la repetición de un recordatorio ``` /recordatorio editar [mensaje] [fecha] [repetir] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | id | Texto | Sí | ID del recordatorio a editar | | mensaje | Texto | No | Nuevo mensaje del recordatorio | | fecha | Texto | No | Nueva fecha y hora (ej: 2024-12-25 15:30) | | repetir | Texto | No | Nueva repetición del recordatorio Valores: `none`, `daily`, `weekly`, `monthly`. | #### /recordatorio eliminar Elimina un recordatorio específico ``` /recordatorio eliminar ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | id | Texto | Sí | ID del recordatorio a eliminar | #### /recordatorio listar Muestra tus recordatorios activos ``` /recordatorio listar ``` #### /recordatorio pausar Pausa un recordatorio sin eliminarlo ``` /recordatorio pausar ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | id | Texto | Sí | ID del recordatorio a pausar | #### /recordatorio reanudar Reanuda un recordatorio pausado ``` /recordatorio reanudar ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | id | Texto | Sí | ID del recordatorio a reanudar | ### Notas - La fecha se interpreta en la zona horaria del servidor donde corre el bot. Los recordatorios mensuales ajustan el día al último del mes cuando corresponde. ### Ejemplo ``` /recordatorio ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/seguir](https://nearsecurity.citymoon.org/docs/comandos/comunidad/seguir) Notifica nuevas publicaciones de YouTube, Twitch o Kick en un canal. Indicá la plataforma, el identificador o nombre del canal y el canal de Discord donde se enviarán las notificaciones. No se permiten objetivos duplicados. ### Uso ``` /seguir ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | plataforma | Texto | Sí | Plataforma a seguir Valores: `youtube`, `twitch`, `kick`. | | target | Texto | Sí | ID, canal o usuario a seguir | | canal | Canal | Sí | Canal donde enviar notificaciones | ### Notas - La disponibilidad depende de las API externas de cada plataforma. ### Ejemplo ``` /seguir #canal ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/stats](https://nearsecurity.citymoon.org/docs/comandos/comunidad/stats) Genera un panel visual con las estadísticas de actividad del servidor. El panel incluye actividad de los últimos días, mensajes, miembros y los miembros con más XP. ### Uso ``` /stats ``` ### Ejemplo ``` /stats ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/sugerir](https://nearsecurity.citymoon.org/docs/comandos/comunidad/sugerir) Publica una sugerencia en el canal configurado. La sugerencia se envía al canal configurado en el dashboard. Los administradores pueden aprobarla o denegarla con los botones del mensaje. ### Uso ``` /sugerir ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | mensaje | Texto | Sí | Tu sugerencia | ### Notas - El sistema debe estar activado y tener un canal configurado en **Comunidad → Sugerencias**. ### Ejemplo ``` /sugerir ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/ticket](https://nearsecurity.citymoon.org/docs/comandos/comunidad/ticket) Sistema de tickets con panel, categorías, límites y transcripciones. El flujo de `/ticket setup` permite configurar el panel, el embed, los mensajes y el canal de logs. Los usuarios abren tickets con un botón; el staff puede reclamarlos, añadir o quitar usuarios, renombrarlos y cerrarlos. Al cerrar un ticket se genera una transcripción HTML y se envía al canal de logs configurado. > **Permisos** > La configuración requiere `Administrador` o ser propietario del servidor. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/ticket adduser](#cmd-ticket-adduser) | Agregar usuario al ticket | | [/ticket claim](#cmd-ticket-claim) | Reclamar un ticket | | [/ticket create](#cmd-ticket-create) | Crear un ticket | | [/ticket done](#cmd-ticket-done) | Cerrar el ticket | | [/ticket removeuser](#cmd-ticket-removeuser) | Remover usuario del ticket | | [/ticket rename](#cmd-ticket-rename) | Renombrar el ticket | | [/ticket setlimit](#cmd-ticket-setlimit) | Establece el límite de tickets por usuario | | [/ticket setup](#cmd-ticket-setup) | Configurar sistema de tickets (flujo guiado) | | [/ticket updatepanel](#cmd-ticket-updatepanel) | Actualiza el panel de tickets según la configuración | #### /ticket adduser Agregar usuario al ticket ``` /ticket adduser ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a agregar | #### /ticket claim Reclamar un ticket ``` /ticket claim ``` #### /ticket create Crear un ticket ``` /ticket create ``` #### /ticket done Cerrar el ticket Cierra el ticket, genera una transcripción HTML y la envía al canal de logs configurado. El canal se elimina diez segundos después. ``` /ticket done ``` #### /ticket removeuser Remover usuario del ticket ``` /ticket removeuser ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a remover | #### /ticket rename Renombrar el ticket ``` /ticket rename ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | nombre | Texto | Sí | Nuevo nombre | #### /ticket setlimit Establece el límite de tickets por usuario Define cuántos tickets abiertos puede tener cada usuario a la vez. El valor predeterminado es 1. ``` /ticket setlimit ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | limite | Entero (1–10) | Sí | Cantidad máxima de tickets abiertos por usuario | > **Permisos** > Requiere `Administrador`. #### /ticket setup Configurar sistema de tickets (flujo guiado) Abre un panel con botones para configurar la información básica, personalizar el embed, definir mensajes, enviar el panel y el canal de logs, ver la configuración o restablecerla. ``` /ticket setup ``` > **Permisos** > Requiere `Administrador` o ser propietario del servidor. #### /ticket updatepanel Actualiza el panel de tickets según la configuración ``` /ticket updatepanel ``` ### Notas - El límite de tickets abiertos por usuario se configura con `/ticket setlimit`. ### Ejemplo ``` /ticket ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/comunidad/bienvenida) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) # Comandos de servidor y utilidades Referencia de comandos de servidor y utilidades. ## [/bot](https://nearsecurity.citymoon.org/docs/comandos/utilidades/bot) Muestra información del bot, su icono y el estado de la infraestructura. `/bot info` incluye la versión actual, la latencia, el entorno y los enlaces de soporte. `/bot salud` muestra el estado de MongoDB, los respaldos, UBFB, las colas y el programador de tareas. Está disponible para todos los usuarios. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/bot icon](#cmd-bot-icon) | Muestra el icono del bot | | [/bot info](#cmd-bot-info) | Muestra información del bot | | [/bot salud](#cmd-bot-salud) | Muestra el estado en vivo de la infraestructura del bot | #### /bot icon Muestra el icono del bot ``` /bot icon ``` #### /bot info Muestra información del bot Muestra la versión del bot, la latencia, el tiempo en línea y los enlaces de soporte. ``` /bot info ``` #### /bot salud Muestra el estado en vivo de la infraestructura del bot ``` /bot salud ``` ### Ejemplo ``` /bot ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/bugs](https://nearsecurity.citymoon.org/docs/comandos/utilidades/bugs) Reporta un bug del bot al equipo de desarrollo. El formulario pide un título y una descripción con pasos para reproducirlo. Tiene un límite de un reporte por minuto. ### Uso ``` /bugs ``` ### Ejemplo ``` /bugs ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/channel](https://nearsecurity.citymoon.org/docs/comandos/utilidades/channel) Consulta información de canales y permite recrearlos con `/channel nuke`. > **Cuidado** > - `/channel nuke` borra el canal y lo recrea, por lo que se pierden los mensajes. Requiere `Administrador`. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/channel info](#cmd-channel-info) | Muestra información de un canal | | [/channel nuke](#cmd-channel-nuke) | Borra todos los mensajes de un canal recreándolo | | [/channel permissions](#cmd-channel-permissions) | Muestra los permisos del canal | | [/channel roles](#cmd-channel-roles) | Muestra los roles con acceso al canal | #### /channel info Muestra información de un canal ``` /channel info ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | canal | Canal | Sí | El canal a inspeccionar | #### /channel nuke Borra todos los mensajes de un canal recreándolo Recrea el canal con el mismo nombre, categoría y permisos, pero pierde el historial de mensajes. ``` /channel nuke ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | canal | Canal | Sí | El canal a nukeear | > **Permisos** > Requiere `Administrador`. > **Cuidado** > - No se puede deshacer. Confirmá el canal antes de ejecutar. #### /channel permissions Muestra los permisos del canal ``` /channel permissions ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | canal | Canal | Sí | El canal a inspeccionar | #### /channel roles Muestra los roles con acceso al canal ``` /channel roles ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | canal | Canal | Sí | El canal a inspeccionar | ### Ejemplo ``` /channel ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/decrypt](https://nearsecurity.citymoon.org/docs/comandos/utilidades/decrypt) Descifra un texto generado con `/encrypt` usando AES-256-GCM. Necesitás el hash completo y la contraseña original. Sin la contraseña correcta no se puede recuperar el mensaje. > **Cuidado** > - No compartas la contraseña por canales públicos. NearSecurity no puede recuperar contraseñas perdidas. ### Uso ``` /decrypt ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | hash | Texto | Sí | El mensaje encriptado (formato IV:AuthTag:Payload) | | password | Texto | Sí | La contraseña secreta para desencriptarlo | ### Ejemplo ``` /decrypt ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/empezar](https://nearsecurity.citymoon.org/docs/comandos/utilidades/empezar) Presenta NearSecurity y permite explorar sus módulos desde un menú interactivo. ### Uso ``` /empezar ``` ### Ejemplo ``` /empezar ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/encrypt](https://nearsecurity.citymoon.org/docs/comandos/utilidades/encrypt) Cifra un mensaje con AES-256-GCM y una contraseña. El resultado es un hash que se puede descifrar con `/decrypt` y la misma contraseña. > **Cuidado** > - El cifrado protege el contenido, pero no impide que alguien con acceso al hash y la contraseña lo lea. ### Uso ``` /encrypt ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | message | Texto | Sí | El mensaje que deseas encriptar | | password | Texto | Sí | La contraseña secreta para encriptarlo | ### Ejemplo ``` /encrypt ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/filescan](https://nearsecurity.citymoon.org/docs/comandos/utilidades/filescan) Escanea archivos y URLs con VirusTotal. Permite analizar un adjunto o una URL. El resultado se muestra en un panel con los motores que detectaron amenazas. La API key de VirusTotal es global del despliegue: se configura una vez en el host del bot con `/filescan config` y se reutiliza en todos los servidores. El archivo adjunto puede pesar hasta 32 MB. > **Permisos** > Requiere `Gestionar mensajes` para configurar y ejecutar escaneos. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/filescan config](#cmd-filescan-config) | Configura la API key de VirusTotal | | [/filescan scan](#cmd-filescan-scan) | Escanea un archivo adjunto | | [/filescan scanurl](#cmd-filescan-scanurl) | Escanea un archivo desde una URL | #### /filescan config Configura la API key de VirusTotal Guarda la API key global de VirusTotal en el host del bot. No es una clave por servidor: se usa en todos los escaneos posteriores del despliegue. ``` /filescan config ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | apikey | Texto | Sí | Tu API key de VirusTotal | > **Permisos** > Requiere `Gestionar mensajes`. > **Cuidado** > - La API key es un secreto y se guarda en el servidor donde corre el bot. No la compartas en canales públicos. #### /filescan scan Escanea un archivo adjunto Analiza un archivo adjunto con VirusTotal y muestra el resultado de los motores. ``` /filescan scan ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | archivo | Archivo | Sí | El archivo que quieres escanear | > **Permisos** > Requiere `Gestionar mensajes`. #### /filescan scanurl Escanea un archivo desde una URL Analiza una URL con VirusTotal. La URL se envía al servicio externo. ``` /filescan scanurl ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | url | Texto | Sí | URL del archivo a escanear | > **Permisos** > Requiere `Gestionar mensajes`. ### Notas - El archivo o la URL se envía a VirusTotal, un servicio externo. No escanees documentos privados sin autorización. ### Ejemplo ``` /filescan ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/osint](https://nearsecurity.citymoon.org/docs/comandos/utilidades/osint) Reúne información pública de un usuario de Discord. El resultado se muestra en un panel con datos de la cuenta y enlaces de consulta. Usalo respetando la privacidad y las normas de tu comunidad. ### Uso ``` /osint ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | Sí | Usuario a analizar | ### Ejemplo ``` /osint @usuario ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/server](https://nearsecurity.citymoon.org/docs/comandos/utilidades/server) Muestra información del servidor, su icono y su banner. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/server banner](#cmd-server-banner) | Muestra el banner del servidor | | [/server icon](#cmd-server-icon) | Muestra el icono del servidor | | [/server info](#cmd-server-info) | Muestra información detallada del servidor | #### /server banner Muestra el banner del servidor ``` /server banner ``` #### /server icon Muestra el icono del servidor ``` /server icon ``` #### /server info Muestra información detallada del servidor ``` /server info ``` ### Ejemplo ``` /server ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/setup](https://nearsecurity.citymoon.org/docs/comandos/utilidades/setup) Agrupa las configuraciones principales del servidor. Desde acá se gestionan autoroles, filtros de palabras, logs, reaction roles, sugerencias y listas blancas. La bienvenida se configura únicamente desde el dashboard. > **Permisos** > El comando requiere `Administrador`. Algunas acciones de whitelist están reservadas al propietario. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/setup autoroles](#cmd-setup-autoroles) | Gestiona los roles automáticos | | [/setup badwords](#cmd-setup-badwords) | Gestiona el sistema de antibadwords del servidor | | [/setup logs](#cmd-setup-logs) | Activa o desactiva los logs del servidor | | [/setup reactionroles](#cmd-setup-reactionroles) | Configura un sistema de reaction roles | | [/setup sugerencias](#cmd-setup-sugerencias) | Configura el canal de sugerencias | | [/setup welcome](#cmd-setup-welcome) | Información sobre el sistema de bienvenida | | [/setup whitelist](#cmd-setup-whitelist) | Configura usuarios o roles autorizados | #### /setup autoroles Gestiona los roles automáticos Agrega, quita o lista los roles que se asignan automáticamente a los nuevos miembros. ``` /setup autoroles [rol] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | accion | Texto | Sí | Acción a realizar Valores: `agregar`, `eliminar`, `listar`. | | rol | Rol | No | Rol a procesar | #### /setup badwords Gestiona el sistema de antibadwords del servidor Activa o desactiva el filtro de palabras, agrega o quita términos y muestra la lista actual. ``` /setup badwords [palabra] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | accion | Texto | Sí | Acción a realizar Valores: `activar`, `desactivar`, `agregar`, `quitar`, `listar`. | | palabra | Texto | No | Palabra a agregar/quitar | > **Notas** > - La comparación se hace en minúsculas y sin distinguir mayúsculas. #### /setup logs Activa o desactiva los logs del servidor Activa o desactiva los logs globales y define el canal de auditoría. Si no indicás un canal, se usa el que ya esté configurado. ``` /setup logs [canal] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | estado | Texto | Sí | Activar o desactivar logs Valores: `on`, `off`. | | canal | Canal | No | Canal para los logs (opcional) | > **Notas** > - Los eventos individuales se activan o desactivan desde el dashboard. #### /setup reactionroles Configura un sistema de reaction roles Abre un formulario para crear el embed de roles y luego permite asociar reacciones a roles. ``` /setup reactionroles ``` > **Notas** > - El panel se publica en el canal donde se ejecuta el comando. #### /setup sugerencias Configura el canal de sugerencias Define el canal donde se publicarán las sugerencias enviadas con `/sugerir`. ``` /setup sugerencias ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | canal | Canal | Sí | Canal donde se enviarán las sugerencias | #### /setup welcome Información sobre el sistema de bienvenida Este subcomando no configura la bienvenida: muestra un aviso con el enlace al dashboard, donde se edita el canal, el tipo de mensaje y el contenido. ``` /setup welcome ``` > **Notas** > - El sistema de bienvenida se guarda en la configuración del servidor y se aplica a los nuevos miembros. #### /setup whitelist Configura usuarios o roles autorizados Agrega, elimina o lista usuarios y roles inmunes a las protecciones automáticas. La lista se pagina de diez en diez. ``` /setup whitelist [tipo] [usuario] [rol] [pagina] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | accion | Texto | Sí | Acción a realizar Valores: `add`, `remove`, `list`. | | tipo | Texto | No | Tipo de whitelist Valores: `user`, `role`. | | usuario | Usuario | No | Usuario objetivo | | rol | Rol | No | Rol objetivo | | pagina | Entero (mín. 1) | No | Número de página | > **Permisos** > Solo el propietario del servidor puede agregar o quitar elementos. > **Cuidado** > - No agregues roles con permisos altos a la whitelist sin una razón concreta. ### Notas - Usá `/setup logs` o el dashboard para definir el canal de auditoría antes de activar sanciones automáticas. ### Ejemplo ``` /setup ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/traducir](https://nearsecurity.citymoon.org/docs/comandos/utilidades/traducir) Traduce texto usando Google Translate. Se abre un formulario para pegar el texto y elegir el idioma de destino. El servicio depende de la disponibilidad de Google Translate. ### Uso ``` /traducir ``` ### Ejemplo ``` /traducir ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/user](https://nearsecurity.citymoon.org/docs/comandos/utilidades/user) Muestra información de usuarios: avatar, banner, roles, permisos y datos generales. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/user avatar](#cmd-user-avatar) | Muestra el avatar de un usuario | | [/user banner](#cmd-user-banner) | Muestra el banner de un usuario | | [/user info](#cmd-user-info) | Muestra información detallada de un usuario | | [/user permissions](#cmd-user-permissions) | Muestra los permisos de un usuario en el servidor | | [/user roles](#cmd-user-roles) | Muestra los roles de un usuario en el servidor | #### /user avatar Muestra el avatar de un usuario ``` /user avatar [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | El usuario del que quieres ver el avatar | #### /user banner Muestra el banner de un usuario ``` /user banner [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | El usuario del que quieres ver el banner | #### /user info Muestra información detallada de un usuario ``` /user info [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | El usuario del que quieres ver la información | #### /user permissions Muestra los permisos de un usuario en el servidor ``` /user permissions [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | El usuario del que quieres ver los permisos | #### /user roles Muestra los roles de un usuario en el servidor ``` /user roles [usuario] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | usuario | Usuario | No | El usuario del que quieres ver los roles | ### Ejemplo ``` /user ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) # Comandos de respaldos Referencia de comandos de respaldos. ## [/backup](https://nearsecurity.citymoon.org/docs/comandos/respaldos/backup) Crea y restaura respaldos personales de la estructura del servidor. El respaldo guarda roles, canales, categorías y permisos; no guarda mensajes. Cada usuario ve solo sus propios respaldos y puede generar una vista previa en HTML antes de restaurar. El modo **merge** crea solo los roles y canales que faltan. El modo **full** elimina los canales y roles actuales y restaura la copia; es irreversible. > **Permisos** > Requiere `Administrador`. > **Cuidado** > - La restauración completa borra la estructura actual y los mensajes de los canales eliminados. Usá primero el modo merge y revisá la vista previa. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/backup create](#cmd-backup-create) | Crea un respaldo de la estructura actual del servidor. | | [/backup delete](#cmd-backup-delete) | Elimina uno de tus respaldos guardados. | | [/backup info](#cmd-backup-info) | Genera una vista previa en HTML de los datos del respaldo. | | [/backup list](#cmd-backup-list) | Lista los respaldos guardados en tu cuenta personal. | | [/backup load](#cmd-backup-load) | Carga un respaldo: restauración parcial o completa. | #### /backup create Crea un respaldo de la estructura actual del servidor. Guarda una instantánea de roles, canales, categorías y permisos con el nombre indicado. ``` /backup create [nombre] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | nombre | Texto | No | Nombre para identificar este respaldo | #### /backup delete Elimina uno de tus respaldos guardados. ``` /backup delete ``` #### /backup info Genera una vista previa en HTML de los datos del respaldo. Genera una vista previa en HTML del contenido del respaldo para revisarlo antes de restaurar. ``` /backup info ``` #### /backup list Lista los respaldos guardados en tu cuenta personal. ``` /backup list ``` #### /backup load Carga un respaldo: restauración parcial o completa. Abre un selector con tus respaldos guardados y después permite elegir el modo de restauración. **Restaurar solo lo faltante** crea los roles y canales que no existan y conserva los actuales. **Restauración completa** elimina los canales y roles actuales antes de aplicar el respaldo. ``` /backup load ``` > **Cuidado** > - La restauración completa borra la estructura actual y los mensajes de los canales eliminados. Revisá la vista previa y usá el modo merge cuando sea posible. ### Ejemplo ``` /backup ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/recuperacion/backups) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos) ## [/unnuke](https://nearsecurity.citymoon.org/docs/comandos/respaldos/unnuke) Revierte un ataque: elimina duplicados y restaura canales o roles borrados. Permite limpiar canales, roles, emojis y baneos recientes. También intenta restaurar canales y roles borrados desde el registro automático del bot, incluso si no hay un backup manual. La restauración solo crea lo que falta: no borra ni modifica los elementos existentes. > **Permisos** > Solo el propietario del servidor. > **Cuidado** > - Revisá la vista previa antes de confirmar. La ventana de tiempo máxima es de 24 horas. ### Subcomandos | Subcomando | Qué hace | | --- | --- | | [/unnuke bans](#cmd-unnuke-bans) | Levanta baneos recientes aplicados durante un ataque. | | [/unnuke channels](#cmd-unnuke-channels) | Elimina canales duplicados creados durante un ataque. | | [/unnuke emojis](#cmd-unnuke-emojis) | Elimina emojis duplicados creados durante un ataque. | | [/unnuke roles](#cmd-unnuke-roles) | Elimina roles duplicados creados durante un ataque. | #### /unnuke bans Levanta baneos recientes aplicados durante un ataque. Levanta los baneos aplicados dentro de la ventana de tiempo indicada. La opción `todos` desbanea absolutamente a todos los usuarios y es peligrosa. ``` /unnuke bans [minutos] [todos] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | minutos | Entero (1–1440) | No | Ventana de tiempo en minutos (por defecto 60) | | todos | Booleano | No | Desbanear absolutamente todos los usuarios (peligroso) | > **Permisos** > Solo el propietario del servidor. > **Cuidado** > - Revisá la vista previa antes de confirmar. La ventana máxima es de 1440 minutos. #### /unnuke channels Elimina canales duplicados creados durante un ataque. Elimina canales duplicados creados durante el ataque y restaura canales borrados desde el registro automático. ``` /unnuke channels [minutos] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | minutos | Entero (1–1440) | No | Ventana de tiempo en minutos (por defecto 60) | > **Permisos** > Solo el propietario del servidor. #### /unnuke emojis Elimina emojis duplicados creados durante un ataque. Elimina emojis duplicados creados durante el ataque. ``` /unnuke emojis [minutos] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | minutos | Entero (1–1440) | No | Ventana de tiempo en minutos (por defecto 60) | > **Permisos** > Solo el propietario del servidor. #### /unnuke roles Elimina roles duplicados creados durante un ataque. Elimina roles duplicados creados durante el ataque y restaura roles borrados desde el registro automático. ``` /unnuke roles [minutos] ``` | Opción | Tipo | Obligatoria | Descripción | | --- | --- | --- | --- | | minutos | Entero (1–1440) | No | Ventana de tiempo en minutos (por defecto 60) | > **Permisos** > Solo el propietario del servidor. ### Ejemplo ``` /unnuke ``` > **Sigue leyendo** > - [Guía relacionada](https://nearsecurity.citymoon.org/docs/recuperacion/backups) > - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos)