🚀 EngineX - Sistema de Promociones y Referidos (Referral System)

EngineX Promo es la herramienta definitiva de marketing y fidelización para tu servidor de FiveM. Diseñado con una interfaz web (NUI) moderna, minimalista y ultra-responsiva, permite a tus jugadores generar códigos de creador, invitar a sus amigos y desbloquear recompensas automáticas a medida que ayudan a hacer crecer tu comunidad.

Olvídate de la gestión manual de premios. El script automatiza todo el flujo de invitaciones, entrega de recompensas y control de seguridad en tiempo real.

🎥 VÍDEO DE DEMOSTRACIÓN: 👉 Haz clic aquí para ver el funcionamiento (Próximamente)

🌐 WEB OFICIAL: 👉 Haz clic aquí para visitar nuestra Web (Puedes ir a la web a probar nuestro sistema con la demo interactiva)

✨ Características Principales

⚡ Optimización Extrema (0.00ms Resmon): Desarrollado bajo estrictos estándares de rendimiento. El recurso no genera carga innecesaria, manteniendo un consumo de 0.00ms tanto en el cliente como en el servidor.

🛡️ Sistema Anti-Multicuentas (Anti-Alt Check): Incorpora un sistema de seguridad inteligente que compara direcciones IP y Tokens de Hardware (HWID). Evita que los usuarios abusen de los premios autocanjeándose códigos con cuentas secundarias.

📈 Progresión por Tiers (Niveles): Crea una escalera de premios (ej: Nivel 1, 2, 3...) donde el creador del código desbloquea mejores recompensas (dinero en efectivo, ítems, coches o monedas VIP) al acumular más amigos (ej: 5, 10, 15 referidos).

🎁 Doble Recompensa (Creador y Reclutado): Puedes configurar una recompensa de bienvenida inmediata para el jugador que introduce un código, y acumular el referido para premiar al dueño del código.

💼 Framework & Inventory Agnostic: Detección automática en tiempo real del framework activo (QB-Core, Qbox, ESX) y de los inventarios más populares (ox_inventory, qs-inventory, qb-inventory), sin necesidad de editar una sola línea de código.

🌐 Logs Enriquecidos para Discord: Mantente informado de toda la actividad mediante Webhooks. Envía embeds dinámicos y coloridos cuando un jugador crea un código, canjea una invitación o reclama recompensas de nivel.

📊 Interfaz Visual de Usuario (NUI)

El script cuenta con un dashboard visual muy pulido e intuitivo para el usuario:

🔹 Gestión de código: Permite crear códigos personalizados (ej: MI_STREAMER) o generar uno aleatorio con prefijo con un solo botón.

🔹 Historial de Invitados: Lista en tiempo real de los amigos que han usado el código, mostrando su nombre de personaje y la fecha/hora exacta en la que se unieron.

🔹 Progreso Interactivo: Barra de progreso visual que muestra el Tier actual del usuario y cuántos referidos le faltan para el siguiente nivel.

🔹 Reclamo de Premios: Botón directo para reclamar los premios desbloqueados, guardando el estado de reclamo de forma persistente.

💻 Comandos Incluidos

🎭 Jugadores: /promo o /enginex_promo – Abre el menú visual de referidos.

🛡️ Staff: /promo_admin – Permite a la administración verificar estadísticas del recurso.

🔓 Personalización y Archivos Abiertos

Entendemos que cada proyecto es único, por lo que el script mantiene sus archivos de personalización abiertos:

⚙️ config.lua – Controla los límites de los códigos (longitud), tiempos de spam (cooldowns), sonidos nativos de la interfaz, el webhook de Discord, la moneda VIP a entregar (xcoin / XCoin) y la lógica detallada de los premios de cada Tier.

🌍 locales/*.lua – Traducciones y notificaciones totalmente personalizables (incluye traducción por defecto en español e inglés).

📦 Dependencias y Requisitos

🔹 ox_lib 🔹 oxmysql

🛠️ Instrucciones de Instalación

1️⃣ Descarga el recurso desde tu Keymaster de FiveM.
2️⃣ Asegúrate de que ox_lib y oxmysql se inicien antes que este script en tu servidor.
3️⃣ Configura tus recompensas y tu webhook de Discord en el archivo config.lua.
4️⃣ Añade ensure enginex_promo en tu server.cfg e inicia tu servidor (la carga de la base de datos SQL se realiza de forma 100% automática al arrancar).

(Si necesitas asistencia técnica, recuerda que puedes abrir un ticket de soporte en nuestro Discord oficial adjuntando tu recibo de compra de Tebex).