🪙 FYT-CoinSystem · Sistema Premium de Monedas Virtuales

El sistema de economía paralela más completo para FiveM. Tienda integrada, dealer VIP con vehículos exclusivos, panel admin completo, HUD flotante y antiexploit. Todo configurable desde un solo archivo.

---

✨ ¿Por qué FYT-CoinSystem?

Crea una economía secundaria en tu servidor con coins virtuales que tus jugadores pueden ganar por eventos, logros o jugando. Úsalos como recompensa, suscripciones VIP, o como divisa premium en tu tienda interna. Y como admin, controlas todo desde dentro del juego sin reiniciar.

---

🎯 Características Principales

🛍️ Tienda Integrada

• 6 categorías organizadas: Items · Vehículos · Armas · Perks · Especiales · Todo

• 8 items default completamente configurables (precios, stock, rareza)

• Tipos de productos: items del inventario, dinero, vehículos, armas, VIP, combos multi-premio

• Sistema de rareza: common, uncommon, rare, epic, legendary, secret

• Stock limitado o ilimitado por producto

• Confirmación visual de compra exitosa

💎 Dealer VIP (NPC con vehículos exclusivos)

• NPC físico en el mundo con ox_target

• 8 vehículos premium preconfigurados (Adder, Zentorno, T20, Oppressor Mk II, etc.)

• Catálogo con UI dedicada dentro del panel

• Spawn automático del vehículo al comprar

• Localización configurable (por defecto en Premium Deluxe Motorsport)

• Compatible con cualquier garaje del framework

📊 Panel Admin Completo

• Gestión de jugadores en vivo (dar/quitar coins, ver historial)

• Estadísticas del servidor (top jugadores, transacciones totales)

• Logs de todas las acciones admin a Discord

• Acceso restringido por grupo del framework O Discord ID

• Cambios reflejados al instante sin reiniciar

🎮 HUD Flotante de Coins

• Display visual en pantalla con el balance actual

• Posición configurable (X/Y)

• Animaciones suaves al cambiar el balance

• Activable/desactivable desde config

📜 Historial de Transacciones

• Todas las transacciones registradas con fecha, motivo y origen

• Filtros por tipo (compras, recompensas, admin)

• Últimas 50 transacciones visibles (configurable)

• Identificación del recurso que añadió/quitó coins

🛡️ Anti-Exploit Avanzado

• Rate limit server-side por jugador (max coins/segundos)

• Whitelist opcional de recursos autorizados a dar coins

• Alertas de Discord cuando alguien intenta exploitear

• Todas las transacciones se loguean con el recurso origen

• Imposible añadir coins desde el cliente

• Validaciones en cada export

---

🔌 Integraciones con tus Otros Scripts

FYT-CoinSystem expone 4 exports públicos para que cualquier otro recurso pueda darle coins a los jugadores:

-- Consultar balance
local coins = exports['FYT-CoinSystem']:GetPlayerCoins(source)

-- Verificar si tiene suficientes
local has = exports['FYT-CoinSystem']:HasPlayerCoins(source, 100)

-- Recompensar al jugador
exports['FYT-CoinSystem']:AddPlayerCoins(source, 50, 'Recompensa por evento')

-- Cobrar al jugador
exports['FYT-CoinSystem']:RemovePlayerCoins(source, 25, 'Compra externa')

Casos de uso típicos:

• 🎯 Recompensar misiones diarias completadas

• 🏆 Premios en eventos y torneos

• 🎰 Conectar con sistemas de ruletas/loterías (compatible con FYT-Rewards)

• 🛒 Tiendas premium adicionales

• ⭐ Sistemas de logros/achievements

---

🖥️ UI Moderna Estilo Cyberpunk

• Diseño morado/violeta premium consistente con el ecosistema FYT-SCRIPS

• 100% NUI sin afectar performance

• Navegación fluida entre Tienda · Historial · Perfil · Admin · Dealer

• Animaciones de transición y feedback visual

• Modales sin oscurecer la pantalla del juego

• Loading states y mensajes contextuales

---

⚙️ Especificaciones Técnicas

Característica

Detalle

Framework

QBCore · QBox · ESX (autodetect)

Base de datos

MySQL via oxmysql

UI

NUI puro (HTML/CSS/JS) sin frameworks pesados

Optimización

0.00ms idle · server-side y client-side optimizado

Idiomas

Español 🇪🇸 / Inglés 🇬🇧 (extensible)

Protección

Cfx Asset Escrow

Tamaño

~1.9 MB

Versión

1.0.0

---

🚀 Instalación Express

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

---

📦 Dependencias

• ✅ oxmysql

• ✅ ox_lib

• ✅ ox_target (para el dealer NPC)

• ✅ Framework: QBCore / QBox / ESX

---

💎 Lo que recibes

• ✅ Archivos del recurso (escrow protegido)

• ✅ config.lua completamente editable (tienda, dealer, webhooks, admins)

• ✅ Locales en español e inglés (editables)

• ✅ SQL de instalación

• ✅ SQL de migración desde otros sistemas de coins (opcional)

• ✅ README profesional con guía paso a paso

• ✅ Soporte vía Discord

• ✅ Actualizaciones futuras incluidas

---

🎯 Casos de Uso Reales

Servidores RP: Premia logros y horas jugadas. Vende ventajas cosméticas sin romper la economía.

Servidores Competitivos: Coins como divisa de ranking. Compra equipo premium al subir de tier.

Comunidades de Apoyo: Convierte cada compra de tu Tebex en coins in-game para mejores items.

Servidores con Eventos: Distribuye coins en eventos especiales, sorteos y torneos automáticamente.

---

🔗 Combina con FYT-Rewards

FYT-CoinSystem es 100% compatible con FYT-Rewards (sistema de bonos diarios y ruletas). Configura las recompensas diarias en coins y crea un ecosistema de fidelización completo.

---

📞 Soporte

¿Dudas? ¿Sugerencias? ¿Bug?
Únete a nuestro Discord oficial:
👉 https://discord.gg/z6E5veecqp

https://youtu.be/U0rh4xfoKTs

---

🏷️ Tags

coins coinsystem economia economy tienda shop dealer vehicles vip admin-panel qbcore qbox esx nui premium fyt-scrips

---

Desarrollado con ❤️ por FYT-SCRIPS · Scripts premium para servidores serios