Guía y Funcionamiento

Descubre el funcionamiento interno de Nyxian y cómo interactúan entre sí los sistemas del servidor.

Mapa del Ecosistema Nyxian

Nyxian no es una colección de comandos independientes. Es un **ecosistema unificado** donde lo que haces en un módulo afecta directamente a los demás. El siguiente mapa muestra cómo fluye la interacción dentro de tu servidor:

graph TD
    %% Styling
    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;
    
    %% Módulos
    Roblox[Vincular Roblox]:::base -->|Otorga Roles| Roles[Roles de Discord]
    Roles -->|Acceso a Comandos| Economia[Economía Central]:::econ
    
    Economia -->|Comprar Mejoras| Tienda[Tienda & Roles Especiales]:::econ
    Economia -->|Comprar Cajas/Casino| Casino[Casino y Cajas]:::econ
    Economia -->|Fondos de Clan| Clanes[Clanes y Mejoras]:::econ
    
    Mineria[Sistema de Minería]:::rpg -->|Vender Recursos| Economia
    Mineria -->|Fabricar Picos| Crafteo[Recetas & Crafteos]:::rpg
    Mineria -->|Mejorar Estadísticas| Armeria[Armería & Clases]:::rpg
    
    Armeria -->|Armas & Armaduras| Raids[Lobbies & Combate Raids]:::rpg
    Raids -->|Drops Exclusivos| Crafteo
    Raids -->|Oro de Recompensa| Economia
    
    ICManager[Administrador - ICManager]:::base -->|Configura Objetos, Bosses y Drops| Mineria
    ICManager -->|Establece Requisitos| Raids
                    

¿Cómo se conectan los sistemas en tu partida?

1. De Roblox al Servidor

Al vincular tu cuenta con /vincular, Nyxian lee tus grupos y posesión de assets de Roblox para asignarte roles. Estos roles determinan tus privilegios en el chat y tus multiplicadores iniciales en la economía.

2. Minería y Economía

En la minería consigues menas y gemas. Puedes venderlos para acumular saldo en la Economía Central, el cual usarás en la tienda, en apuestas del casino o para mejorar los almacenes y el nivel de tu Clan.

3. De la Armería a los Raids

Los mejores minerales se usan en recetas para fabricar espadas y armaduras. Equiparlas desde tu /inventario interactivo aumenta tus estadísticas de combate, necesarias para entrar a Raids y derrotar a los jefes.

El Viaje del Minero RPG

1
Comienza a Minar

Ejecuta el comando /mine para extraer recursos del subsuelo en tu mina actual. Recibirás minerales como carbón o hierro, que puedes vender para conseguir tu primer capital.

2
Consigue mejores Picos

Un pico de madera no puede romper diamantes. Consulta /mineria recetas para ver qué materiales necesitas y forja tu nuevo pico con /mineria craft <receta_id>. Esto reducirá el tiempo de espera y aumentará tu suerte.

3
Explora el Mapa

Usa /mineria mapa para viajar a nuevas zonas mineras. Cada zona cuenta con minerales exclusivos, niveles de peligro diferentes y requisitos mínimos de pico o nivel para poder entrar.

4
Consigue Compañeros (Mascotas)

Las mascotas no son solo cosméticos. Otorgan bonificaciones de velocidad, suerte para hallar vetas legendarias o incluso aumentan el daño que haces a los Jefes de Veta. Gestionalas y equípalas con /mineria mascota.

Comandos Clave

  • /mine
    Pica y mina en tu zona actual.
  • /inventario
    Muestra tus minerales, cofres y herramientas. Te permite equipar armas o armaduras.
  • /mineria recetas
    Consulta los crafteos y materiales necesarios de la Forja.
  • /mineria craft <receta_id>
    Craftea el pico, arma o armadura.
  • /mineria mascota
    Abre tu guardería de mascotas para verlas o cambiarlas.

Armería y Preparación para Raids

