Documentación oficial

Guía de Exodus

Exodus es un bot de Discord modular y configurable. Cada función se activa y personaliza desde el panel web sin necesidad de comandos. Esta guía cubre todos los módulos, comandos y opciones de configuración disponibles.

🛡️
Moderación completa
Ban, kick, mute, warns con historial y logs detallados.
CORE
🎫
Sistema de Tickets
Soporte con categorías, transcripciones y roles configurables.
CONFIG
🤖
Chat con IA
Asistente Gemini por servidor con personalidad propia.
GEMINI
🎵
Música Lavalink
Reproducción de alta calidad desde múltiples fuentes.
LAVALINK
🎉
Sorteos
Crea, pausa y rerollea sorteos desde el panel.
GIVEAWAYS
🎭
Roles avanzados
Auto-roles, temporales, por antigüedad e hitos.
ROLES
🛡️
Automod
Moderación automática con 11 módulos, strikes y filtros personalizados.
AUTOMOD
🛡
Antinuke
Protección en tiempo real contra ataques destructivos al servidor.
SEGURIDAD
Leveling
XP, niveles, roles de recompensa y leaderboard por servidor.
XP
Components V2
Constructor visual de mensajes interactivos con el nuevo sistema de Discord.
BUILDER
🎮
Comandos Personalizados
Crea tus propios comandos de prefijo con acciones, variables y condiciones.
CUSTOM

⚙️ Configuración inicial

Sigue estos pasos para tener Exodus funcionando en tu servidor desde cero.

1
Agregar el bot
Haz clic en "Agregar a Discord" desde la landing. Selecciona tu servidor y acepta los permisos solicitados. El bot necesita permisos de Administrador para funcionar correctamente en todos los módulos.
2
Acceder al Dashboard
Ve a dashboard.exodus-panel.xyz e inicia sesión con Discord. Debes tener el permiso de Administrador en el servidor para acceder a su configuración.
3
Seleccionar servidor
En el panel, elige tu servidor en el selector de la barra lateral. Verás las estadísticas y podrás navegar por todos los módulos disponibles.
4
Configurar módulos
Activa y configura cada módulo por separado. Empieza por los Logs de Auditoría para tener visibilidad de lo que ocurre en tu servidor, luego configura Moderación, Tickets y el resto según tus necesidades.
💡 Todos los cambios del panel se aplican en tiempo real. No necesitas reiniciar el bot ni usar ningún comando de recarga.

🔐 Permisos requeridos

Exodus necesita ciertos permisos de Discord para operar. A continuación se detalla cada uno y por qué es necesario.

👑 Administrador Simplifica todos los permisos. Recomendado para evitar problemas. RECOMENDADO
🔨 Banear miembros Necesario para el comando /ban y acciones de moderación. REQUERIDO
👢 Expulsar miembros Necesario para /kick. REQUERIDO
⏱️ Aislar temporalmente Necesario para el mute/timeout de miembros. REQUERIDO
💬 Gestionar mensajes Necesario para purge, snipe y algunas funciones de moderación. REQUERIDO
📁 Gestionar canales Necesario para crear canales de tickets automáticamente. REQUERIDO
🎭 Gestionar roles Necesario para auto-roles, roles temporales y sistema de roles. REQUERIDO
🔗 Gestionar webhooks Necesario para el modo webhook en bienvenidas y logs. OPCIONAL

🛡️ Moderación

El módulo de moderación incluye todas las herramientas para gestionar tu comunidad. Las acciones pueden ejecutarse desde Discord con comandos slash o directamente desde el panel web.

Logs de Auditoría

Configura un canal donde el bot registrará automáticamente eventos del servidor: bans, kicks, cambios de rol, edición de mensajes, entradas y salidas de miembros, y más. Se configura desde Dashboard → Logs de Auditoría.

Sistema de Warns

Cada warn queda registrado con un ID único, la razón, el moderador que lo emitió y la fecha. Puedes ver el historial completo de un usuario, eliminar warns individuales o limpiar todos desde el dashboard o con /warn.

Logs de Moderación

Todas las acciones de moderación (ban, kick, mute, warn) se registran automáticamente en la base de datos y son consultables desde el panel en Moderación → Logs.

