DP-Hud - Sistema de Interfaz Minimalista y Completa (QBCore)

📝 Descripción General

DP-Hud es un script de interfaz (HUD) de nueva generación diseñado para servidores FiveM con el framework QBCore. Ofrece una experiencia de usuario minimalista y completa, dividida en dos componentes principales: el HUD de Personaje (indicadores vitales) y el HUD de Vehículo (velocímetro avanzado). Su diseño se centra en la estética moderna, el rendimiento óptimo y la integración profunda con otros sistemas clave.

✨ Características Principales

¿Qué es y qué hace?

- HUD de Personaje: Visualización esencial de los estados vitales del jugador.
- HUD de Vehículo: Un velocímetro avanzado y detallado.
- Diseño simple, minimalista y altamente legible.
- Sincronización en tiempo real de todos los indicadores.
- Consumo de recursos extremadamente bajo (optimización QBCore).

HUD de Personaje: Indicadores Vitales

- Vida (Health): Barra de estado de salud.
- Armadura (Armor): Indicador del nivel de chaleco antibalas.
- Estrés (Stress): Medidor de la tensión psicológica del personaje.
- Hambre (Hunger) y Sed (Thirst): Barras de necesidades básicas.
- Oxígeno (Oxygen): Indicador clave para inmersiones o entornos gaseosos.
- Modo Invisible (Ghost Mode): Indicador visual discreto para modos de juego/administración.
- Modo Dev/Admin (Dev Mode): Indicador visual discreto para modos de juego/administración.
- Opciones para ocultar información sensible (ID, nombres) para la grabación de contenido.
- Opciones para ocultar Minimapa/GPS/Barras estilo cine.

HUD de Vehículo: Velocímetro Avanzado

- Velocidad y Marchas: Lectura digital de la velocidad y el indicador de marcha actual.
- Medidor de Combustible: Barra de estado del nivel de gasolina/diésel/electrico (compatible con DP-Fuel).
- Barra de RPM (Tacómetro): Visualización dinámica de las revoluciones del motor.
- Indicadores Clave: Limitador de velocidad, freno de mano y cinturón de seguridad.
- Hud dinamico... en cuando el vehiculo se para a 0 KM/H-MP/H se oculta totalmente, y solo es visible cuando el vehiculo sube de a 1 km/h-mp/h.

🚀 Instalación

Requisitos Previos

- Servidor FiveM con QBCore instalado.
- Sistema de base de datos MySQL configurado (se recomienda oxmysql).
- Una base de conocimientos básica sobre la gestión de recursos de FiveM.

Pasos de Instalación

1. Descargar el script desde la fuente oficial (única fuente autorizada).
2. Colocar la carpeta en tu servidor con el nombre exacto `DP-Hud`
- ⚠️ Importante: El nombre debe ser exactamente este para el correcto funcionamiento de las rutas NUI.
3. Iniciar el Recurso: Añadir `ensure DP-Hud` a tu archivo de configuración de recursos (`server.cfg`).

⚙️ Compatibilidades y Dependencias

El script está diseñado para funcionar perfectamente como un *standalone* de HUD, pero su verdadero potencial se desbloquea con las siguientes integraciones (OPCIONALES Y RECOMENDADAS POR EL AUTOR):

📦 Requisitos del Sistema y Integraciones

Recurso	Descripción	Enlace
qb-core	Framework principal (Oficial)	🔗 GitHub
DP-PauseMenu	Integración de estadísticas en el menú de pausa.	(DP-Scripts Oficial)
DP-Skills	Indicador de niveles/experiencias en el HUD.	(DP-Scripts Oficial)
DP-VehicleMilege	Sincronización de estadísticas de uso de vehículos (kilometros totales recorridos con cada vehículo).	(DP-Scripts Oficial)
DP-Fuel	Lectura precisa del medidor de combustible.	(DP-Scripts Oficial)
DP-Nitrous	Indicador visual del nivel de óxido nitroso y purgas.	(DP-Scripts Oficial)
DP-Garages	Sincronización del estado de garaje/depósito en el mapa.	(DP-Scripts Oficial)
DP-TextUI	Sincronización del hud del TextUI de DP-Scripts.	(DP-Scripts Oficial)

