FYT-PROSOUND

🎵 FYT-PROSOUND v0.7.0 — Vehicle Hub + DJ Zone + Audio 3D HRTF

El sistema de música más completo del mercado FiveM. Un solo recurso, dos experiencias premium: un HUD interactivo dentro del coche + una DJ ZONE realista con mesa, animaciones y controles pro-DJ. Todo con motor de audio 3D HRTF binaural interno — sin xsound, sin dependencias frágiles.

---

✨ Características principales

🚗 Hub del vehículo

- Panel interactivo (tecla configurable) con control total del coche desde una NUI premium.

- Reproducción de música YouTube / MP3 / SoundCloud desde el propio hub.

- Sincronización de música entre ocupantes del mismo vehículo.

- Interfaz con branding personalizable (logo del servidor con animación de fondo).

🎧 Motor de audio 3D HRTF propio

- Audio binaural real: escuchas la música moverse alrededor de tu cabeza al girarla.

- Filtros dinámicos por contexto: dentro/fuera del coche, ventanas abiertas, paredes de MLO, oclusión por raycast.

- Bass boost auténtico + EQ de 10 bandas totalmente funcional.

- YouTube sin backend: reproducción directa desde IFrame API. Sin descargar, sin proxy, sin cortes.

- Ajustes finos: distancia máxima, low-pass por contexto, volumen relativo — todo en config.lua.

🎛️ DJ ZONE + DJ Creator PRO

- Panel de administración visual para crear zonas DJ persistentes en cualquier punto del mapa.

- Selector 3D: coloca la zona con raycast in-world (E confirma, ESC cancela).

- Gizmo de mesa DJ: mueve la mesa físicamente con WASD/Q/E/Space/Ctrl, rueda para altura fina.

- 7 modelos de mesa incluidos (Cayo Perico, Music Locker, After Hours, Diamond Casino, etc.).

- Animaciones "pinchando" automáticas cuando el DJ está reproduciendo.

- Handoff de control: dos DJs pueden pedirse el turno en la misma zona sin conflictos.

- Sistema anti-suplantación: candado por zona, solo un DJ activo a la vez.

- Restricciones por job, horario del juego (abierto de X a Y), radio, volumen.

- Mixer profesional: GAIN, HIGH/MID/LOW, FILTER, CUE, CROSSFADER, LIMITER con Web Audio real.

- FX en vivo: REVERB, DELAY, FILTER, PHASER, DISTORTION con barras arrastrables.

- Vinyl brake realista (gain ramp + lowpass sweep) + scratch en vivo con el jog wheel.

- Todo el mix se sincroniza con los oyentes cercanos (EQ, FX, pause, seek, crossfader).

🎚️ Soundboard (9 pads configurables)

- Sonidos one-shot con audio local (MP3/OGG/WAV/M4A en la carpeta sounds/) o URLs externas.

- Iconos, colores y volumen por pad, editables desde config.lua.

- Auto-corte a 15 s para evitar sonidos infinitos.

📚 Playlists compartibles + Favoritos

- Cada usuario crea sus playlists y las guarda en BD.

- Códigos cortos de 6 caracteres (ej: AB23XQ) para compartir con otros jugadores.

- Toggle público/privado por lista.

- Favoritos individuales sueltos.

- Persistencia asociada a license: — sobrevive cambios de personaje QB/ESX.

🎯 Integración ox_target

- Los DJs interactúan con la mesa vía ox_target (opcional; sin él se sigue accediendo por /djcreator).

---

🔌 Compatibilidad MULTI-FRAMEWORK

Todas las dependencias son OPCIONALES y se auto-detectan en runtime:

┌────────────────┬─────────────────────────────────────────────────────────────────────┐

│ Categoría │ Soportados │

├────────────────┼─────────────────────────────────────────────────────────────────────┤

│ Framework │ QBCore · QBox · ESX legacy / ESX new │

├────────────────┼─────────────────────────────────────────────────────────────────────┤

│ Base de datos │ oxmysql · mysql-async · ghmattimysql · (fallback: JSON+KVP local) │

├────────────────┼─────────────────────────────────────────────────────────────────────┤

│ Target │ ox_target (opcional) │

├────────────────┼─────────────────────────────────────────────────────────────────────┤

│ Notificaciones │ ox_lib · QBCore:Notify · esx:showNotification · feed GTA (fallback) │

└────────────────┴─────────────────────────────────────────────────────────────────────┘

Sin ninguno de estos, el script sigue funcionando — solo perderás lo que sea específico (jobs restringidos, target, etc.).

---

🔒 Sistema de permisos triple (DJ Creator admin)

- 1) ACE permission (add_ace identifier.steam:XXX fyt.prosound.djcreator allow)

- 2) Whitelist por Discord ID (snowflake numérico)

- 3) Job del framework (allowedJobs en config)

Cualquiera de las tres vías concede acceso.

---

📦 Instalación en 60 segundos

1. Copia la carpeta FYT-PROSOUND/ a tu resources/.

2. Añade ensure FYT-PROSOUND al server.cfg (después de ensure oxmysql).

3. (Opcional) Ejecuta install.sql o deja que las tablas se creen solas al arrancar.

4. Reemplaza los logos en web/car/logo.png, web/dj/logo.png, web/car/server-logo.png.

5. ¡Listo!

Guía completa en README-PERSONALIZAR.txt (incluido).

---

🛠️ Editable por el cliente (fuera del escrow)

- ✅ config.lua — TODA la configuración de gameplay, audio, permisos, jobs, soundboard.

- ✅ shared/framework.lua — bridge multi-framework (por si necesitas añadir uno exótico).

- ✅ shared/locale.lua — traducciones.

- ✅ sounds/*.mp3 — reemplaza los sonidos del soundboard.

- ✅ Logos del servidor (.png).

- ✅ install.sql — schema de BD.

El resto del código está protegido con Cfx Escrow oficial.

---

⚡ Rendimiento

- Streamer 3D con Wait gating: 150ms cuando hay actividad, 3000ms cuando no hay puntos.

- Raycast de oclusión cada 3 ticks (no cada tick).

- Cache dedup + orphan cleanup automático (60s).

- Anim del DJ pausada cuando la UI está oculta.

- Throttling anti-flood en todos los eventos de red (150ms por src).

- Idle: 0.00 – 0.02 ms.

---

🎁 Bonus incluido

- Backend Node.js opcional para metadata YouTube (título/thumb/duración) — auto-instalable con INSTALAR.bat.

- yt-dlp.exe incluido (auto-detectado, con soporte cookies opcional).

- Auto-update de yt-dlp con token de seguridad.

- 9 sonidos MP3 de ejemplo para el soundboard.

---

📋 Requisitos

- FXServer build ≥ 5181 (recomendado)

- OneSync activado

- Lua 5.4

- Cliente FiveM moderno con CEF actualizado

---

💬 Soporte

- Discord de soporte incluido en la descripción de Tebex.

- Actualizaciones gratuitas de por vida para la v0.x.

- Sin dependencias de recursos externos frágiles = actualiza cuando quieras.

---

FYT-PROSOUND v0.7.0 — hecho por FYT-SCRIPS para ciudades RP que quieren música de verdad, no un reproductor genérico más.

▎ 🚫 No redistribuir · No revender · Licencia individual por servidor · Sistema Escrow Cfx oficial