⚠️ El bot solo puede moderar a usuarios con un rol inferior al suyo en la jerarquía. Asegúrate de que el rol del bot esté por encima de los roles que quieres que pueda gestionar.

🎫 Tickets

Sistema de soporte completo con canales individuales por usuario, roles de handlers, transcripciones y preguntas de apertura.

Configuración básica

Desde Configuración → Tickets en el panel configuras:

📌Canal del panelDonde aparecerá el botón para abrir tickets.
📁Categoría de ticketsDonde se crearán los canales de cada ticket.
📋Canal de transcripcionesDonde se enviarán los logs al cerrar tickets.
🎭Rol de handlersRol que puede ver y gestionar todos los tickets.

Opciones avanzadas

También puedes configurar: cooldown entre tickets, límite de tickets abiertos por usuario, sistema de valoración al cerrar, preguntas de apertura (hasta 3), horario de atención y personalización del embed y botón.

🎉 Sorteos

Crea sorteos con duración, número de ganadores, roles requeridos y mensajes personalizados. Se gestionan completamente desde el panel o con /giveaway.

Funciones disponibles

🎯
Múltiples ganadores
Define cuántos ganadores se eligen al finalizar.
🔄
Reroll
Elige nuevos ganadores si los originales no responden.
🎭
Rol requerido
Solo los miembros con cierto rol pueden participar.
🚫
Roles excluidos
Excluye roles específicos de la participación.
📩
DM al ganador
El bot avisa al ganador por mensaje directo.
⏹️
Finalizar manual
Termina un sorteo activo antes de tiempo desde el panel.

👋 Bienvenidas

Mensajes automáticos cuando un usuario entra o sale del servidor. Soporta texto plano, embeds y Components V2 de Discord.

Variables disponibles

VARIABLES {user} → Mención del usuario (@Usuario)
{username} → Nombre de usuario
{server} → Nombre del servidor
{membercount} → Número total de miembros
{joindate} → Fecha de entrada

Modos de envío

Normal — el bot envía el mensaje con su propio avatar y nombre.

Webhook — el mensaje se envía como un webhook con nombre y avatar personalizados.

Canvas de imágenes

Activa la tarjeta de bienvenida visual con el avatar del usuario, fondo personalizable, colores del borde y texto. Se genera automáticamente junto al mensaje de bienvenida.

🎭 Sistema de Roles

Exodus tiene cuatro módulos de roles avanzados que puedes combinar.

Auto-roles

Asigna roles automáticamente cuando un humano o un bot entra al servidor. Puedes configurar roles separados para humanos y bots.

Roles por tiempo

Asigna un rol después de X tiempo desde que el usuario entró al servidor. Útil para roles de "miembro veterano".

Roles temporales

Asigna roles que expiran automáticamente después de un período definido. Ideal para roles de prueba o accesos temporales.

Hitos de miembros

Asigna roles cuando el servidor alcanza cierto número de miembros. Por ejemplo, un rol especial para el miembro número 100, 500, 1000, etc.

Antigüedad

Asigna roles basados en cuánto tiempo lleva un usuario en el servidor. Se verifica periódicamente y se actualiza automáticamente.

🎵 Música

Reproducción de alta calidad vía Lavalink con soporte para múltiples fuentes de audio. Simplemente usa !play seguido del nombre, artista o URL directa.

Fuentes soportadas

YouTube
MÚSICA · VIDEO
Búsqueda por nombre, artista o URL. Soporta playlists completas y videos individuales.
PLAYLISTS BÚSQUEDA
Spotify
STREAMING
Canciones, álbumes y playlists. Requiere URL de Spotify — el audio se obtiene vía LavaSrc.
ÁLBUMES PLAYLISTS
SoundCloud
AUDIO · INDIE
Tracks y playlists de SoundCloud. Ideal para música indie y sonidos que no están en otras plataformas.
INDIE BÚSQUEDA
Deezer
STREAMING
Canciones y playlists de Deezer vía URL directa. Buena alternativa cuando Spotify no tiene el track.
URL
URL Directa
MP3 · MP4 · STREAM
Cualquier URL pública de audio o video. Soporta streams de radio en vivo, archivos MP3/MP4 y más.
RADIO MP3/MP4
💡 Los comandos de música son prefix commands. Usa !play, !skip, !queue, !stop, !volume etc. Para Spotify y Deezer necesitas pegar la URL directamente.