📂 Estructura de Archivos

🖥️ Estructura del Recurso DP-Hud

DP-Hud/
├── 📁 modules/
│   └── 🔵 cl.lua - Lógica del lado del cliente para la gestión de estados y eventos de QBCore.
├── 📁 nui/ - Interfaz de usuario (HTML/CSS/JS) y recursos para la visualización del HUD.
│   ├── 📁 font/
│   │   └── 📄 bankgothic.ttf - Fuente personalizada para la estética del velocímetro.
│   ├── 🌐 index.html - El contenedor principal de la interfaz (NUI).
│   ├── 📄 script.js - Manejo de la lógica de eventos y datos entre Lua y NUI.
│   └── 🎨 style.css - Estilos visuales de la interfaz.
├── 📁 stream/ - Archivos de recursos que se transmiten a los clientes, como modificaciones del minimapa.
│   └── 📄 Cosas del minimapa
├── ⚙️ Golden.Minimap.net.dll - Componente clave para la personalización del minimapa y optimización.
├── 📄 Golden.Minimap.net.pdb - Archivo de depuración para el componente .dll.
├── 📖 README.md - Este archivo.
└── 🔵 fxmanifest.lua - El manifiesto del recurso.

💡 Datos Técnicos: El uso de una DLL y la separación de lógica en módulos permite un rendimiento superior, manteniendo un consumo de recursos inferior a 0.01ms en reposo (y picos máximos de 0.02ms en vehículos).

📊 Vista Previa de la Interfaz

Aquí tienes una lista de las vistas previas de tu script.

Details

HUD de Personaje: Indicadores Vitales

HUD + MINIMAPA + DP-TextUI

HUD + MINIMAPA

HUD

HUD al completo

Details

HUD de Vehículo: Velocímetro Avanzado

Velocimetro + DP-VehicleMileage + DP-Nitrous

Velocimetro + DP-VehicleMileage + Combustible > 50

Velocimetro + DP-VehicleMileage + Combustible <= 40

Velocimetro + DP-VehicleMileage + Combustible <= 30

Velocimetro + DP-VehicleMileage + Combustible <= 20

Velocimetro + DP-VehicleMileage + Combustible <= 10

Velocimetro al completo

Details

OTROS

Todo al completo

Con barras

MAPA

Details

Video Demostrativo

🔮 Próximas Mejoras y Expansiones (Roadmap)

🚧 En Desarrollo y Próximamente

HUD de Vehículo - Funcionalidad Adicional

Función	Descripción
Sistema de Cruise Control	Indicador visual de velocidad de crucero activo.
Sistema de Daño Visual	Un pequeño indicador de coche que muestra las partes dañadas (puertas, neumáticos).
Lectura de Temperatura del Motor	Indicador que muestra si el motor se está sobrecalentando.
Integración con GPS	Flecha de navegación sencilla y discreta en el velocímetro.
Iconos de Estado de Buff/Debuff	Pequeños iconos para estados temporales (borracho, drogado, sangrando, etc.).

Optimización y Arquitectura

Función	Descripción
Sistema de Preload de Fuente	Carga de recursos optimizada para evitar lag spikes al iniciar el HUD.
Refactorización CSS/JS	Migración a SASS/TypeScript para una mejor mantenibilidad (solo interno).
Soporte Multi-Resolución	Ajustes automáticos aún más finos para monitores Ultra-Wide.

🛑 Términos de Uso y Licencia (Propiedad Exclusiva)

Este script está protegido por una licencia de Propiedad Exclusiva (Proprietary License).

NO está permitido, bajo ninguna circunstancia, modificar, distribuir, vender, re-empaquetar o publicar este script, o cualquier parte de su código, sin la autorización escrita y expresa del autor. El incumplimiento de esta licencia dará lugar a acciones legales.

👨‍💻 Autor

DP-Scripts Versión: 1.0.0 (Lanzamiento Inicial)