🛡️ [FiveM] ¡EL PANEL DE ADMINISTRACIÓN DEFINITIVO! | DP-AdminMenu 🛡️

📝 Descripción General

¡Toma el control absoluto de tu servidor FiveM! DP-AdminMenu es un panel de administración extremadamente completo, intuitivo y avanzado, diseñado y desarrollado desde cero por DP-Scripts (actualmente optimizado para QB-Core). Su interfaz moderna y fluida permite gestionar todos los aspectos del servidor en tiempo real, desde la moderación de jugadores hasta la edición de bases de datos, todo sin salir del juego ni tocar código.

¿Qué es y qué hace?

Es un ecosistema completo para el equipo de Staff. Entre sus múltiples sistemas integrados destacan:

- 👥 Gestión de Jugadores: Listado en tiempo real con panel de control individual. Permite ver múltiples datos (inventario, propiedades, vehículos, constantes vitales), espiar/espectear, tomar capturas de su pantalla, controlarlos y acceder a un menú troll avanzado.
- ⚡ Acciones Globales: Apartado para controlar opciones del administrador (noclip, godmode), vehículos (reparar, tunear, borrar), servidor (anuncios, clima, limpieza de entidades) y herramientas de desarrollo (coordenadas, visor de entidades).
- 🚨 Sistema de Reportes: Gestión de tickets integrada con soporte para previsualización de imágenes adjuntas.
- 🔨 Sanciones y Castigos: Sistema custom de Baneos, Kicks, Warns y CK de personajes gestionable 100% desde la interfaz, sin necesidad de entrar a la base de datos externa.
- 💬 Chat de Staff Avanzado: Canal privado in-game con integración de iconos, gifs, videos y previsualización de imágenes directamente en el menú.
- 💼 Gestor de Trabajos y Bandas: Auto-detección del framework. Muestra listas de jugadores en cada trabajo/banda, sus rangos, salarios y permite crear, editar o eliminar oficios y rangos al vuelo.
- 🚗 Catálogo de Vehículos: Detecta todos los vehículos, muestra iconos auto-ajustables, categorías, precios y códigos de spawn. Puedes spawnearlos para ti, para otro jugador o enviarlos directamente al garaje de alguien con las llaves puestas.
- 📦 Gestor de Ítems Global: Base de datos en vivo de todos los objetos y armas. Muestra su icono real, peso, munición y permite dártelo o enviarlo a cualquier jugador conectado.
- 📊 Dashboard y Estado del Servidor: Panel principal con métricas en tiempo real (jugadores, admins on, tiempo de sesión, reportes), gráficas interactivas (diario, semanal, mensual) y registro de actividad (logs de qué admin hizo qué).
- ⚙️ Configuración al Vuelo: Sistema de Whitelist propio activable desde el menú, Staff Mode (para recibir o no notificaciones), escala de la interfaz ajustable y posicionamiento libre (arrastrar y soltar) por la pantalla.
- 🛡️ Seguridad Integrada: Anti-Cheat básico incluido y múltiples ventanas de confirmación (modals) rediseñadas para una experiencia de usuario (UX) impecable y segura.

¿Cómo funciona?

Al usar el comando o tecla de acceso configurada, la interfaz (NUI) bloqueará o no la cámara (según tus preferencias) y te presentará un Dashboard con los datos vitales del servidor.

A través de sus pestañas superiores, los administradores pueden navegar de forma instantánea entre la lista de jugadores, el catálogo de ítems, el chat interno o la gestión de clanes. Al interactuar con cualquier botón (ej. "Banear", "Dar Ítem" o "Cambiar Clima"), el script abre modales modernos y limpios que piden confirmación o datos adicionales (como tiempo de sanción, garaje de destino o color de coche). Todo se sincroniza en tiempo real con tu base de datos y con el cliente de los demás jugadores.

¿Qué te permite?

✅ Moderar jugadores de forma encubierta o directa 🕵️.
✅ Gestionar la base de datos (Trabajos, Bandas, Bans) sin salir del juego 💻.
✅ Entregar vehículos directamente a garajes (compatible con DP-Garages) 🔑.
✅ Visualizar gráficas de flujo de jugadores y rendimiento 📈.
✅ Mantener un chat privado de Staff con multimedia 💬.
✅ Sancionar y registrar historial de castigos automáticamente ⚖️.
✅ Configurar tu propio entorno (Clima, Hora, Apagones) al instante ⛈️.
✅ Tener un control total sobre el inventario y las propiedades (compatible con DP-Propiedades) 🏠.
✅ Escalar y mover el panel libremente a tu gusto 🎨.

🚀 Instalación

Requisitos previos

- Servidor FiveM con QB-Core instalado y actualizado.
- Base de datos MySQL configurada (oxmysql).

Pasos de instalación

1. **Descargar el script** desde el repositorio oficial o tienda de DP-Scripts.
2. **Colocar la carpeta** en tu servidor (preferiblemente dentro de tu carpeta `[admin]` o `[qb]`) con el nombre exacto `DP-AdminMenu`.
- ⚠️ Asegúrate de no renombrar el recurso para evitar problemas de rutas HTML/JS.
3. **Configuración de la Base de Datos**.
- Abre el archivo `bans_warns.sql` (o el nombre que tenga tu archivo SQL incluido).
- Ejecútalo en tu base de datos para generar las tablas necesarias para el sistema de sanciones, warns y logs.
4. **Configuración del script**.
- Revisa el archivo `config.lua` o `server/config.lua` para establecer los permisos necesarios (god, admin, mod) y las teclas de apertura.
5. **Asegurar el recurso**.
- Añade `ensure DP-AdminMenu` en tu archivo `server.cfg`.

⚙️ Dependencias

Este script está diseñado para funcionar nativamente con el entorno QB.

📦 Requisitos del Sistema

Recurso	Descripción / Estado
qb-core	🔴 OBLIGATORIO
oxmysql	🔴 OBLIGATORIO
DP-Garages	🟢 OPCIONAL
DP-Notify	🟢 OPCIONAL
DP-Fuelv2	🟢 OPCIONAL
DP-Propiedades	🟢 OPCIONAL

🖼️ Vistas Previas

Explora el poder y el diseño de las distintas secciones del panel.

Lista de jugadores activos

Lista de acciones disponibles

Lista de reportes activos

Lista de baneos activos

Chat interno

Lista de trabajos

Lista de organizaciones

Catálogo de vehículos

Gestor de ítems

Panel de gestiones

OTROS

🎥 Video Demostrativo

Ver Funcionamiento

🔮 Posibles Mejoras Futuras

El panel ya es increíblemente robusto, pero el roadmap de desarrollo contempla opciones de expansión interesantes:

🚧 Roadmap y Sugerencias

IDEA	EXPLICACIÓN
Soporte Multi-Framework	Adaptar el backend para que sea 100% compatible con ESX, Qbox y Standalone.
Integración con Discord	Enviar logs automáticos (baneos, kicks, spawn de objetos) a webhooks de Discord.
Permisos Granulares (ACL)	Permitir que ciertos roles (ej. Moderador) solo vean ciertas pestañas y no el root.
Sistema Multi-Idioma	Configuración rápida de traducciones (EN, ES, FR, DE) desde el config.lua.
Notas de Administrador	Un bloc de notas interno asociado a cada jugador que solo el Staff pueda leer.

---

Autor: DP-Scripts
Versión: 1.2.5