Mapa de Conexiones del Bot
Nyxian está diseñado como un **ecosistema integrado**. Las acciones de los usuarios en un módulo (como minar o boostear) alimentan el progreso en la economía, los clanes, el ranking de nivel y las batallas de Raids.
graph TD
classDef default fill:#1a1c26,stroke:#2d3142,color:#f5f6f8;
classDef base fill:#003c80,stroke:#0084ff,color:#fff,stroke-width:2px;
classDef econ fill:#5c3a00,stroke:#cca000,color:#fff;
classDef rpg fill:#321154,stroke:#8639e6,color:#fff;
classDef com fill:#0f4c3a,stroke:#2ed573,color:#fff;
Roblox[Vinculación Roblox OAuth2]:::base -->|Asigna Roles de Grupo| Roles[Roles de Discord]
Roles -->|Activa Beneficios| Economia[Economía Central]:::econ
Economia -->|Comprar Objetos/Picos| Tienda[Tienda del Servidor]:::econ
Economia -->|Apuestas & Llaves| Casino[Casino y Lootboxes]:::econ
Economia -->|Fondos de Clan| Clanes[Clanes y Mejoras]:::econ
Mineria[Sistema de Minería]:::rpg -->|Vender Minerales| Economia
Mineria -->|Recetas de Forja| Crafteo[Recetas & Crafteos]:::rpg
Mineria -->|Materiales de Equipo| Armeria[Armería & Estadísticas]:::rpg
Armeria -->|Armas & Armaduras| Raids[Raids & Jefes Cooperativos]:::rpg
Raids -->|Botín Exclusivo| Crafteo
Raids -->|Premios en Dinero| Economia
Niveles[Niveles y XP por Chat/Voz]:::com -->|Recompensas por Nivel| Roles
Boosts[Anuncio de Booster]:::com -->|Agradecimientos| CanvasEmbed[Canvas Embed Builder]:::com
Starboard[Starboard Muro de la Fama]:::com -->|Destaca Mensajes| CanvasEmbed
¿Cómo se conectan los sistemas principales?
1. De Roblox al Servidor
Al usar /vincular, Nyxian verifica tu cuenta oficial de Roblox vía OAuth2. Detecta tus rangos de grupo y te asigna los roles correspondientes en Discord de forma automática.
2. Ciclo Minero y Economía
Extraes minerales con /mine y los vendes para ganar saldo. Con ese dinero compras picos superiores, mejoras los almacenes de tu Clan o juegas en el Casino.
3. De la Forja a las Raids
Forjas armaduras y espadas en la cocina de recetas. Al equiparlas en tu /inventario, aumentas tu ataque y defensa para vencer Jefes de Raid en equipo.
Módulos de Comunidad
Bienvenidas y Despedidas Interactiva
Publica un mensaje automático cuando alguien entra o sale del servidor. Puedes personalizar el contenido usando el **Canvas Embed Builder** desde el Panel Web y emplear variables como {mencion}, {usuario}, {servidor} y {miembros}.
Anuncios de Server Boost
Celebra a los miembros que impulsan tu servidor. Nyxian detecta automáticamente los boosts de Discord y manda una tarjeta de agradecimiento en el canal que configures en la Dashboard.
Starboard (Muro de la Fama)
Destaca las mejores imágenes o frases del servidor. Cuando un mensaje alcanza la cantidad mínima de reacciones configurada (ej. 3 ⭐), Nyxian lo copia y lo publica en el canal del Starboard.
Minijuego de Conteo en Cadena
Juego cooperativo en el que los miembros cuentan consecutivamente (1, 2, 3...). Admite modos como **Clásico**, **Hardcore** (vidas limitadas), **relax**, **pares**, **impares**, **binario**, **hexadecimal** y **matemático**. Se pueden asignar castigos al equivocarse como Mute o Timeout temporal.
Sugerencias y Confesiones Anónimas
Permite a tu comunidad votar propuestas con botones interactivos o enviar confesiones secretas sin revelar la identidad del usuario.
Etiquetas y Comandos de Comunidad
Variables disponibles para Bienvenidas, Despedidas y Boosts:
{usuario} • Nombre de usuario{mencion} • Mención @Usuario{servidor} • Nombre del Servidor{miembros} • Total de miembros{fecha} • Fecha actual{hora} • Hora actual
Comandos Slash
- /starboard • Configura el Starboard desde Discord
- /utilidad sugerencia <texto> • Envía una sugerencia al canal oficial
- /diversion confesion <anonimo> <texto> • Envía una confesión anónima o pública
Economía y Minería RPG
Trabajos y Economía Base
Trabaja periódicamente con /work y reclama tu recompensa diaria con /daily. Guarda tu dinero en el banco con /banco depositar para evitar robos de otros usuarios.
Extracción en las Minas
Ejecuta /mine para picar minerales en tu mina actual. Ganarás XP de minería y recursos valiosos (carbón, hierro, oro, diamantes, rubíes, obsidianas).
La Forja y Recetas de Crafteo
Revisa la lista de fórmulas en /mineria recetas. Usa tus minerales acumulados para craftear picos con mayor durabilidad y velocidad usando /mineria craft <id>.
Mascotas Mineras y Clanes
Equipa mascotas mineras con /mineria mascota para obtener multiplicadores de suerte y velocidad. Crea un clan con /clan crear para compartir recursos y competir en el ranking.
Comandos RPG Básicos
-
/eco balance
Muestra tu saldo en mano y en banco.
-
/mine
Pica minerales en la mina activa.
-
/inventario
Abre tu bolsa de minerales, cofres y herramientas.
-
/mineria mapa
Viaja entre las diferentes zonas mineras desbloqueadas.
-
/mercado ver
Mercado P2P para comerciar ítems entre usuarios.
Armería & Incursiones de Raid
Los minerales más raros forjan equipamiento de combate. Equipa a tu personaje para ingresar a **Raids Cooperativas** y vencer Jefes con salud compartida entre todo el servidor.
Clases de Combate en Raids
Equípate en la Armería
Abre tu /inventario y selecciona espadas, escudos o armaduras para aumentar tus puntos de Ataque y Defensa.
Únete a la Sala de Espera (Lobby)
Inicia o entra a una incursión con /raids y selecciona tu clase antes de que comience el combate.
Comandos de Raid
-
/armeria
Muestra tus atributos de combate y equipamiento actual.
-
/raids
Abre el menú interactivo de Jefes e inicia la incursión.
Cajas de Botín y Casino
🎁 Cajas de Botín (Lootboxes)
Consigue llaves en eventos o cómpralas en la tienda. Usa /cajas abrir <nombre> para abrirlas. Las cajas pueden contener dinero, minerales raros, llaves adicionales o roles exclusivos asignados desde el Panel Web.
🎰 Juegos de Casino
Comandos de Casino
-
/cajas abrir <caja>
Abre una caja de botín disponible.
-
/ruleta <monto> <tipo>
Apuesta a colores (rojo/negro), números o par/impar.
-
/blackjack <monto>
Inicia una partida interactiva de 21.
-
/slots <monto>
Tira de la máquina tragamonedas.
Seguridad, Captcha y Automod
🔐 Sistema de Verificación / Captcha
Evita la entrada de bots o cuentas maliciosas. Nyxian ofrece verificación por botón, imágenes de códigos Captcha dinámicos o mediante vinculación con la API oficial de Roblox.
🛡️ Filtros de Automod
- Badwords: Bloquea insultos y palabras prohibidas automáticamente.
- Anti-Links: Evita invitaciones no autorizadas a otros servidores de Discord.
- Anti-Spam: Sanciona el envío masivo e instantáneo de mensajes repetidos.
- Anti-MassMention: Previene abusos de pings masivos (@everyone/@here).
📜 Logs de Auditoría
Registra eventos clave del servidor en canales dedicados: mensajes eliminados/editados, cambios de roles, expulsiones y baneos.
Comandos de Moderación
- /ban <usuario> [razón] • Banea a un miembro
- /kick <usuario> [razón] • Expulsa a un miembro
- /mute <usuario> <tiempo> • Aplica timeout temporal
- /warn <usuario> <razón> • Emite una advertencia formal
- /canal limpiar <cantidad> • Borra mensajes en masa
- /canal bloquear / desbloquear • Bloquea o desbloquea un canal
Vinculación de Roblox con OAuth2
Nyxian se conecta a la API oficial de Roblox para autenticar cuentas de forma segura sin requerir contraseñas.
1. Inicia la Vinculación
Ejecuta /vincular en Discord. El bot te proporcionará un enlace único y seguro hacia el portal de inicio de sesión oficial de Roblox.
2. Autoriza el Acceso
Inicia sesión en Roblox y aprueba el permiso de lectura básica de tu perfil público y tus grupos.
3. Sincronización Automática
Al completar el flujo, Nyxian cambiará tu apodo en Discord al nombre de Roblox y te otorgará los roles correspondientes según tu rango en el grupo.
Manual Completo del Panel Web (Dashboard)
Accede a https://nyxian.xyz/dashboard para gestionar el bot visualmente sin memorizar comandos administrativos.
⚙️ Configuración General y Permisos
Activa o desactiva módulos enteros del bot. Asigna en **📌 Pestañas Permitidas** qué secciones del panel pueden ver o editar los diferentes roles de Staff de tu servidor.
🎨 Live Canvas Embed Builder
Diseña mensajes y tarjetas de bienvenida, despedida o anuncios de booster con vista previa en tiempo real. Configura autor, título, descripción, banners, miniaturas, footers y colores personalizados.
🛍️ Tienda Custom y Cajas de Botín
Añade objetos comprables, asignación de roles automáticos al comprar, creación de lootboxes con porcentajes de probabilidad y precios de llaves.
📋 Tickets y Formularios Públicos
Diseña paneles de soporte técnico por botones o crea formularios de postulación a staff con preguntas personalizadas y registro de respuestas.
🎁 Sorteos y Encuestas
Organiza sorteos programados con temporizador automático y requisitos de rol. Lanza votaciones y encuestas públicas con opciones múltiples.
📡 Alertas Sociales
Recibe avisos automáticos en un canal cuando un creador publique un nuevo video en **YouTube**, inicie directo en **Twitch**, suba contenido en **TikTok** o **Instagram**.
⭐ Niveles y Cartas XP
Gana experiencia hablando por chat o canales de voz. Personaliza tu tarjeta visual de rango y compite en el ranking global del servidor.
🎟️ Códigos de Regalo
Canjea códigos promocionales creados por los administradores presionando el botón interactivo de reclamación en Discord o desde la Dashboard.
Preguntas Frecuentes (FAQ)
Asistente de Solución de Problemas
Haz clic en la situación que se presenta en tu servidor para ver la solución correspondiente:
1. Verifica que el bot tenga el permiso Usar Comandos de Aplicación activado en el canal.
2. Asegúrate de estar escribiendo el comando slash y seleccionando la sugerencia emergente de Discord.
3. Si cambiaste los permisos en el panel, comprueba que el módulo no esté bloqueado en la Dashboard.
1. Ingresa al Panel Web y confirma que seleccionaste un canal válido en el selector.
2. Asegúrate de que el rol de Nyxian en Discord tenga permisos de Ver Canal, Enviar Mensajes y Insertar Enlaces en dicho canal.
1. Comprueba que el rol del bot Nyxian en la lista de roles de Discord esté ubicado por encima de los roles que intentas asignar.
2. Verifica que el usuario haya completado el flujo de autenticación mediante /vincular.