Cuando estés listo para dejar el pico y tomar la espada, el sistema de Raids de Nyxian te permite unirte con otros miembros del servidor para luchar contra poderosos jefes controlados por el bot.

Las Clases del Personaje

Las clases se eligen e intercambian directamente en la interfaz del lobby al unirse a la incursion:

🛡️
Tanque

Tiene alta vida y defensa. Protege al equipo recibiendo los ataques del jefe.

⚔️
Atacante (DPS)

Inflige daño masivo por segundo. Su objetivo principal es derrotar al jefe rápido.

Soporte (Curador)

Cura a sus compañeros y otorga mejoras temporales de daño y escudo.

Flujo de una Raid

1
Ver Jefes y Crear Lobby

Ejecuta el comando /raids. Verás la lista de jefes disponibles. Presiona el botón de combatir del jefe deseado para abrir la sala de espera (Lobby) en tu canal.

2
Unirse y Elegir Clase

Tus amigos pueden unirse presionando el botón del lobby. Un menú desplegable dentro del mismo lobby les permitirá seleccionar su clase (Guerrero, Atacante, Soporte, Nigromante, etc.) en tiempo real.

3
Loot y Drops

Al derrotar al Jefe en la batalla por turnos, se repartirá Oro (Economía Central) y materiales de rareza extrema (usados para craftear el set de combate definitivo en la tienda).

Equipamiento RPG

Tu fuerza en una Raid depende directamente de tu **Armería**. Craftea ítems y equípalos mediante la interfaz de tu /inventario:

  • 🗡️
    Armas
    Aumentan tu daño base de ataque.
  • 🛡️
    Armaduras
    Aumentan tu vida máxima y defensa contra los golpes.
  • 💍
    Accesorios
    Dan bonificaciones críticas o curaciones pasivas por turno.

Sistema de Verificación e Integración con Roblox

Nyxian está diseñado para conectar tus comunidades de Discord y Roblox de manera eficiente, lo cual permite crear roles dinámicos de forma segura.

🔗 Vinculación de Cuentas

El comando /vincular asocia tu ID de Discord con tu cuenta de Roblox mediante OAuth 2.0. Una vez enlazado:

  • El bot cambiará tu apodo de servidor para que coincida con tu nombre de Roblox (configurable).
  • Podrás acceder a los comandos de estadísticas de juego directamente en el bot y ver tu perfil con /perfil.
👥 Sincronización de Roles

Los administradores pueden configurar y enviar el panel interactivo de verificación directamente desde el Panel de Control (Dashboard) en la pestaña Verificación y Roles. Esto asignará roles según:

  • El rango del usuario dentro de un **Grupo de Roblox** del servidor.
  • La posesión de ciertos **Badges (Emblemas)** en el juego de Roblox asociado.
  • Si el usuario tiene un **Gamepass** en específico.
💡 Consejo de Seguridad
La verificación manual del bot protege tus canales de chat de bots de spam. Si configuras la verificación obligatoria, recuerda denegar el permiso de enviar mensajes en el rol `@everyone` y permitirlo únicamente en tu rol de usuarios verificados.

Panel de Control y Guía de Staff

Nyxian cuenta con un completo **Panel de Control Web** (dashboard) que permite a los propietarios y administradores configurar el bot sin necesidad de escribir comandos complejos. A continuación se detallan las principales herramientas de administración:

Creador de Embeds

Diseña comunicados, anuncios o reglas con un formato elegante (Embeds) utilizando el previsualizador en vivo del panel web. Puedes guardar tus plantillas en la base de datos y enviarlas a cualquier canal del servidor con un solo clic.

Web / Panel
Formularios Dinámicos

Crea postulaciones de staff, encuestas o reportes de bugs en el panel web. El bot genera un enlace público (nyxian.xyz/forms/...) para que los usuarios respondan y podrás revisar sus respuestas en tiempo real desde la web o recibirlas en un canal de logs.

