🚀 Introducción

Guía completa de SayuriBot

SayuriBot es un bot de Discord todo-en-uno diseñado para comunidades gaming y anime. Esta guía te enseñará a configurar y usar todas sus funciones desde cero, aunque nunca hayas trabajado con bots antes.

💡

SayuriBot usa comandos de barra (/). Escribe / en cualquier canal y verás la lista de comandos disponibles. Solo los administradores pueden usar comandos de configuración.

Configuración inicial recomendada

Sigue estos pasos en orden para tener el bot completamente configurado:

1

Canales y categorías

Crea los siguientes canales en tu servidor:

#bienvenida          — mensajes de entrada y salida
#cumpleaños          — felicitaciones automáticas
#tickets             — panel de soporte
#transcripciones-tickets — archivo privado
#logs-moderacion     — registro de acciones del staff
#logs-seguridad      — alertas del anti-raid

2

Permisos del bot

Asegúrate de que SayuriBot tenga estos permisos en el servidor:

Gestionar roles

Gestionar canales

Expulsar miembros

Banear miembros

Enviar mensajes

Adjuntar archivos

Leer historial

Conectar (voz)

Hablar (voz)

⚠️

El rol de SayuriBot debe estar por encima de los roles que va a asignar en la lista de roles del servidor.

3

Configuración básica

/setwelcome canal:#bienvenida
/setbirthday canal:#cumpleaños

🎵 Módulo

Sistema de Música

SayuriBot reproduce música de YouTube con alta calidad de audio, efectos y controles completos directamente desde Discord.

/play cancion:[búsqueda o URL] Todos

Reproduce una canción o la añade a la cola. Debes estar en un canal de voz.

/play cancion:Daft Punk Get Lucky
/play cancion:https://youtube.com/watch?v=...

Controles del reproductor

Cuando una canción está sonando aparecen botones de control automáticamente:

⏮Canción anterior

🔀Mezclar cola

⏸ / ▶Pausar / Reanudar

⏭Siguiente canción

⏹Detener y salir

🔄Repetir canción

🔉Bajar volumen 10%

🔊Subir volumen 10%

📋Ver cola

✨Efectos de audio

Efectos de audio

Al pulsar ✨ aparece un menú con 8 efectos:

Efecto	Descripción
Sin efecto	Desactiva todos los efectos
🎸 Bass Boost	Potencia los graves
🌙 Nightcore	Más rápido y agudo
🎧 8D Audio	Sonido envolvente 360°
🌊 Vaporwave	Más lento y profundo
📻 Karaoke	Reduce la voz principal
🎵 Soft	Suaviza el sonido
🔊 Loud	Aumenta la potencia

⭐ Módulo

Sistema de XP y Rangos

Los usuarios ganan XP al participar en el servidor y suben de nivel automáticamente, desbloqueando rangos y roles.

¿Cómo se gana XP?

Actividad	XP	Notas
💬 Mensajes	15–25 XP	Cooldown de 60 segundos para evitar spam
🎤 Voz	XP / minuto	Por estar en canal de voz activo
⭐ Reacciones	XP variable	Por recibir reacciones en mensajes

Rangos por defecto

SayuriBot incluye 10 rangos de temática anime/RPG asignados automáticamente:

無名

Mumei

Sin nombre

Lv. 1+

見習

Minarai

Aprendiz

Lv. 6+

侍

Samurai

Guerrero

Lv. 16+

忍者

Shinobi

Ninja

Lv. 26+

剣士

Kenshi

Espadachín

Lv. 36+

魔道士

Madoshi

Mago

Lv. 46+

武神

Bujin

Dios guerrero

Lv. 56+

龍騎士

Ryukishi

Caballero dragón

Lv. 71+

神話

Shinwa

Mitología

Lv. 86+

神

Kami

Dios

Lv. 100+

Comandos de usuario

/rank [usuario]Todos

