Sistema de inventario QBCore

Sistema de Inventario QBCore – Gestión Moderna de Objetos para Servidores FiveM

Actualiza tu servidor QBCore con un sistema de inventario completo que lleva la gestión de elementos intuitiva por arrastrar y soltar a FiveM. Esta solución de inventario integral reemplaza las listas básicas de elementos con una interfaz de cuadrícula visual donde los jugadores pueden organizar sus pertenencias, transferir elementos entre contenedores e interactuar con los sistemas de almacenamiento de manera natural. Es la base para economías de rol inmersivas, sistemas de artesanía e interacciones de jugadores que se sienten modernas y pulidas.

El sistema de inventario QBCore maneja todo, desde los bolsillos de los jugadores hasta los maleteros de los vehículos, las casas de escondite hasta las vitrinas de las tiendas. Los elementos tienen peso, ocupan espacio en el inventario y pueden organizarse visualmente como prefieran los jugadores. El sistema se integra sin problemas con los trabajos, tiendas e uso de elementos de QBCore, creando una experiencia cohesionada donde la gestión del inventario se siente como una parte natural del juego en lugar de una tarea de menú.

¿No se carga la vista previa del video? Haz clic aquí: https://streamable.com/5g0qls

Qué está incluido

Obtienes un marco de inventario completo con inventario de jugador, espacios de barra de acceso rápido, descripciones emergentes de objetos, gestión de peso y sistemas de contenedores. La interfaz visual muestra íconos de objetos, cantidades y metadatos de un vistazo. Los jugadores pueden arrastrar objetos entre espacios, dividir pilas y transferir rápidamente con atajos de teclado. El sistema incluye acceso al inventario para vehículos (maleteros, guanteras), propiedades (escondites, refrigeradores), objetos caídos (botín en el suelo) y tiendas.

El backend maneja toda la complejidad: durabilidad de objetos, almacenamiento de metadatos (accesorios de armas, calidad de objetos, información del propietario), cálculos de peso, gestión de espacios y verificaciones de permisos. Todo se sincroniza correctamente en multijugador, evita exploits de duplicación y se integra con el sistema de objetos existente de QBCore sin romper la compatibilidad con tus scripts actuales.

Características principales

• Interfaz de arrastrar y soltar – Inventario de cuadrícula visual con arrastrar, soltar e intercambio de objetos entre espacios de forma fluida
• Gestión de Peso y Espacios – Cada objeto tiene peso, el inventario tiene límites de capacidad, con indicadores visuales claros cuando está lleno
• Sistema de Barra de Acceso Rápido – Espacios de acceso rápido para objetos de uso frecuente, vinculados a teclas numéricas para uso instantáneo
• Metadatos de Objetos – Almacena datos personalizados por objeto (números de serie de armas, calidad de alimentos, información de creador, durabilidad)
• Soporte de contenedores – Accede a maleteros de vehículos, escondites de propiedades, bolsas caídas y almacenamiento compartido con la misma interfaz
• División de Pilas – Haga clic derecho para dividir pilas de elementos en cantidades personalizadas, perfecto para el comercio o la distribución
• Información sobre herramientas de los artículos – Pasa el cursor sobre los objetos para ver información detallada, estadísticas y usabilidad
• Sistema de Dejar y Recoger – Deja objetos en el suelo como objetos físicos, ve bolsas de botín caídas en escenas del crimen
• Integración con tiendas – Interfaces de tienda visuales donde arrastras objetos para comprar/vender, con visualización de precios y confirmaciones de transacción
• Visualización de Accesorios de Armas – Ve los accesorios de armas equipados directamente en el inventario, gestiona equipamientos visualmente
• Atajos de Inventario – Controles de teclado para uso rápido de objetos, transferir todo, ordenar inventario y saqueo rápido
• Sistema de Durabilidad de Objetos – Los objetos se degradan con el uso, requiriendo reparación o reemplazo con el tiempo
• Funcionalidad de búsqueda – Filtra inventarios grandes por nombre de objeto para acceso rápido
• Controles de Permisos – Establece quién puede acceder a contenedores específicos, útil para escondites de pandillas o armarios de pruebas policiales
• Protección contra exploits – La validación del lado del servidor evita la duplicación de objetos, la manipulación del peso y la piratería del inventario

Perfecto para