Web / Panel
Configuración RPG & Tienda (ICManager)

¡El panel de administración te permite ser el diseñador del juego! Mediante el **ICManager** puedes:

  • Crear y editar minerales, picos, armas y armaduras con estadísticas personalizadas de daño y vida.
  • Configurar Jefes de Veta y Jefes de Raids, estableciendo su HP base y porcentaje de drop.
  • Modificar las recetas de crafteo y las tiendas del servidor instantáneamente.
ICManager / Web
Zona de Peligro (Resets)

Al final de la pestaña de configuración base, los administradores tienen acceso a herramientas de mantenimiento global. Estas acciones son irreversibles:

  • Resetear Economía: Borra carteras, bancos e inventarios de todo el servidor.
  • Resetear RPG: Borra niveles, crafteos hechos y equipo activo.
  • Resetear Configuración: Restablece bienvenidas, automod y logs a valores por defecto.
Moderación, Automod y Canales de Logs

Nyxian cuenta con un robusto sistema de moderación que puedes configurar desde el panel:

🛡️ Automod
Configura límites de spam, bloqueador de enlaces externos y palabras tóxicas. El bot aplicará avisos automáticos a los infractores.
📝 Canales de Logs (Auditoría)
Asigna canales específicos para auditoría. Podrás recibir registros separados de mensajes borrados, ingresos al chat, sanciones aplicadas y reportes enviados por miembros del servidor.
👋 Bienvenidas Personalizadas
Define mensajes de bienvenida dinámicos e imágenes personalizadas que se enviarán de forma automática cuando un miembro nuevo se una al servidor de Discord.

Configuración de Feed Social: TikTok e Instagram

Aviso Importante: Debido a estrictos bloqueos de seguridad anti-bots implementados por TikTok e Instagram, buscar notificaciones usando solo el @usuario fallará silenciosamente (Error 403 Forbidden de acceso denegado). Para que funcione, es obligatorio usar un enlace directo a un Feed RSS personalizado en el panel.
1
Genera un Feed RSS Válido

