Centro de Ayuda & Arquitectura
Guías oficiales, tutoriales y referencia técnica para dominar la gamificación y el motor XP de ApexRank en Discord.
¿Qué es ApexRank y cómo funciona el motor XP?
¿Qué es ApexRank? ApexRank es el motor de gamificación y economía de nueva generación de BotNexus para servidores de Discord. Diseñado para transformar comunidades pasivas en ecosistemas altamente competitivos, premia el valor real aportado por los usuarios mediante puntos XP, economía virtual, rachas de actividad y minijuegos interactivos. Características Principales Motor XP Dinámico — Asignación inteligente de experiencia por actividad en canales de texto y voz, con filtros anti-spam nativos. Economía Virtual Integrada — Moneda propia del servidor para adquirir roles, cosméticos y participar en minijuegos. Casino Premium Nativamente Integrado — 6 juegos interactivos (Blackjack, Plinko, Tragamonedas, Ruleta, Dados y Minas) ejecutados en embeds y botones sin lag. Misiones Diarias y Rachas (Streaks) — Sistema de misiones aleatorias y multiplicadores exponenciales por conexión consecutiva. Tienda de Recompensas (Store) — Recompensas automáticas de roles por nivel y compras de cosméticos o beneficios exclusivos. Analíticas en Tiempo Real — Monitoreo completo del compromiso de tu comunidad desde un panel de control web intuitivo. Arquitectura del Sistema El motor de ApexRank opera de forma asíncrona mediante observadores de eventos optimizados en tiempo real, garantizando un impacto nulo en la latencia del servidor de Discord y un 99.9% de Uptime SLA.
Cómo invitar y configurar ApexRank en tu servidor
Despliegue Rápido de ApexRank Poner en marcha ApexRank en tu servidor toma menos de 2 minutos siguiendo este proceso: 1. Autorización e Invitación Haz clic en el botón de instalación o inicia sesión con tu cuenta de Discord en el portal web. Selecciona el servidor de Discord donde deseas desplegar el bot (requieres permisos de Administrador o Gestionar Servidor). Autoriza los permisos solicitados. El bot se unirá instantáneamente a tu comunidad. 2. Configuración en el Dashboard Web Accede al panel de control en /dashboard. Define la tasa base de XP por mensaje de chat y por minuto en canales de voz. Configura el canal de anuncios de subida de nivel (Level Up Notifications) para celebrar los logros de tus miembros.
Permisos de Discord y seguridad del bot
Seguridad y Transparencia de Permisos ApexRank se adhiere a estrictos estándares de seguridad y principio de menor privilegio. Nunca leemos contenido de mensajes privados ni almacenamos datos sensibles. Permisos Necesarios y su Justificación Ver Canales & Enviar Mensajes: Necesario para detectar actividad en el chat y enviar notificaciones de subida de nivel o respuestas de casino. Gestionar Roles: Imprescindible para otorgar automáticamente roles de recompensa al alcanzar niveles específicos o al comprar en la tienda. Conectar & Hablar (Voz): Utilizado para monitorear el tiempo de permanencia en canales de voz y otorgar XP de audio de forma justa. Usar Emoticonos Externos: Requerido para renderizar la interfaz gráfica del casino y las medallas de nivel con máxima calidad visual.
Sistema de Niveles, Roles por Nivel y Multiplicadores
Motor de Experiencia y Recompensas El sistema de niveles es el núcleo del compromiso en ApexRank, motivando a la comunidad mediante reconocimiento progresivo. Cálculo de XP y Anti-Spam Para evitar el farmeo artificial de mensajes cortos o repetitivos, el motor XP implementa un enfriamiento interno (cooldown) y analiza la longitud y relevancia del mensaje. Por defecto, un mensaje estándar otorga entre 15 y 25 XP cada minuto. Roles de Recompensa Automáticos Puedes vincular roles de Discord a niveles específicos desde la pestaña de Roles de Nivel en el dashboard. Cuando un usuario alcanza el nivel requerido, el bot le asigna el rol instantáneamente sin intervención manual. Puedes elegir entre acumular los roles anteriores o reemplazarlos progresivamente.
Monedas, Tienda de Recompensas y Compras
Economía Virtual Integrada Además de la experiencia, los usuarios ganan monedas virtuales participando en el chat, completando misiones diarias y ganando en los juegos de casino. La Tienda de Recompensas (Store) Desde el panel de administración puedes crear ítems personalizados que los usuarios pueden comprar con sus monedas ganadas: Roles Exclusivos: Permite comprar roles cosméticos, roles VIP o accesos a canales privados. Multiplicadores de XP temporales: Ítems que aceleran la ganancia de XP durante 24 horas o una semana. Emblemas y Cosméticos para el Perfil: Insignias personalizadas que adornan la tarjeta de nivel del usuario en Discord.
Misiones Diarias y Rachas de Actividad (Streaks)
Gamificación Diaria y Retención El sistema de misiones diarias genera objetivos aleatorios para cada usuario cada 24 horas, incentivando una conexión constante y variada. Ejemplos de Misiones Generadas "Envía 50 mensajes en canales de texto generales" "Permanece 30 minutos en cualquier canal de voz" "Juega 5 partidas en la Ruleta del casino" Multiplicadores por Racha (Streaks) Los usuarios que completan al menos una actividad diaria aumentan su contador de racha (Streak). Cada día consecutivo aplica un multiplicador extra a la ganancia de XP y monedas, alcanzando hasta un +50% de bonificación en rachas de 7 días o superiores.
Guía de los 6 Juegos de Casino en Discord
El Casino Web & Discord más Avanzado ApexRank incluye una suite de 6 minijuegos de casino AAA completamente integrados mediante componentes nativos de Discord (botones y selectores) sin requerir descargas externas. Los 6 Minijuegos Disponibles 🃏 Blackjack Interactivo: Enfréntate al crupier con botones en tiempo real para Pedir (Hit), Plantarse (Stand) o Doblar (Double). 🔺 Plinko Pirámide: Deja caer la bola por el tablero de clavos y multiplica tu apuesta según el casillero final donde caiga. 🎰 Tragamonedas 5x3 (Slots): Tiradas con rodillos visuales, comodines y líneas de premio de alta retribución. 🎡 Ruleta de la Fortuna: Apuestas a colores (Rojo/Negro), números exactos o pares/impares con animación de giro. 🎲 Dados Clásicos (Dice): Predice si el resultado del lanzamiento será mayor o menor con multiplicador de cuota ajustable. 💣 Buscaminas (Mines): Destapa casillas en un campo minado para ir aumentando el multiplicador de retiro (Cashout) paso a paso.
Configuración de Apuestas, Límites y Casa
Control Económico y Límites de Apuesta Como administrador del servidor, mantienes control absoluto sobre la economía del casino para evitar la inflación descontrolada de la moneda virtual. Ajustes Recomendados en el Dashboard Apuesta Mínima y Máxima: Define límites claros por tirada para evitar que los nuevos miembros apuesten todo de golpe. Límite de Ganancia Diaria: Establece un tope máximo de beneficios de casino por usuario cada 24 horas. Canales Permitidos: Restringe el uso de comandos y juegos de casino exclusivamente a canales dedicados de entretenimiento (ej: #👑-casino-lounge) para mantener el orden en tu chat general.
Economía Balanceada y Prevención de Abuso
Juego Limpio y Seguridad Antifrande Todos los algoritmos de generación de resultados en el casino de ApexRank utilizan generadores de números aleatorios criptográficamente seguros (CSPRNG), garantizando una equidad matemática verificable. Medidas Anti-Abuso Detección de Bots y Alertas: El sistema bloquea automáticamente intentos de automatización mediante macros o auto-clickers en los botones del casino. Auditoría de Transacciones: El panel web registra todas las jugadas, apuestas y transferencias de monedas entre usuarios para que los administradores puedan investigar anomalías en la economía.
¿Por qué los usuarios no reciben XP en chat o voz?
Diagnóstico de Problemas con la XP Si tus miembros no están acumulando experiencia al participar, verifica los siguientes puntos críticos de configuración: Lista de Verificación (Checklist) Canales Excluidos: Asegúrate de que el canal de texto o voz no esté marcado en la lista negra (Blacklist) de canales sin XP dentro del panel web. Permisos del Bot: Verifica que el rol del bot de ApexRank tenga permisos para Ver Canal y Leer Historial de Mensajes en esa categoría. Enfriamiento (Cooldown) Activo: Recuerda que si un usuario envía muchos mensajes seguidos, el filtro anti-spam pausará temporalmente la ganancia de XP durante 60 segundos. Estado de Mute/Deaf en Voz: Por razones de equidad, los usuarios ensordecidos (Deafened) o silenciados (Muted) en canales de voz no reciben XP de audio.
El bot no responde a comandos o botones del casino
Solución a Interacciones Fallidas Si al pulsar un botón del casino o ejecutar un comando de barra (Slash Command) aparece el error "La interacción ha fallado", aplica estas soluciones: Pasos de Resolución Resincronización de Comandos: En el dashboard de ApexRank, ve a la sección de Ajustes y pulsa el botón Recargar Comandos Slash. Esto fuerza una actualización instantánea con la API de Discord. Permisos de Interacción: El bot requiere el permiso de Usar Comandos de Aplicación (Use Application Commands) activado en los ajustes de integración del servidor. Canal Arhivado o Bloqueado: Verifica que el hilo o canal donde se juega no esté archivado ni en modo de solo lectura para el bot.
Reseteo de Temporadas y Gestión de Respaldo de Datos
Gestión de Temporadas y Respaldos Mantén tu comunidad competitiva reiniciando las tablas de clasificación periódicamente o respaldando tus configuraciones de economía. Cómo iniciar una Nueva Temporada En el panel web, navega a Administración de Comunidad → Temporadas. Haz clic en "Iniciar Nueva Temporada". Puedes optar por resetear únicamente la XP de temporada manteniendo intacta la XP histórica (Prestigio) y los saldos de monedas del casino. El sistema generará automáticamente un archivo de exportación en PDF/JSON con el Salón de la Fama de la temporada anterior para anunciarlo en tu servidor.