🤖 Chat con IA

Cada servidor puede tener su propio asistente de IA con personalidad única, impulsado por Google Gemini. Todo se configura por servidor desde el panel.

Configuración

1
Selecciona un canal
El bot solo responderá en el canal que configures. Cualquier mensaje en ese canal activará la IA.
2
API Key (opcional)
Puedes usar la API key del bot por defecto o ingresar una propia desde Google AI Studio. Con key propia tendrás mayor cuota.
3
Personalidad
Configura el nombre, tono, idioma, instrucciones del sistema, temas prohibidos, tamaño de contexto y temperatura. También puedes usar las plantillas predefinidas (Gaming, Académico, Soporte, etc.).

Parámetros de personalidad

ParámetroDescripciónRango
TemperaturaCreatividad de las respuestas. Más alto = más creativo.0.0 — 2.0
ContextoCuántos mensajes anteriores recuerda en la conversación.0 — 20
Máx. tokensLongitud máxima de cada respuesta.1024 — 8192
Temas prohibidosLista de temas que la IA evitará tocar.Texto libre

💰 Economía

Sistema de economía con monedas virtuales por servidor. Los usuarios ganan monedas trabajando, en el daily y participando.

Comandos principales

ComandoDescripción
balanceVer tu saldo actual o el de otro usuario.
dailyRecoge tu recompensa diaria. Cooldown de 24 horas.
workTrabaja para ganar monedas. Cooldown configurable.
robIntenta robar monedas a otro usuario. Riesgo incluido.
payTransfiere monedas a otro usuario.
leaderboardRanking de usuarios más ricos del servidor.

🛡️ Automod

Sistema de moderación automática que detecta y sanciona infracciones sin intervención manual. Se configura desde Configuración → Automod en el panel.

Módulos de protección

Cada módulo puede activarse o desactivarse de forma independiente. Todos se pueden habilitar o deshabilitar en bloque con los botones "Activar todos" y "Desactivar todos".

MóduloQué detecta
Anti PromociónInvitaciones de Discord enviadas en canales.
Anti LinksURLs HTTP/HTTPS no autorizadas.
Anti SpamMensajes repetidos enviados demasiado rápido.
Anti Mención MasivaMúltiples @menciones en un mismo mensaje.
Anti Imágenes MasivasMuchos archivos adjuntos enviados en poco tiempo.
Anti Reenvío MasivoMensajes reenviados en masa.
Anti AbusoInsultos y hate speech.
Anti NSFWPalabras clave de contenido adulto.
Anti NSFW ImagesEscaneo automático de imágenes con IA.
Anti MayúsculasExceso de MAYÚSCULAS según el porcentaje configurado.
Anti Emoji SpamDemasiados emojis en un solo mensaje.

Acción de castigo

Cuando Automod detecta una infracción, aplica una de estas acciones: Eliminar mensaje, Timeout (con duración configurable de 1 min a 1 hora), Kick o Ban. También puedes activar una notificación por DM al usuario infractor.

Sistema de strikes

En lugar de sancionar en la primera infracción, puedes activar el sistema de strikes. El bot acumula infracciones por usuario y solo aplica la sanción al alcanzar el umbral configurado (2, 3, 5 o 10 strikes). El historial de strikes es consultable por usuario desde el mismo panel.

Límites de detección

Ajusta los umbrales de sensibilidad para cada tipo de detección:

LímiteRango
Spam — mensajes por ventana3 – 10 mensajes
Spam — ventana de tiempo3 – 30 segundos
Mención masiva3 – 10 menciones
Imágenes masivas3 – 10 archivos
Porcentaje de mayúsculas50 % – 90 %
Emoji spam5 – 20 emojis

Whitelists

Puedes excluir del sistema a usuarios, canales o roles específicos. Los mensajes enviados por usuarios o en canales de la whitelist no serán procesados por ningún módulo de Automod.

Filtro de palabras personalizado

Añade palabras o frases específicas que el bot detectará y sancionará automáticamente, independientemente de los otros módulos.

💡 El canal de logs de Automod es independiente del canal de Logs de Auditoría. Puedes configurar uno dedicado para ver en detalle cada acción del sistema automático.

🛡 Antinuke