• Servidores Roleplay – Proporciona una interacción inmersiva con el inventario para trabajos, comercio y actividades diarias
• Servidores económicos – Base esencial para el comercio entre jugadores, tiendas, artesanía y economías basadas en objetos
• Servidores de Supervivencia – Los límites de peso y la gestión del inventario añaden un desafío de supervivencia al saqueo y la recolección de recursos
• Roleplay Criminal – Tráfico visual de drogas, comercio de armas y transporte de contrabando con restricciones realistas de inventario
• Sistemas de Trabajos – Mecánicos transportando piezas, chefs gestionando ingredientes, policías organizando pruebas: todos usan el mismo sistema intuitivo

Cómo funciona

Los jugadores abren su inventario con una tecla configurable (I o Tabulador por defecto según la configuración). La interfaz muestra los espacios disponibles en una cuadrícula, con los espacios ocupados mostrando iconos y cantidades de objetos. Al pasar el cursor sobre un objeto se revela información detallada: qué es, para qué sirve, propiedades especiales o metadatos. Al hacer clic y arrastrar, puedes reorganizar, mover objetos a diferentes inventarios (maletero del vehículo, otro jugador, tienda) o dejarlos caer al suelo.

El sistema de peso proporciona restricciones realistas: no puedes llevar 500 armas y drogas ilimitadas. Cada objeto tiene un peso configurado y tu capacidad de carga total es limitada. Cuando estás al peso máximo, necesitarás dejar objetos o guardarlos en un vehículo antes de recoger más. Esto crea decisiones significativas sobre qué llevar y fomenta el uso de sistemas de almacenamiento.

Los inventarios de vehículos funcionan de manera idéntica al inventario del jugador. Abre un maletero y verás tanto tu inventario personal como el almacenamiento del vehículo lado a lado. Arrastra objetos entre ellos para cargar/descargar. Diferentes vehículos tienen diferentes capacidades de almacenamiento: un auto deportivo tiene espacio mínimo en el maletero, mientras que una furgoneta puede transportar carga pesada. Los escondites de propiedades funcionan de la misma manera, permitiéndote organizar casas seguras con armas almacenadas, drogas o inventario de negocios legítimos.

Instalación

1. Extrae el recurso qb-inventory a la carpeta de recursos de tu servidor
2. Reemplaza o desactiva tu sistema de inventario existente (el inventario básico de qb-core)
3. Añade “ensure qb-inventory” a server.cfg después de que qb-core se cargue
4. Importa el archivo SQL para crear las tablas de base de datos necesarias para el almacenamiento de objetos
5. Configura los ajustes del inventario en config.lua (peso máximo, número de espacios, ruta de imágenes de objetos)
6. Añade imágenes de objetos a la carpeta html/images/ (PNGs para cada objeto en tu servidor)
7. Reinicia el servidor: los jugadores ahora usarán el nuevo sistema de inventario
8. Actualiza cualquier script personalizado para usar las exportaciones de qb-inventory en lugar de las funciones antiguas de inventario

Compatibilidad del marco

• ✅ QBCore – Integración nativa, diseñada específicamente para el framework QBCore
• ✅ QBOX – Compatible con QBOX (fork de QBCore), funciona con cambios mínimos
• ❌ ESX – Construido para QBCore, requeriría una reestructuración significativa para la compatibilidad con ESX

Configuración y personalización

El archivo de configuración le permite ajustar la capacidad del inventario (predeterminado 50 ranuras), los límites máximos de peso (varía según la configuración, típicamente 120-150 kg) y la cantidad de ranuras de la barra de acceso rápido. Puede establecer diferentes capacidades para los tipos de vehículos: las motocicletas tienen menos almacenamiento que los camiones. Configure si los elementos caídos crean props físicos o solo zonas de interacción. Establezca los permisos de acceso al inventario para trabajos, pandillas o propiedades específicas.

La configuración de elementos se maneja a través de la tabla compartida de elementos de QBCore, donde define el peso, la usabilidad y los campos de metadatos de cada elemento. El sistema de inventario lee estos datos y los aplica automáticamente. ¿Quiere que las armas tengan durabilidad? Actívelo en la configuración y agregue seguimiento de durabilidad a los elementos de armas. ¿Necesita que los alimentos tengan calificaciones de calidad? Agregue metadatos de calidad a los elementos consumibles. El sistema es lo suficientemente flexible como para soportar cualquier propiedad de elemento que necesite su servidor.