Muestra la tarjeta visual de rango con XP, nivel, rango actual y estadísticas. Si no especificas usuario, muestra el tuyo.

/leaderboardTodos

Muestra el ranking visual de los 10 usuarios con más XP del servidor.

Personalización de rangos

/rank-config verAdmin

Muestra todos los rangos configurados actualmente en el servidor.

/rank-config añadirAdmin

Crea un nuevo rango personalizado. Parámetros: nivel, nombre, rol (opcional), romaji (opcional), color (opcional).

/rank-config añadir nivel:1 nombre:Novato rol:@Novato color:#888780
/rank-config añadir nivel:10 nombre:Veterano rol:@Veterano color:#378ADD

💡

Si el rol no existe en Discord, el bot lo creará automáticamente con el color que especifiques.

/rank-config eliminarAdmin

Elimina un rango por su nivel mínimo.

/rank-config eliminar nivel:10

/rank-config resetearAdmin

Vuelve a los rangos de muestra originales (Mumei, Samurai, etc.). Útil para empezar de cero.

Roles especiales

Roles que el bot ignora al gestionar XP. Úsalos para moderación, VIP, boosters, etc.

/roles-especiales añadirAdmin

/roles-especiales añadir rol:@Moderador descripcion:Staff del servidor
/roles-especiales añadir rol:@VIP descripcion:Miembros premium

/roles-especiales ver / quitarAdmin

Ver todos los roles especiales configurados o desmarcar uno existente.

🎉 Módulo

Bienvenida y Despedida

SayuriBot envía tarjetas visuales cuando alguien entra o sale del servidor, con avatar, nombre y estadísticas.

