🎁 FYT-Rewards · Sistema Premium de Recompensas

El sistema de fidelización más completo para FiveM. Bono diario de 30 días, doble ruleta con animaciones cinemáticas, sistema de referidos, códigos promo y panel admin completo. Todo configurable en VIVO desde el juego, sin reiniciar.

---

✨ ¿Por qué FYT-Rewards?

Tus jugadores volverán cada día por su recompensa. Las ruletas crean dopamina. Los referidos hacen crecer tu comunidad orgánicamente. Y como admin, controlas TODO desde dentro del juego sin tocar archivos ni reiniciar.

---

🎯 Características Principales

🗓️ Bono Diario de 30 Días

• Calendario de 30 días con recompensa única por día
• Sistema de racha que motiva conexiones diarias
• Cooldown configurable en horas Y minutos (perfecto para testing)
• Días sorpresa (mystery box 🎁) y días hito ⭐
• Cualquier tipo de premio: dinero, coins, items, vehículos, armas, VIP, combos

🎰 Doble Ruleta con Animación Cinemática

• Ruleta Básica: coins normales, premios balanceados
• Ruleta Premium: coins premium, vehículos VIP, combos exclusivos
• Animación de 5 segundos con tick sonoro
• Sistema de pesos por premio (controla probabilidades)
• Premio determinado server-side (imposible exploitear)

👥 Sistema de Referidos

• Código único de 6 caracteres por jugador
• Solo cuentas nuevas (< 24h) pueden canjear
• Recompensa para invitador E invitado
• Bonos automáticos al alcanzar 5 y 10 referidos
• Verificación server-side de edad real del personaje
• Leaderboard público de top referidores

🎟️ Códigos Promo

• Códigos personalizados con límite de usos
• Fecha de expiración
• Recompensa configurable por código
• Ideal para eventos en Discord, sorteos y campañas

⚙️ Panel Admin Completo (in-game)

• Gestión de jugadores con nombre real + estado online/offline
• Editor visual de los 30 días (grid con imágenes de items)
• Editor de ruletas (premios, costos, pesos)
• Creación de códigos promo
• Estadísticas en tiempo real
• Logs de Discord automáticos
• Cambios reflejados en VIVO a todos los jugadores conectados

🛡️ Anti-Exploit Integrado

• Validación server-side en CADA acción
• Verifica espacio en inventario ANTES de cobrar coins
• Sistema de tokens únicos para entrega de premios post-animación
• 14 callbacks admin protegidos con permisos
• Logs de intentos no autorizados a Discord
• Sistema de seed RNG para premios verdaderamente aleatorios

---

🖥️ UI Moderna Estilo Cyberpunk

• Diseño morado/violeta premium
• 100% NUI sin afectar performance del juego
• 7 páginas: Bono Diario · Ruletas · Referidos · Top · Promos · Historial · Admin
• Animaciones suaves de transición
• Modales sin oscurecer la pantalla
• Imágenes reales de items del inventario
• Loading states y feedback visual

---

🔌 Integraciones

Componente

Soportado

Framework

QBCore · QBox · ESX

Inventarios

qs-inventory · ox_inventory · qb-inventory (autodetect)

Notificaciones

rx_notify · ox_lib · QBCore · ESX · Custom

Base de datos

MySQL via oxmysql

---

📦 Exports Públicos (para integraciones)

lua

exports['FYT-Rewards']:GivePlayerReward(src, prize)
exports['FYT-Rewards']:AddPlayerCoins(src, amount, reason)
exports['FYT-Rewards']:GiveVehicleToPlayer(src, model)
exports['FYT-Rewards']:SearchItems(query, limit)
exports['FYT-Rewards']:GetInventoryInfo()

---

📋 Tipos de Recompensa Soportados

• 💵 Cash (dinero en mano)
• 🏦 Bank (dinero al banco)
• ◈ Coins (moneda del servidor)
• 📦 Item (cualquier item del inventario)
• 🚗 Vehículo (permanente, registrado en garaje)
• 🔫 Arma (con munición configurable)
• 👑 VIP (por tiempo configurable)
• 🎁 Combo (dinero + coins + items + vehículo en un solo premio)
• ❓ Secret (valor aleatorio dentro de rango)

---

🚀 Instalación Express

1. Importa sql/install.sql en tu base de datos
2. Sube la carpeta a /resources/
3. Configura config.lua (framework, inventario, admins)
4. ensure FYT-Rewards en server.cfg
5. Reinicia. Listo en menos de 5 minutos.

---

📦 Dependencias

• ✅ oxmysql
• ✅ ox_lib
• ✅ Framework: QBCore / QBox / ESX
• ✅ Sistema de coins (compatible con cualquiera)

---

💎 Lo que recibes

• ✅ Archivos del recurso (escrow protegido)
• ✅ config.lua editable (framework, premios default, admins, etc.)
• ✅ Locales en español e inglés (editables)
• ✅ SQL de instalación
• ✅ README de instalación
• ✅ Soporte vía Discord
• ✅ Actualizaciones futuras incluidas

---

⚙️ Especificaciones Técnicas

• Versión: 1.2.0
• Framework: QBCore / QBox / ESX
• Idiomas: Español 🇪🇸 / Inglés 🇬🇧 (extensible)
• Protección: Cfx Asset Escrow
• Optimización: 0.00ms idle, server-side y client-side optimizado
• Tamaño: ~1.9 MB

---

📞 Soporte

¿Dudas? ¿Sugerencias? ¿Bug?
Únete a nuestro Discord oficial de FYT-SCRIPS.

https://discord.gg/JTNjPUfX

---

🏷️ Tags

recompensas daily-bonus ruleta roulette wheel referidos referral promo-codes admin-panel qbcore qbox esx rewards loyalty premium