La personalización visual es sencilla: la interfaz HTML/CSS puede volver a estilizarse para que coincida con el tema de su servidor. Las imágenes de los elementos son archivos PNG simples que puede reemplazar o agregar según sea necesario. El diseño, los colores, las fuentes y las animaciones son todos personalizables si desea que el inventario tenga una apariencia única para la marca de su servidor.

Lo que lo hace destacar

Esto no es solo otro script de inventario: se ha convertido en el estándar de la comunidad para los servidores QBCore porque maneja la complejidad correctamente. Los errores de duplicación de elementos se previenen mediante validación del lado del servidor. Los cálculos de peso funcionan correctamente con fracciones. Los contenedores se sincronizan correctamente en escenarios multijugador. El UI es receptivo y no se ralentiza al gestionar inventarios grandes. Estos detalles importan cuando está ejecutando un servidor poblado donde los errores de inventario pueden destruir su economía.

El desarrollador ha utilizado claramente este sistema en servidores de producción, porque maneja casos extremos que otros sistemas de inventario pasan por alto. ¿Qué sucede cuando dos jugadores intentan tomar el último elemento de un escondite simultáneamente? ¿Y si alguien se desconecta mientras arrastra un elemento? ¿Qué pasa con los vehículos que desaparecen mientras los elementos están en el maletero? Todos estos escenarios se manejan con gracia sin pérdida o duplicación de elementos. Ese es el pulido que separa un script funcional de un sistema de producción confiable.

Detalles Técnicos

• Rendimiento del cliente: UI ligero con renderizado optimizado, impacto mínimo en FPS cuando está abierto
• Rendimiento del servidor: Consultas de base de datos eficientes, datos de inventario en caché reducen la sobrecarga de búsqueda
• Base de datos: Usa tablas MySQL para almacenamiento persistente, correctamente indexadas para rendimiento
• Optimización de la red: Solo sincroniza las ranuras cambiadas, no todo el inventario en cada actualización
• Imágenes de elementos: Soporta formato PNG, se recomienda 150x150px para una visualización óptima
• Seguro para multijugador: Todas las acciones se validan del lado del servidor, previene explotaciones de manipulación del cliente

Integración con Otros Sistemas

El sistema de inventario exporta funciones que otros recursos pueden llamar: AddItem, RemoveItem, GetInventory, CanCarryItem y más. Esto significa que sus scripts de trabajo, sistemas de artesanía y tiendas pueden interactuar con el inventario del jugador de manera programática. Un trabajo de mecánico puede verificar si el jugador tiene piezas de reparación antes de permitir una reparación. Un script de drogas puede verificar el espacio en el inventario antes de agregar el producto. Todo se conecta a través de exportaciones estandarizadas.

Para los desarrolladores que construyen scripts personalizados, el inventario proporciona eventos y devoluciones de llamada. Disparar un evento cuando los elementos se usan, se eliminan o se dejan caer. Conectarse a la apertura del inventario para agregar validación personalizada. Escuchar cambios en los metadatos de los elementos para actualizar sistemas externos. El marco es extensible sin necesidad de modificar los archivos principales, manteniendo su configuración compatible con actualizaciones cuando se lancen nuevas versiones.

El inventario del vehículo se integra con la mayoría de los sistemas de llaves/propiedad del vehículo. Solo los jugadores autorizados pueden acceder al maletero de un vehículo, evitando que jugadores aleatorios saquen cosas de su coche. Los escondites de propiedades se conectan a los sistemas de vivienda/territorio de pandillas, por lo que solo los miembros de la pandilla pueden acceder al escondite de la pandilla. Los inventarios de las tiendas pueden ser reabastecidos por jugadores autorizados, creando oportunidades de negocios gestionados por jugadores. El sistema de permisos es lo suficientemente flexible como para soportar cualquier escenario de control de acceso que necesite su servidor.

Soporte y Actualizaciones

Como uno de los recursos más utilizados de QBCore, el sistema de inventario se beneficia de las pruebas y comentarios de la comunidad. Los errores se identifican y se corrigen rápidamente porque miles de servidores están ejecutando este código. Las actualizaciones mantienen la compatibilidad con los cambios del marco QBCore, por lo que no se encontrará atascado en versiones antiguas porque el inventario se rompió. La base de código también está bien documentada, lo que facilita la solución de problemas o la adición de características personalizadas específicas para su servidor.