/setwelcome canal:[#canal]Admin

Configura el canal donde aparecerán los mensajes de bienvenida y despedida.

/setwelcome canal:#bienvenida

¿Qué incluyen las tarjetas?

Tarjeta de bienvenida

• Avatar del usuario

• Nombre de usuario

• Número de miembro (ej: Miembro #247)

• Rango inicial asignado

Tarjeta de despedida

• Avatar del usuario

• Nombre de usuario

• Días que estuvo en el servidor

• Último nivel alcanzado

💡

Cuando un nuevo miembro entra, SayuriBot le asigna automáticamente el rango de nivel 1. Si ese rango tiene un rol vinculado, el bot asignará ese rol. Si el rol no existe, lo creará automáticamente.

🎂 Módulo

Sistema de Cumpleaños

SayuriBot felicita automáticamente a los miembros en su cumpleaños con una tarjeta visual personalizada.

/setbirthday canal:[#canal]Admin

Configura el canal donde aparecerán las felicitaciones de cumpleaños.

/setbirthday canal:#cumpleaños

/birthday set fecha:[DD/MM]Todos

Registra tu fecha de cumpleaños. Solo necesitas hacerlo una vez.

/birthday set fecha:25/12

/birthday ver [usuario]Todos

Muestra la fecha de cumpleaños de un usuario y cuántos días faltan.

/birthday listaTodos

Muestra los próximos cumpleaños del servidor.

💡

El bot revisa cada día a medianoche quién cumple años ese día y envía automáticamente una tarjeta de felicitación en el canal configurado.

📊 Módulo

Estadísticas del Servidor

Crea canales de voz que muestran estadísticas del servidor en tiempo real, actualizándose automáticamente cada 30 minutos.

Tipos disponibles

Tipo	Descripción
👥 Total de miembros	Número total de miembros en el servidor
🟢 Miembros online	Miembros actualmente conectados
👤 Humanos	Miembros que no son bots
🤖 Bots	Número de bots en el servidor

/stats-config añadir tipo:[tipo]Admin

Crea un canal de voz con el contador seleccionado. Ejemplo para crear todos:

/stats-config añadir tipo:👥 Total de miembros
/stats-config añadir tipo:🟢 Miembros online
/stats-config añadir tipo:👤 Humanos
/stats-config añadir tipo:🤖 Bots

💡

Crea una categoría en Discord llamada 📊 Estadísticas y mueve los canales ahí para mejor organización.

/stats-config eliminar / verAdmin

Elimina un canal de estadísticas existente o ve todos los canales activos.

🎫 Módulo

Sistema de Tickets

Permite a los usuarios abrir solicitudes de soporte privadas con el staff, con transcripciones automáticas y categorías personalizables.

Configuración inicial

1

Crear categorías de tickets

/ticket-categoria añadir nombre:Soporte descripcion:Ayuda general emoji:🎫
/ticket-categoria añadir nombre:Reporte descripcion:Reportar usuarios emoji:🚨
/ticket-categoria añadir nombre:Apelación descripcion:Apelar una sanción emoji:⚖️

2

Asignar staff

/ticket-staff añadir usuario:@Moderador1
/ticket-staff añadir usuario:@Moderador2

3

Configurar categoría de Discord

/ticket-setup categoria-discord categoria:#Tickets

4

Configurar transcripciones

/ticket-setup transcripciones canal:#transcripciones-tickets

5

Enviar el panel

/ticket-setup panel canal:#tickets

¿Cómo funciona para los usuarios?

1

El usuario va al canal de tickets y ve el panel con un menú desplegable

2

Selecciona el tipo de ticket que necesita

3

Se crea un canal privado visible solo para el usuario y el staff

4

El staff recibe una notificación y puede atender el ticket

5

Al cerrar, se guarda la transcripción automáticamente y el canal se elimina

Comandos dentro de un ticket

/ticket-cerrarStaff + dueño

Cierra el ticket actual. Pide confirmación antes de cerrar y genera una transcripción automática.

/ticket-reclamarStaff

El staff se asigna el ticket para indicar que lo está atendiendo.

/ticket-añadir usuario:[@usuario]Staff

Añade a alguien más al ticket privado.

🛡️ Módulo

Moderación

Herramientas completas de moderación para mantener el orden en el servidor, con registro automático de todas las acciones.

/ban usuario: razon: duracion:[días]Mods+

Banea a un usuario del servidor. La duración es opcional.

/ban usuario:@Usuario razon:Spam reiterado duracion:7

/kick usuario: razon:Mods+

Expulsa a un usuario del servidor. Puede volver con una nueva invitación.

/timeout usuario: duracion:[minutos] razon:Mods+

Silencia temporalmente a un usuario. No puede escribir ni hablar durante el tiempo indicado.

/timeout usuario:@Usuario duracion:30 razon:Lenguaje inapropiado

/warn usuario: razon:Mods+

Registra una advertencia para el usuario. Las advertencias quedan guardadas permanentemente.

/warnings usuario:Mods+

Muestra el historial completo de advertencias de un usuario.

/unwarn usuario: id:[número]Mods+

Elimina una advertencia específica del historial de un usuario.

/clear cantidad:[1-100]Mods+

Elimina los últimos X mensajes del canal.

/clear cantidad:50

/slowmode segundos:[0-21600]Mods+

Activa el modo lento. Los usuarios deben esperar X segundos entre mensajes. Usa 0 para desactivarlo.

/lockdownMods+

Bloquea el canal actual para que nadie pueda escribir. Ideal para situaciones de emergencia.

/setmod canal:[#canal]Admin

Configura el canal donde el bot enviará los logs de moderación.

Auto-moderación

SayuriBot puede moderar automáticamente sin intervención del staff:

Función	Descripción
Anti-spam	Detecta y silencia usuarios que envían mensajes muy rápido
Anti-links	Elimina mensajes con enlaces no autorizados
Filtro de palabras	Elimina mensajes con palabras prohibidas

💡

Los administradores, moderadores y el dueño del servidor están exentos del auto-mod automáticamente.

⚡ Módulo

SayuriShield — Anti-Raid

Sistema de seguridad avanzado que detecta y neutraliza raids, ataques de bots e intentos de destruir el servidor mediante un motor de puntuación de amenaza.

/shield activarAdmin

Activa el sistema SayuriShield en el servidor.

Configuración recomendada

1

Crear el rol de cuarentena

Crea un rol llamado 🔒 Cuarentena en Discord sin ningún permiso. Este rol se asignará a usuarios sospechosos.

2

Crear el canal de verificación

Crea un canal #verificacion visible solo para el rol de cuarentena.

3

Configurar SayuriShield

/shield logs canal:#logs-seguridad
/shield quarantine rol:@Cuarentena canal:#verificacion

4

Ajustar parámetros (opcional)

/shield config edad-minima:7 umbral-joins:5 ventana:10 score:60

Modos de protección

🟢 Normal

Solo monitorea y envía alertas al canal de logs. No toma acciones automáticas.

Cuándo usarlo: Día a día normal.

🟡 Alerta

Usuarios sospechosos son puestos en cuarentena automáticamente y deben verificarse.

Cuándo usarlo: Cuando detectas actividad inusual.

🔴 Lockdown

El servidor se bloquea. Las invitaciones se desactivan y los nuevos miembros sospechosos van a cuarentena.

Cuándo usarlo: Durante un raid activo.

⚫ Pánico

Todos los nuevos miembros son expulsados automáticamente. El servidor queda cerrado.

Cuándo usarlo: Solo en emergencias extremas.

/shield modo modo:🟢 Normal
/shield modo modo:🔴 Lockdown

Sistema de puntuación de amenaza

Cada usuario que entra recibe una puntuación (0–100). Si supera el umbral (por defecto 60), va a cuarentena:

Factor	Puntos
Cuenta creada hace menos de 24h	+50
Cuenta creada hace menos de 7 días	+35
Cuenta menor a 30 días	+15
Sin avatar de perfil	+20
Nombre de usuario sospechoso	+15
Varias cuentas creadas el mismo día	+25
Muchos usuarios entrando a la vez	+30

Anti-Nuke

Monitorea y detiene acciones destructivas masivas incluso por parte de administradores comprometidos:

🚨

Si detecta eliminación masiva de canales/roles, baneos en masa o webhooks maliciosos, revoca automáticamente los permisos del usuario responsable y envía una alerta.

Whitelist

/shield whitelistAdmin

Añade usuarios o roles de confianza que el shield nunca tocará.

/shield whitelist accion:Añadir usuario usuario:@Admin
/shield whitelist accion:Añadir rol rol:@Staff

/shield estado / incidentesAdmin

/shield estado muestra el estado completo del shield. /shield incidentes muestra los últimos 10 incidentes registrados.

📋 Referencia

Todos los Comandos

Referencia rápida de todos los comandos organizados por módulo.

🎵 Música

Comando	Descripción	Quién
/play cancion:	Reproducir música	Todos

⭐ XP y Rangos

Comando	Descripción	Quién
/rank [usuario]	Ver tarjeta de rango	Todos
/leaderboard	Ver ranking del servidor	Todos
/rank-config ver	Ver rangos configurados	Admins
/rank-config añadir	Crear rango personalizado	Admins
/rank-config eliminar	Eliminar un rango	Admins
/rank-config resetear	Volver a rangos por defecto	Admins
/roles-especiales añadir	Marcar rol como especial	Admins
/roles-especiales quitar	Desmarcar rol especial	Admins
/roles-especiales ver	Ver roles especiales	Admins

🎉 Bienvenida y Eventos

Comando	Descripción	Quién
/setwelcome canal:	Canal de bienvenida/despedida	Admins
/setbirthday canal:	Canal de cumpleaños	Admins
/birthday set fecha:	Registrar cumpleaños	Todos
/birthday ver [usuario]	Ver cumpleaños	Todos
/birthday lista	Próximos cumpleaños	Todos

📊 Estadísticas

Comando	Descripción	Quién
/stats-config añadir	Crear canal de estadísticas	Admins
/stats-config eliminar	Eliminar canal de estadísticas	Admins
/stats-config ver	Ver canales activos	Admins

🎫 Tickets

Comando	Descripción	Quién
/ticket-setup panel	Enviar panel de tickets	Admins
/ticket-setup transcripciones	Canal de transcripciones	Admins
/ticket-categoria añadir	Crear tipo de ticket	Admins
/ticket-categoria eliminar	Eliminar tipo de ticket	Admins
/ticket-staff añadir	Añadir staff de tickets	Admins
/ticket-staff quitar	Quitar staff de tickets	Admins
/ticket-cerrar	Cerrar ticket	Staff + dueño
/ticket-reclamar	Reclamar ticket	Staff
/ticket-añadir usuario:	Añadir usuario al ticket	Staff

🛡️ Moderación

Comando	Descripción	Quién
/ban usuario: razon:	Banear usuario	Mods+
/kick usuario: razon:	Expulsar usuario	Mods+
/timeout usuario: duracion:	Silenciar temporalmente	Mods+
/warn usuario: razon:	Advertir usuario	Mods+
/warnings usuario:	Ver advertencias	Mods+
/unwarn usuario: id:	Quitar advertencia	Mods+
/clear cantidad:	Eliminar mensajes	Mods+
/slowmode segundos:	Modo lento	Mods+
/lockdown	Bloquear canal	Mods+
/setmod canal:	Canal de logs mod	Admins

⚡ SayuriShield

Comando	Descripción	Quién
/shield activar	Activar el shield	Admins
/shield desactivar	Desactivar el shield	Admins
/shield modo modo:	Cambiar modo de protección	Admins
/shield config	Configurar parámetros	Admins
/shield logs canal:	Canal de alertas	Admins
/shield quarantine rol:	Rol de cuarentena	Admins
/shield whitelist	Gestionar whitelist	Admins
/shield estado	Ver estado del shield	Admins
/shield incidentes	Ver últimos incidentes	Admins

❓ FAQ

Preguntas Frecuentes

Respuestas a las dudas más comunes sobre SayuriBot.

¿Por qué el bot no responde a mis comandos? ▼

Verifica que el bot tenga permisos para leer y enviar mensajes en ese canal. También asegúrate de usar el comando correcto con /. Si el problema persiste, comprueba que el bot esté online.

¿Por qué la música se corta? ▼

Puede ser por la conexión a internet del servidor. El bot intentará reconectarse automáticamente. Si persiste, usa /play de nuevo para reiniciar la reproducción.

¿Por qué no se asigna el rol de rango automáticamente? ▼

El rol de SayuriBot debe estar por encima de los rangos en la lista de roles del servidor. Ve a Configuración → Roles y arrastra el rol de SayuriBot hacia arriba.

¿Puedo tener más de un tipo de ticket? ▼

Sí, puedes crear todas las categorías que necesites con /ticket-categoria añadir. Cada categoría puede tener su propio emoji, nombre y descripción.

¿Las transcripciones de tickets son privadas? ▼

Sí. Solo el staff asignado con /ticket-staff añadir puede ver el canal de transcripciones. El canal donde las guardas debe tener los permisos correctos configurados.

¿El anti-raid afecta a los miembros normales? ▼

Solo si su cuenta es nueva o sospechosa según el sistema de puntuación. Los miembros existentes no se ven afectados. Puedes añadir miembros de confianza a la whitelist con /shield whitelist.

¿Cómo desactivo el shield si bloqueó erróneamente a alguien? ▼

Usa /shield whitelist accion:Añadir usuario usuario:@persona para que el shield nunca les afecte, y luego quita manualmente el rol de cuarentena desde el panel de Discord.

🌸

¿Necesitas más ayuda?

Abre un ticket en nuestro servidor de soporte de Discord y te ayudaremos.