Skip to content

DonPlastico/DP-PedsSystem

Repository files navigation

Sistema avanzado de gestión de Peds para FiveM (QBCore)

DP-PedSystem Logo

License FiveM QBCore

📝 Descripción General

DP-PedSystem es un sistema avanzado de gestión de "PEDS" diseñado para servidores de FiveM que utilizan el framework QBCore. Este script permite a los jugadores y administradores asignar, gestionar y utilizar diferentes modelos de peds de forma persistente (guardados en la base de datos) o temporal.

¿Qué es y qué hace?

- Permite a los jugadores cambiar su apariencia a una ped específica asignada.
- Los administradores pueden gestionar peds para los jugadores.
- Persistencia de datos: las peds se guardan en la base de datos.

¿Cómo funciona?

- Sistema basado en comandos y menús interactivos (DP-Menu y qb-input).
- Los jugadores pueden acceder a un menú personal para gestionar sus peds.
- Los administradores tienen un menú especial con funcionalidades avanzadas.
- Persistencia de datos manejada a través de oxmysql.

¿Qué te permite?

✅ Gestión completa de Peds para jugadores (seleccionar, renombrar, eliminar).
✅ Asignación de Peds por administradores.
✅ Persistencia de datos en base de datos MySQL.
✅ Menús interactivos con DP-Menu y qb-input.
✅ Sistema de backup automático.
✅ Notificaciones personalizables.
✅ Configuración flexible de grupos de admin.


🚀 Instalación

Requisitos previos

- Servidor FiveM con QBCore instalado.
- MySQL configurado (oxmysql).
- Dependencias requeridas (ver sección siguiente).

Pasos de instalación

1. **Descargar el script** desde el repositorio oficial.
2. **Colocar la carpeta** en tu servidor con el nombre exacto `DP-PedsSystem`.
- ⚠️ El nombre debe ser exactamente este para evitar problemas.
3. **Configuración de la Base de Datos**..
El script creará automáticamente la tabla player_peds en tu base de datos MySQL al iniciar, si no existe. No necesitas importar ningún archivo .sql manualmente..
(Asegúrate de que tu servidor tenga acceso a la base de datos configurada para oxmysql.).


⚙️ Dependencias

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

📦 Requisitos del Sistema

Recurso Descripción Enlace
QB qb-core Framework principal 🔗 GitHub
Menu DP-Menu Sistema de menús interactivos 🔗 GitHub
Input qb-input Sistema de inputs 🔗 GitHub
OX oxmysql Conexión MySQL avanzada 🔗 GitHub
💡 Nota: Todos los recursos deben estar en el server.cfg y cargarse antes de DP-PedSystem.

Orden recomendado en server.cfg