Como el bot no puede extraer los videos de TikTok/IG directamente por los bloqueos de red de estas plataformas, necesitas un servicio puente. Recomendamos usar rss.app (o cualquier otro generador público que devuelva un formato XML RSS 2.0).

  • Entra a rss.app y selecciona crear un feed para TikTok o Instagram.
  • Ingresa el enlace al perfil del cual quieres recibir notificaciones.
  • Copia la URL del Feed RSS (Se verá algo parecido a https://rss.app/feeds/tt/XXXXXX).
2
Configura el Panel de Nyxian

Dirígete a tu panel de control web, a la sección de Redes Sociales y llena el formulario de la siguiente manera:

  • Plataforma: Selecciona TikTok o Instagram según corresponda.
  • Nombre de Usuario / ID: Aquí NO pongas el @usuario. En su lugar, pega la URL completa (incluyendo el http:// o https://) que obtuviste en el Paso 1.
  • El sistema del backend web de Nyxian detectará automáticamente que has ingresado un enlace directo (gracias a la presencia del http) y lo guardará de forma nativa sin forzar su conversión a una ruta predeterminada fallida.
3
Sincronización Automática

Una vez guardado exitosamente, el loop interno del bot (check_videos) hará peticiones asíncronas a tu enlace cada 60 segundos de forma continua. Cuando el creador suba un nuevo video o post, el bot:

  • Leerá las etiquetas XML y extraerá elementos como el enlace, el título de la publicación, el autor y la miniatura (Thumbnail).
  • Construirá un Embed rico e incrustado con los colores oficiales de la plataforma (Negro para TikTok, Magenta para Instagram).
  • Enviará la alerta en tiempo real al canal destino, añadiendo una mención (Ping) si seleccionaste un rol específico.
Nota Técnica: Para evitar spam cuando configuras una alerta por primera vez, el sistema de Nyxian almacena temporalmente los IDs (guid) del último video actual en su base de datos de historiales, y silenciará la notificación inicial. El bot solo avisará a partir de las publicaciones nuevas que ocurran desde el momento en que se registró.

Preguntas Frecuentes

Puedes ganar dinero de varias formas: 1. **Trabajando:** Usando el comando /work o /empleo trabajar para completar minijuegos laborales. 2. **Recompensa Diaria:** Reclamando tu dinero diario con /daily o /eco daily. 3. **Minería:** Minando recursos en /mine y vendiéndolos en la tienda virtual con /mineria vender. 4. **Raid:** Al derrotar jefes en incursiones de combate con tu clan o amigos a través de /raids.

Asegúrate de revisar lo siguiente: 1. Que los materiales estén en tu inventario principal (puedes revisarlo con el comando /inventario). 2. Algunas recetas requieren que tengas un nivel de minería específico para poder forjarlas. 3. Comprueba el ID exacto del ítem o receta con /mineria recetas.

Nyxian permite configurar en su panel web la sincronización automática de un rol de Discord basado en la pertenencia a un **Grupo de Roblox**. Si el usuario está en el grupo y su cuenta está vinculada (con /vincular), recibirá el rol en Discord automáticamente al verificarse pulsando el botón en el servidor. También se puede configurar que la verificación de Roblox sea obligatoria para poder hablar en los canales generales o participar en Sorteos.

Los clanes te permiten asociarte con otros jugadores del servidor. Puedes fundar un clan con el comando /clan crear. Ventajas de estar en un clan: 1. Compartir recursos y oro en la bóveda del clan. 2. Acceso a multiplicadores de ganancias y mejoras colectivas de minería. 3. Participación en incursiones de Raids competitivos de clanes por premios y gloria en el servidor.

Solucionador de Problemas

Haz clic en el problema que estás experimentando para ver los pasos recomendados de solución:

Pasos para solucionar problemas de Verificación:
  1. Asegúrate de que tu cuenta de Discord está enlazada correctamente usando el comando /vincular.
  2. Si el servidor usa sincronización por grupo de Roblox, verifica que tu perfil en Roblox sea público y que estés dentro del grupo oficial.
  3. Pídele a un administrador que compruebe los permisos del bot: el rol del bot en Discord debe estar **por encima** de los roles que intenta asignar en la lista de roles del servidor.
Cómo solucionar problemas con el bloqueo de canales:
  1. El bot guarda la configuración previa en su base de datos. Si se realiza un cambio manual de permisos durante el bloqueo, el comando de desbloqueo puede presentar conflictos.
  2. Utiliza el comando /canal desbloquear indicando una razón. Si esto no funciona, un administrador puede restaurar manualmente el canal en los ajustes de Discord cambiando la opción de enviar mensajes a Neutro (`/`).
  3. Asegúrate de que el bot tenga el permiso de **Administrar Roles y Canales** en el canal afectado.
Cómo aumentar tu daño y estadísticas en combates:
  1. Asegúrate de haber seleccionado una clase desde el menú desplegable al unirte a la incursión en /raids.
  2. Comprueba que tus armas y armaduras estén equipadas. Debes equiparlas directamente abriendo tu mochila interactiva con el comando /inventario y seleccionando el objeto en el menú.
  3. Los picos solo aumentan tu rendimiento en la minería. Para los combates y raids de jefes, necesitas forjar **Espadas y Armaduras de Combate** desde la sección de recetas o la tienda.
Sobre el guardado de datos y progreso RPG:
  1. El bot guarda los datos de forma automática en MongoDB en la nube.
  2. Si el servidor experimentó un reinicio o hubo problemas de conexión con los servidores de Discord, tus cambios podrían tardar unos minutos en reflejarse.
  3. No realices transacciones ni compras de manera simultánea en varios canales para evitar fallos de concurrencia en la base de datos.