Documentación de Kyrina
Aprende a configurar cada módulo, permisos de roles y mensajes personalizados para tu comunidad.
1. Guía de Inicio Rápido
Poner en marcha Kyrina en tu comunidad de Discord toma menos de dos minutos. El bot está diseñado sin configuraciones complejas en la consola de comandos: toda la administración se realiza a través del panel web.
Invita a Kyrina
Añade la bot a tu servidor mediante el enlace oficial con los permisos recomendados.
Accede al Panel Web
Inicia sesión de forma segura con Discord para ver la lista de servidores donde eres administrador.
Activa tus Módulos
Selecciona los canales de bienvenida, activa el sistema de niveles y define el canal de registros.
Guarda y Simula
Haz clic en "Guardar Cambios" y utiliza el botón de simulación para verificar el envío a Discord.
2. Posición y Orden de Roles en Discord
Discord tiene una regla sencilla: el rol de Kyrina debe estar por encima de los roles que quieras que asigne o modere. Si un rol está arriba del bot, Discord no le permitirá gestionarlo.
En Discord ve a Ajustes del Servidor → Roles y arrastra el rol llamado Kyrina hacia arriba, justo debajo de tu rol de Administrador Principal o Dueño. De este modo podrá otorgar roles automáticos y moderar sin bloqueos de permisos.
3. Módulo de Bienvenidas Gráficas
El módulo de bienvenidas genera una imagen renderizada en Canvas combinando el avatar del nuevo usuario, un fondo personalizado y un texto dinámico con el número total de miembros.
Formatos de Entrega Soportados
- Texto + Tarjeta Gráfica: Envía el mensaje de bienvenida con mención directa y adjunta la tarjeta debajo.
- Embed con Tarjeta: Envía un contenedor estilizado con título, descripción y la imagen generada.
- Solo Tarjeta: Publica únicamente la tarjeta gráfica para mantener el chat limpio y minimalista.
- Solo Texto: Notificación ligera sin procesamiento de imagen.
{
"enabled": true,
"channelId": "119876543210987654",
"message": "¡Hola {user}, bienvenido/a a **{server}**! Eres nuestro miembro #{memberCount}.",
"autoRoleId": "119876543210987655",
"cardTheme": "dark_modern",
"customBackgroundUrl": "https://i.imgur.com/example.png"
}4. Sistema de Niveles & XP
Fomenta la participación activa premiando la actividad de texto y voz. Kyrina calcula la experiencia mediante una curva progresiva para evitar el abuso de mensajes repetitivos.
Protección Anti-Spam de XP
Cooldown automático de 60 segundos entre mensajes. Los mensajes con menos de 3 caracteres no otorgan puntos.
Recompensas de Roles
Asigna automáticamente roles como @Veterano al nivel 10 o @Leyenda al nivel 25 sin intervención manual.
5. Registros de Auditoría (Logs)
Kyrina monitoriza de forma transparente eventos de seguridad y los envía a tu canal privado de administración a través de webhooks dedicados con latencia menor a 15ms.
Eventos Monitoreados
6. Variables y Placeholders Dinámicos
Utiliza estas variables en tus plantillas de mensajes de bienvenida, notificaciones de nivel o mensajes de despedida. Se reemplazarán en tiempo de ejecución.
{user}Menciona al usuario en Discord (@Nombre).
{username}Nombre de usuario plano sin etiqueta de mención.
{server}Nombre actual del servidor de Discord.
{memberCount}Número total de miembros en el servidor.
7. Preguntas Frecuentes
?¿Por qué Kyrina no envía las tarjetas de bienvenida?
La bot requiere el permiso 'Adjuntar Archivos' (Attach Files) y 'Ver Canal' en el canal seleccionado. Además, asegúrate de activar el interruptor del módulo y hacer clic en 'Guardar Cambios' en la barra superior del panel.
?¿Cómo configuro a la bot para que no haga spam en el chat general al subir de nivel?
En la pestaña de 'Niveles' del Panel de Control, puedes cambiar la opción de 'Canal del anuncio' a un canal específico (por ejemplo, #niveles o #comandos) en lugar del canal actual donde el usuario chatea.
?¿Qué resolución se recomienda para los fondos personalizados de bienvenidas?
La resolución ideal es 1024x500 píxeles o formato panorámico 2:1 en formato JPG, PNG o WebP de hasta 4MB.
?¿Cómo funcionan los comandos de barra diagonal (/)?
Kyrina funciona con los comandos / de Discord. Solo escribe '/' en cualquier canal para ver la lista completa con autocompletado y la explicación de cada función.