Protección avanzada contra ataques de nuke: detiene acciones destructivas masivas en tiempo real y sanciona automáticamente al responsable. Se configura desde Configuración → Antinuke.

Módulos de protección

MóduloQué protege
Anti Channel Create/Delete/UpdateCreación, eliminación o edición masiva de canales.
Anti Role Create/Delete/UpdateCreación, eliminación o modificación de roles.
Anti Webhook Create/Delete/UpdateManipulación de webhooks del servidor.
Anti Guild UpdateCambios en la configuración general del servidor.
Anti Integration Add/Update/DeleteModificación de integraciones y aplicaciones.
Anti Ban / Anti Kick / Anti UnbanBans, kicks y desbans masivos de miembros.
Anti Bot AddAdición de bots sin autorización.
Anti Everyone/Here PingPings masivos a @everyone y @here.
Anti Member Role UpdateAsignación o remoción masiva de roles a miembros.
Anti Member PruneExpulsión masiva de miembros inactivos.
Anti Community ChannelCambios en canales de comunidad.
Anti Linked RoleManipulación de roles vinculados.

Sanciones

Cuando el sistema detecta una acción sospechosa, aplica automáticamente una de estas sanciones al responsable: Ban, Kick, Strip Roles (quita todos sus roles) o Timeout. Solo se aplica una sanción por infracción.

Whitelist

Los usuarios en la whitelist están exentos de toda detección Antinuke. Ideal para bots de confianza o coadministradores que necesitan realizar acciones que de otro modo serían bloqueadas. Se gestiona por ID de usuario.

Extra Owners

Hasta 2 usuarios adicionales con permisos para gestionar la whitelist y los ajustes de Antinuke. Son tratados como co-propietarios del sistema de seguridad, sin necesidad de ser dueños del servidor.

⚠️ Añade a la whitelist todos los bots de administración que uses antes de activar Antinuke. Un bot con permisos de administrador puede disparar falsos positivos si no está exento.

⭐ Leveling

Sistema de niveles y XP por actividad en el servidor. Los usuarios ganan experiencia enviando mensajes y suben de nivel con recompensas configurables. Se gestiona desde Configuración → Leveling.

Configuración general

OpciónDescripción
Canal de notificacionesCanal donde el bot anuncia las subidas de nivel. Si se deja vacío, el aviso se envía en el canal donde el usuario habló.
Multiplicador global de XPMultiplica todo el XP ganado en el servidor. Útil para eventos de doble XP.
Cooldown entre mensajesSegundos que deben pasar entre mensajes para que un usuario gane XP de nuevo. Evita el spam.
XP por mensajeCantidad base de XP que otorga cada mensaje válido.
Mensaje de subida de nivelTexto personalizado que se envía cuando alguien sube de nivel. Admite variables {user}, {level} y {server}.

Dificultad de progresión

Controla qué tan rápido suben de nivel los usuarios con dos parámetros:

FÓRMULA XP requerido para nivel N = baseXP × exponente^N

Base XP (10 – 5000): XP necesario para el nivel 1. Cuanto mayor, más lento el inicio. Exponente (1.01 – 2.0): escala el XP requerido en cada nivel. Valores altos hacen los niveles altos muy difíciles de alcanzar.

Apariencia de tarjetas

Personaliza el diseño de las tarjetas de rango que se muestran con /rank: color principal, color secundario del gradiente y URL de imagen de fondo.

Multiplicadores por rol

Asigna un multiplicador de XP a roles específicos. Los miembros con ese rol ganarán XP más rápido. Por ejemplo, el rol "Nitro Booster" con multiplicador 2× obtiene el doble de XP por mensaje.

Roles por nivel

Configura roles que se asignan automáticamente al alcanzar cierto nivel. Puedes tener un rol distinto para cada nivel que quieras recompensar. Los roles anteriores se mantienen salvo que los elimines manualmente.

Leaderboard

Desde el panel puedes consultar el top 20 de usuarios con más XP en el servidor, con su nivel actual y puntuación. También puedes editar el XP de un usuario manualmente o resetear su progreso completo.

💡 Los mensajes con menos de 3 caracteres y los enviados antes de que expire el cooldown no otorgan XP. El bot tampoco otorga XP a otros bots.

⧉ Components V2

Constructor visual para enviar mensajes interactivos usando el nuevo sistema de componentes de Discord (Components V2). Permite crear layouts con contenedores, secciones, separadores, botones, menús y más sin escribir código.

Acceso

Disponible en Configuración → Components V2 del panel, o directamente en /compv2-builder. También existe una guía de referencia completa en /compv2-guide.

Componentes disponibles

📦
Container
Bloque raíz que agrupa otros componentes. Soporta color de acento y fondo alternativo.
📄
Section
Sección con texto a la izquierda y un accesorio opcional (botón o thumbnail) a la derecha.
✏️
Text Display
Bloque de texto plano o Markdown. Admite negritas, cursivas, menciones y emojis.
🖼️
Media Gallery
Galería de imágenes con hasta 10 elementos. Cada imagen puede tener descripción.
Separator
Línea divisoria con espaciado configurable (pequeño, mediano, grande) y opción sin línea visible.
🔘
Button
Botón con estilos Primary, Secondary, Success, Danger o Link. Soporta emoji y label.
📋
Action Row
Fila de hasta 5 botones o 1 menú desplegable alineados horizontalmente.
🖼️
Thumbnail
Imagen pequeña que aparece como accesorio en una Section, alineada a la derecha del texto.

Flujo de trabajo

1
Construir el mensaje
Arrastra y configura los componentes en el constructor visual. El panel muestra una vista previa en tiempo real del resultado.
2
Seleccionar canal y servidor
Elige el servidor y el canal de destino desde los selectores de la barra superior del constructor.
3
Enviar
Pulsa "Enviar mensaje". El bot publicará el mensaje con todos los componentes en el canal seleccionado.
💡 Components V2 requiere que el bot tenga el permiso Usar componentes premium y que el servidor tenga activa la opción de mensajes de componentes avanzados en Discord.

/ Slash Commands

Comandos de barra disponibles en todos los servidores. Se activan escribiendo / en cualquier canal.

ComandoDescripciónCategoría
banBanea a un usuario con razón y duración opcional.Moderación
unbanDesbanea a un usuario por ID.Moderación
kickExpulsa a un usuario del servidor.Moderación
muteSilencia temporalmente a un usuario (timeout).Moderación
unmuteQuita el silencio a un usuario.Moderación
warnAñade una advertencia con historial por servidor.Moderación
warnsVer el historial de warns de un usuario.Moderación
purgeElimina mensajes en masa de un canal.Moderación
ticketAbre un ticket de soporte.Tickets
giveawayCrea un sorteo con duración y premio.Sorteos
dashboardObtén el link directo al panel de administración.General
pingLatencia del bot y WebSocket en tiempo real.General
userinfoInformación detallada sobre un usuario.General
serverinfoEstadísticas y detalles del servidor actual.General
avatarMuestra el avatar de un usuario en alta resolución.General
rankMuestra la tarjeta de rango y XP actual de un usuario.Leveling
leaderboardMuestra el top de usuarios con más XP del servidor.Leveling

! Prefix Commands

Comandos clásicos de prefijo. El prefijo por defecto es ! — puede variar según la configuración del servidor.

ComandoDescripciónCategoría
playReproduce música desde YouTube, Spotify y más.Música
skipSalta a la siguiente canción en cola.Música
stopDetiene la reproducción y vacía la cola.Música
queueMuestra la cola de canciones actual.Música
volumeAjusta el volumen (0-100).Música
balanceConsulta tu saldo de monedas.Economía
dailyRecoge tu recompensa diaria.Economía
workTrabaja para ganar monedas.Economía
robIntenta robar monedas a otro usuario.Economía
payTransfiere monedas a otro usuario.Economía
triviaInicia un juego de trivia interactivo.Diversión
wordleJuega al Wordle en español.Diversión
memeObtén un meme aleatorio.Diversión
snipeMuestra el último mensaje eliminado del canal.Utilidad
stealRoba un emoji de otro servidor.Utilidad
timerInicia un temporizador con alerta al terminar.Utilidad
adivinaJuego de adivinar el número.Diversión
petCuida a tu mascota virtual.Diversión

📊 Guía del Panel Web

El dashboard de Exodus en dashboard.exodus-panel.xyz es el centro de control de tu servidor. Aquí tienes una guía rápida de cada sección.

Secciones del panel (admin de servidor)