```cfg.
ensure oxmysql.
ensure qb-core.
ensure DP-Menu.
ensure qb-input.
ensure DP-PedsSystem.
⚠️ Nota importante: El script utiliza ExecuteCommand("refreshskin") para volver a la apariencia original. Asegúrate de que tu servidor tenga un script que maneje este comando o una funcionalidad similar.


📂 Estructura de Archivos

🖥️ Mostrar estructura completa y descripción

dp-pedsystem/
├── fxmanifest.lua
├── shared/
│ └── config.lua
├── client/
│ ├── cl_main.lua
│ └── cl_commands.lua
└── server/
├── sv_main.lua
└── sv_commands.lua

Archivo Función Principal Dependencias
fxmanifest.lua Configuración principal del recurso qb-core, oxmysql
shared/config.lua Configuración modificable -
client/cl_main.lua Interfaz de usuario y lógica DP-Menu, qb-input
client/cl_commands.lua Comando /peds qb-core
server/sv_main.lua Persistencia en base de datos oxmysql
server/sv_commands.lua Comando admin /verpeds qb-core

** 💡 Datos Técnicos:** La estructura está optimizada para consumo mínimo de recursos (0.01ms) y máxima compatibilidad con QBCore.



🛠️ Configuración (config.lua)

El archivo shared/config.lua te permite personalizar el script según tus necesidades.

⚙️ Mostrar configuración

image
Archivo Función Principal
AdminGroups Una tabla de cadenas que define los grupos de permisos de QBCore que se consideran administradores y que pueden usar los comandos y funcionalidades de administración. Puedes añadir o quitar grupos según la configuración de tu servidor.
Commands Define los nombres de los comandos que los jugadores y administradores usarán en el juego. Puedes cambiarlos a tu gusto.
viewPeds Comando para que los administradores vean las peds de un jugador.
playerPeds Comando para que los jugadores abran su menú de peds.
Notifications Contiene todos los mensajes de notificación que el script envía a los jugadores. Puedes personalizar estos mensajes para que se ajusten al tono de tu servidor.


🎮 Comandos

Aquí tienes una lista de los comandos disponibles en el DP-PedSystem.

👤 Jugadores

Comando Descripción
/peds Menú de gestión de peds.

👑 Administradores

Comando Descripción
/verpeds [ID] Gestionar peds de jugador.


🖼️ Vistas Previas

Aquí tienes una lista de los comandos disponibles en el DP-PedSystem:
Details

Comando + Menú /verpeds [ID] (Admins)

image image

Details

Dar ped -> /verpeds [ID] (Admins)

image image image

Details

Opciones de cualquier ped -> /verpeds [ID] (Admins)

image image

Details

Comando + Menú /peds (Todo el mundo)

image image

Details

Opciones de cualquier ped -> /peds (Todo el mundo)

image image image image image

Details

Ambos menús sin PEDS disponibles/asignadas

image image



🔮 Posibles Mejoras Futuras

El DP-PedSystem es un script robusto, pero siempre hay espacio para mejoras y nuevas funcionalidades. Aquí hay algunas ideas que es muy probable que en futuro no muy lejano, yo mismo las realice y os actualice el script con las nuevas funciones: (YA ESTOY TRABANDO EN ELLO...)

🚧 En desarrollo

IDEA EXPLICACIÓN
Interfaz gráfica moderna (NUI) Integración con una UI más visual y moderna (por ejemplo, HTML/NUI) para la selección y gestión de peds, en lugar de solo menús de texto. Esto permitiría previsualizaciones de las peds antes de seleccionarlas.
Buscador Un buscador dentro del menú de peds para facilitar la búsqueda cuando un jugador tiene muchas peds.
Sistema de categorías Implementar un sistema de categorías para organizar las peds (ej. "Civiles", "Policía", "Trabajos", "Peds Personalizadas").
Peds favoritas Permitir a los jugadores marcar peds como "favoritas" para un acceso rápido.
Permisos más granulares ñadir la posibilidad de restringir ciertas peds a grupos de trabajo específicos o a jugadores con ciertos permisos.
Tienda de peds Integrar un sistema donde los jugadores puedan comprar nuevas peds con dinero. (Items/Moneda Custom/Moneda como cash-bank-black_money-crypto/Moneda real a traves de patreon/vips/donativos/paypal ETC...)
Eventos personalizados Añadir eventos que permitan a otros scripts interactuar con el sistema de peds (ej. un script de trabajo que asigne automáticamente una ped de trabajo al iniciar sesión).
Soporte multi-framework Aunque actualmente está centrado en QBCore, se podría considerar la compatibilidad con otros frameworks como ESX. (En proceso. Pronto actualización con frameworks de QBCORE / ESX / OLD QBCORE / OLD ESX / VRP / QBOX / OX)

Autor: DP-Scripts
Versión: 1.0.0

About

DP-PedSystem es un sistema avanzado de gestión de "PEDS" diseñado para servidores de FiveM que utilizan el framework QBCore. Este script permite a los jugadores y administradores asignar, gestionar y utilizar diferentes modelos de peds de forma persistente (guardados en la base de datos) o temporal.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages