DP-Extras - Sistema de Extras/Livery's para Vehículos (Police/EMS/Mechanic/Sheriff...) (QBCore)

📝 Descripción General

DP-Extras es un sistema avanzado de gestión/personalización de vehículos de trabajo, diseñado para servidores de FiveM que utilizan el framework QBCore. Este script permite a los oficiales de policía o de los jobs indicados, modificar extras, liveries, lavar y reparar sus vehículos en estaciones designadas.

¿Qué es y qué hace?

- Permite activar/desactivar extras de vehículos policiales.
- Sistema para cambiar liveries y diseños de vehículos.
- Opciones para lavar y reparar vehículos con progress bars.
- Interfaz de menú intuitiva con DP-Menu.
- Soporte para ambos sistemas de texto: DP-TextUI y qb-core.

¿Cómo funciona?

- Los jugadores deben estar en un vehículo y tener el job "police" o el indicado/s en el config.lua.
- Se accede al sistema mediante un marcador en la comisaría. (Ubicaciónes editables...)
- Interfaz de menú con opciones para extras, liveries, lavado y reparación.
- Progress bars visuales para todas las acciones.
- Sincronización completa de cambios entre jugadores.

¿Qué te permite?

✅ Gestión completa de extras de vehículos (activar/desactivar).
✅ Cambio de liveries y diseños de vehículos.
✅ Lavado y reparación de vehículos con animaciones.
✅ Interfaz de menú moderna con DP-Menu.
✅ Soporte configurable para DP-TextUI o qb-core text.
✅ Tiempos configurables para todas las acciones.
✅ Restricción por jobs/gangs/civil.
✅ Marcador visuales.

🚀 Instalación

Requisitos previos

- Servidor FiveM con QBCore instalado.
- DP-Menu para la interfaz de menús.
- Opcional: DP-TextUI para texto personalizado.

Pasos de instalación

1. **Descargar el script** desde el repositorio oficial.
2. **Colocar la carpeta** en tu servidor con el nombre exacto `DP-Extras`.
- ⚠️ El nombre debe ser exactamente este para evitar problemas.
3. **Configurar** el archivo config.lua según tus necesidades.

⚙️ Dependencias

El script requiere las siguientes dependencias (deben estar instaladas y configuradas):

📦 Requisitos del Sistema

Recurso	Descripción	Enlace
qb-core	Framework principal	🔗 GitHub
DP-Menu	Sistema de menús	🔗 GitHub
DP-TextUI	Texto personalizado (opcional)	🔗 GitHub

💡 Nota: DP-TextUI es opcional. Puedes usar el sistema de texto de qb-core cambiando Config.UseDPTextUI = false

Orden recomendado en server.cfg

```cfg.
ensure qb-core ensure DP-Menu ensure DP-TextUI # Opcional ensure DP-Extras

⚠️ Nota importante: El script utiliza eventos del servidor para la sincronización de animaciones. Asegúrate de que ningún otro script entre en conflicto con los eventos definidos.

📂 Estructura de Archivos

🖥️ Mostrar estructura completa y descripción

DP-Extras/
├── 🔵 fxmanifest.lua
├── 🔵 config.lua
├── 🔵 client.lua
└── 📖 README.md

Archivo	Función Principal	Dependencias
fxmanifest.lua	Configuración principal del recurso	qb-core, DP-Menu, DP-TextUI
config.lua	Configuración completa del script	-
client.lua	Lógica principal del cliente	qb-core, DP-Menu, DP-TextUI (Opcional)

** 💡 Datos Técnicos:** Sistema optimizado con consumo mínimo de recursos (0.00-0.01ms) y máxima compatibilidad con QBCore.

🛠️ Configuración

El archivo config.lua permite personalizar completamente el script.

⚙️ Mostrar configuración

Parámetro	Descripción	Valores
Marker	Configuración del marcador visual	Tipo, tamaño, color, posición
JobRequired	Job que puede usar el sistema	"police" (configurable)
UseDPTextUI	Elegir sistema de texto	true = DP-TextUI, false = qb-core
ProgressTimes	Tiempos de las progress bars	Milisegundos para cada acción
Textos personalizables	Todos los textos traducibles y modificables	Puedes traducirlos a tu gusto
Iconos Font Awesome	Sistema de iconos completamente personalizable	Puedes modificarlos a tu gusto
Colores configurables	Paleta de colores editable para marcadores y UI	Puedes modificarlos a tu gusto
Tiempos ajustables	Cada acción tiene su tiempo configurable individualmente	Puedes modificarlos a tu gusto

🎮 Uso del Sistema

Para los que tengan el job

1. Ir a la comisaría - Ubicación: vector3(422.14, -1022.70, 28.57)
   
2. Subirse a un vehículo policial
   
3. Acercarse al marcador negro
   
4. Presionar E para abrir el menú
   
5. Seleccionar opción deseada:
   🎨 Livery's: Cambiar diseños del vehículo
   ⚙️ Extras: Activar/desactivar extras
   🧼 Lavar: Limpiar el vehículo
   🔧 Reparar: Reparar el vehículo
   

🖼️ Vistas Previas

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

Details

Menú Principal

Details

Selección de Livery's

Details

Selección de Extras

Details

Video Demostrativo

🔮 Posibles Mejoras Futuras

El DP-Extras es un sistema robusto, pero siempre hay espacio para mejoras:

🚧 Ideas en desarrollo

IDEA	EXPLICACIÓN
Múltiples ubicaciones	Añadir más estaciones de servicio en diferentes comisarías.
Sistema de permisos	Diferentes niveles de acceso según rango policial.
Costes económicos	Implementar costes por lavado/reparación usando dinero de sociedad
Más vehículos	Extender funcionalidad a otros jobs (mecánicos, EMS, etc.)
Animaciones personalizadas	Añadir animaciones durante las acciones de lavado/reparación
Sistema de sonidos	Efectos de sonido durante las acciones
Compatibilidad multi-framework	Soporte para ESX y otros frameworks

Autor: DP-Scripts
Versión: 1.0.0