SecciónQué puedes hacer
📊 EstadísticasVer miembros, canales, roles, boosts y actividad del servidor en tiempo real.
⌨ ComandosVer todos los comandos disponibles para tu servidor.
⚑ AccionesEjecutar ban, kick, mute y otras acciones directamente desde el panel.
⚠ WarnsVer y gestionar el historial de advertencias de todos los usuarios.
📋 LogsHistorial completo de acciones de moderación con filtros.
⚙ Logs de AuditoríaConfigurar qué eventos del servidor se registran y en qué canal.
🛡️ AutomodActivar módulos de moderación automática, configurar límites, whitelists y filtro de palabras.
🛡 AntinukeProteger el servidor de nukes con módulos individuales, whitelist y Extra Owners.
🎭 Auto-RolConfigurar roles automáticos para nuevos miembros y bots.
🎫 TicketsConfiguración completa del sistema de soporte.
🎉 SorteosCrear y gestionar sorteos activos y finalizados.
⧉ Components V2Enviar mensajes interactivos con el nuevo sistema de componentes de Discord.
👋 BienvenidaConfigurar mensajes de entrada y salida con canvas opcional.
⭐ LevelingGestionar XP, niveles, roles de recompensa, multiplicadores y leaderboard.
🤖 Chat IAActivar y personalizar el asistente de IA para el servidor.
⏱ Roles por TiempoAsignar roles después de X tiempo en el servidor.
🕐 Roles TemporalesAsignar roles que expiran automáticamente.
🏆 Hitos de MiembrosPremiar hitos de crecimiento del servidor con roles especiales.
📅 AntigüedadRoles automáticos según el tiempo de permanencia.
🔐 Solo puedes ver y configurar los servidores donde tienes permiso de Administrador. El acceso al panel se verifica con tu cuenta de Discord.

❓ Preguntas frecuentes

¿Exodus es gratuito?
Sí, Exodus es completamente gratuito para agregar y usar. No hay límites artificiales ni funciones bloqueadas por pago en la versión base.
¿Qué hago si el bot no responde a comandos?
Verifica que el bot tiene permisos para leer y enviar mensajes en el canal. Si usas comandos prefix, asegúrate de usar el prefijo correcto (por defecto !). Para slash commands, el bot debe tener el permiso "Usar comandos de aplicación".
¿Por qué no puedo acceder al panel?
Debes tener el permiso de Administrador en el servidor que quieres gestionar, Y el bot debe estar en ese servidor. Si cumples ambas condiciones y sigue sin funcionar, cierra sesión y vuelve a iniciar.
¿La IA recuerda conversaciones anteriores?
La IA recuerda los últimos N mensajes según el parámetro "Contexto" que configures (máximo 20). No recuerda conversaciones de sesiones anteriores a menos que estén dentro de esa ventana de contexto.
¿Cómo obtengo mi API Key de Gemini?
Ve a Google AI Studio, inicia sesión con tu cuenta de Google y crea una nueva API Key. Es gratuita con un límite de uso generoso. Luego introdúcela en el dashboard en la sección Chat IA.
¿Puedo tener el bot en múltiples servidores?
Sí. Exodus funciona en todos los servidores donde lo agregues de forma independiente. Cada servidor tiene su propia configuración de tickets, roles, IA y demás módulos.
¿La música corta o tiene problemas de calidad?
La calidad depende del servidor Lavalink. Si experimentas cortes, verifica que tienes buena conexión a internet y que el bot está en el canal de voz correcto. Puedes usar !stop y volver a reproducir si la cola se atasca.
¿Automod y Antinuke son lo mismo?
Automod se encarga del comportamiento de los miembros: spam, links, palabras prohibidas, menciones masivas, etc. Antinuke protege la estructura del servidor contra ataques destructivos como el borrado masivo de canales o roles. Son sistemas independientes y complementarios.
¿Por qué Antinuke bloqueó a mi bot de administración?
Los bots que realizan acciones administrativas en masa (como bots de roles, bots de backup o bots de gestión) pueden activar los módulos de Antinuke. Solución: añade el bot a la whitelist de Antinuke antes de que realice sus operaciones.
¿El XP del sistema de Leveling se resetea si el bot sale del servidor?
No. El XP se almacena en la base de datos del bot, no en el servidor de Discord. Si vuelves a añadir el bot, todo el progreso previo se recupera automáticamente.