Système d'inventaire QBCore

QBCore Système d'inventaire – Gestion moderne des articles pour serveurs FiveM

Mettez à niveau votre serveur QBCore avec un système d'inventaire complet qui apporte une gestion intuitive des articles par glisser-déposer à FiveM. Cette solution d'inventaire complète remplace les listes d'articles de base par une interface de grille visuelle où les joueurs peuvent organiser leurs affaires, transférer des articles entre conteneurs et interagir avec les systèmes de stockage de manière naturelle. C'est la base pour des économies de rôle immersives, des systèmes de craft et des interactions de joueurs qui semblent modernes et polis.

Le système d'inventaire QBCore gère tout, des poches des joueurs aux coffres de voiture, des planques aux vitrines de magasins. Les objets ont un poids, occupent de l'espace dans l'inventaire et peuvent être organisés visuellement comme les joueurs le préfèrent. Le système s'intègre parfaitement avec les emplois, les magasins et l'utilisation des objets QBCore, créant une expérience cohérente où la gestion de l'inventaire fait partie naturellement du gameplay plutôt qu'une corvée de navigation dans les menus.

L'aperçu vidéo ne se charge pas ? Cliquez ici

Ce qui est inclus

Vous obtenez un cadre d'inventaire complet avec inventaire du joueur, emplacements de barre d'outils, infobulles d'objets, gestion du poids et systèmes de conteneurs. L'interface visuelle affiche les icônes d'objets, les quantités et les métadonnées en un coup d'œil. Les joueurs peuvent faire glisser les objets entre les emplacements, diviser les piles et transférer rapidement avec des raccourcis clavier. Le système inclut l'accès à l'inventaire pour les véhicules (coffres, boîtes à gants), les propriétés (cachettes, réfrigérateurs), les objets abandonnés (butin au sol) et les magasins.

Le backend gère toute la complexité – la durabilité des objets, le stockage des métadonnées (accessoires d'armes, qualité des objets, informations du propriétaire), les calculs de poids, la gestion des emplacements et les vérifications des permissions. Tout se synchronise correctement en multijoueur, empêche les exploits de duplication et s'intègre avec le système d'objets existant de QBCore sans compromettre la compatibilité avec vos scripts actuels.

Caractéristiques principales

• Interface glisser-déposer – Inventaire visuel en grille avec glissage, dépôt et échange d'objets fluides entre les emplacements
• Gestion du poids et des emplacements – Chaque élément a un poids, l'inventaire a des limites de capacité, avec des indicateurs visuels clairs lorsqu'il est plein
• Système de barre d'accès rapide – Emplacements d'accès rapide pour les articles fréquemment utilisés, liés aux touches numériques pour un usage instantané
• Métadonnées des objets – Stocker des données personnalisées par article (numéros de série d'armes, qualité des aliments, informations sur l'artisanat, durabilité)
• Prise en charge des conteneurs – Accédez aux coffres de voiture, aux cachettes de propriété, aux sacs abandonnés et aux stocks partagés avec la même interface
• Division de piles – Cliquez avec le bouton droit pour diviser les piles d'objets en quantités personnalisées, parfait pour le commerce ou la distribution
• Infobulles des objets – Passez la souris sur les objets pour voir des informations détaillées, des statistiques et des utilisations
• Système de dépôt et de ramassage – Déposez des éléments au sol en tant qu'objets physiques, voyez les sacs de butin déposés sur les scènes de crime
• Intégration de la boutique – Interfaces de magasins visuelles où vous faites glisser les articles pour les acheter/vendre, avec des affichages de prix et des confirmations de transaction
• Affichage des accessoires d'arme – Voir les accessoires d'armes équipés directement dans l'inventaire, gérer les chargements visuellement
• Raccourcis d'inventaire – Contrôles clavier pour une utilisation rapide des objets, transfert de tout, tri de l'inventaire et pillage rapide
• Système de durabilité des objets – Les articles se dégradent avec l'usage, nécessitant des réparations ou des remplacements au fil du temps
• Fonctionnalité de recherche – Filtrez les grands inventaires par nom d'article pour un accès rapide
• Contrôles des permissions – Définir qui peut accéder à des conteneurs spécifiques, utile pour les caches de gangs ou les casiers à preuves de la police
• Protection contre les exploits – La validation côté serveur empêche la duplication d'articles, la manipulation du poids et le piratage de l'inventaire

Parfait pour

• Serveurs de jeu de rôle – Fournit une interaction immersive avec l'inventaire pour les emplois, le commerce et les activités quotidiennes
• Serveurs économiques – Fondation essentielle pour le commerce entre joueurs, les magasins, l'artisanat et les économies basées sur les objets
• Serveurs de survie – Limites de poids et gestion de l'inventaire ajoutent un défi de survie au pillage et à la collecte de ressources
• Jeu de rôle criminel – Vente de drogue visuelle, commerce d'armes et transport de contrebande avec des contraintes d'inventaire réalistes
• Systèmes d'emploi – Les mécaniciens transportant des pièces, les chefs gérant les ingrédients, les policiers organisant les preuves – tous utilisent le même système intuitif

Comment ça marche

Les joueurs ouvrent leur inventaire avec une touche configurable (par défaut I ou Tab selon la configuration). L'interface affiche les emplacements disponibles dans une grille, les emplacements occupés montrant les icônes et les quantités des articles. Le survol d'un article révèle des informations détaillées – ce que c'est, à quoi il sert, toute propriété spéciale ou métadonnée. En cliquant et en faisant glisser, vous pouvez réorganiser, déplacer des articles vers différents inventaires (coffre de voiture, autre joueur, magasin), ou les déposer au sol.

Le système de poids fournit des contraintes réalistes – vous ne pouvez pas porter 500 armes et des drogues illimitées. Chaque article a un poids configuré, et votre capacité de port totale est limitée. Lorsque vous êtes à poids maximum, vous devrez déposer des articles ou les stocker dans un véhicule avant d'en ramasser d'autres. Cela crée des décisions significatives sur ce qu'il faut porter et encourage l'utilisation des systèmes de stockage.

Les inventaires de véhicules fonctionnent de manière identique à l'inventaire des joueurs. Ouvrez un coffre et vous verrez à la fois votre inventaire personnel et le stockage du véhicule côte à côte. Faites glisser les articles entre eux pour charger/décharger. Différents véhicules ont des capacités de stockage différentes – une voiture de sport a un coffre minimal tandis qu'une fourgonnette peut transporter des marchandises sérieuses. Les caches de propriété fonctionnent de la même manière, vous permettant d'organiser des maisons sûres avec des armes, des drogues ou un inventaire d'entreprise légitime.

Installation

1. Extrayez la ressource qb-inventory dans le dossier des ressources de votre serveur
2. Remplacez ou désactivez votre système d'inventaire existant (l'inventaire de base de qb-core)
3. Ajouter “ensure qb-inventory” à server.cfg après le chargement de qb-core
4. Importez le fichier SQL pour créer les tables de base de données nécessaires au stockage des objets
5. Configurez les paramètres d'inventaire dans config.lua (poids maximal, nombre de slots, chemin des images des articles)
6. Ajouter les images des articles dans le dossier html/images/ (PNG pour chaque article sur votre serveur)
7. Redémarrer le serveur – les joueurs utiliseront désormais le nouveau système d'inventaire
8. Mettez à jour tout script personnalisé pour utiliser les exports de qb-inventory au lieu des anciennes fonctions d'inventaire

Compatibilité du framework

• ✅ QB-Core – Intégration native, conçue spécifiquement pour le framework QBCore
• ✅ QBOX – Compatible avec QBOX (fork QBCore), fonctionne avec des modifications minimales
• ❌ ESX – Conçu pour QBCore, nécessiterait une restructuration significative pour la compatibilité avec ESX

Configuration et personnalisation

Le fichier de configuration vous permet d'ajuster la capacité de l'inventaire (par défaut 50 emplacements), les limites de poids maximales (varie selon la configuration, généralement 120-150kg), et le nombre d'emplacements de la barre d'outils. Vous pouvez définir différentes capacités pour les types de véhicules – les motos ont moins de stockage que les camions. Configurez si les objets abandonnés créent des accessoires physiques ou simplement des zones d'interaction. Définissez les permissions d'accès à l'inventaire pour les emplois, les gangs ou des propriétés spécifiques.

La configuration des articles est gérée via le tableau partagé des articles de QBCore, où vous définissez le poids, l'utilisabilité et les champs de métadonnées de chaque article. Le système d'inventaire lit ces données et les applique automatiquement. Voulez-vous que les armes aient une durabilité ? Activez-la dans la configuration et ajoutez le suivi de la durabilité aux articles d'armes. Avez-vous besoin que les aliments aient des notes de qualité ? Ajoutez les métadonnées de qualité aux articles consommables. Le système est suffisamment flexible pour supporter les propriétés d'articles dont votre serveur a besoin.

La personnalisation visuelle est simple – l'interface HTML/CSS peut être restylée pour correspondre au thème de votre serveur. Les images des articles sont de simples fichiers PNG que vous pouvez remplacer ou ajouter selon vos besoins. La mise en page, les couleurs, les polices et les animations sont toutes personnalisables si vous souhaitez que l'inventaire ait une apparence unique pour la marque de votre serveur.

Ce qui le distingue

Ce n'est pas juste un autre script d'inventaire – il est devenu la norme communautaire pour les serveurs QBCore car il gère correctement la complexité. Les bugs de duplication d'articles sont empêchés grâce à la validation côté serveur. Les calculs de poids fonctionnent correctement avec les fractions. Les conteneurs se synchronisent correctement dans les scénarios multijoueurs. Le UI est réactif et ne ralentit pas lors de la gestion de grands inventaires. Ces détails sont importants lorsque vous gérez un serveur peuplé où les bugs d'inventaire peuvent détruire votre économie.

Le développeur a clairement utilisé ce système sur des serveurs de production, car il gère des cas limites que d'autres systèmes d'inventaire manquent. Que se passe-t-il lorsque deux joueurs essaient de prendre le dernier objet d'un stock simultanément ? Que se passe-t-il si quelqu'un se déconnecte en train de faire glisser un objet ? Que se passe-t-il si des véhicules disparaissent pendant que des objets sont dans le coffre ? Tous ces scénarios sont gérés avec grâce sans perte ou duplication d'objets. C'est le polish qui sépare un script fonctionnel d'un système de production fiable.

Détails techniques

• Performance du client : UI léger avec un rendu optimisé, impact minimal sur les FPS lorsqu'il est ouvert
• Performances du serveur : Requêtes de base de données efficaces, données d'inventaire en cache réduisent la surcharge de recherche
• Base de données: Utilise des tables MySQL pour le stockage persistant, correctement indexées pour les performances
• Optimisation du réseau : Ne synchronise que les emplacements modifiés, pas l'inventaire entier à chaque mise à jour
• Images d'Objets: Prise en charge du format PNG, recommandé 150x150px pour un affichage optimal
• Multijoueur Safe: Toutes les actions validées côté serveur, empêche les exploits de manipulation client

Intégration avec d'autres systèmes

Le système d'inventaire exporte des fonctions que d'autres ressources peuvent appeler – AddItem, RemoveItem, GetInventory, CanCarryItem, et plus. Cela signifie que vos scripts de travail, systèmes de craft et magasins peuvent tous interagir avec l'inventaire du joueur de manière programmatique. Un travail de mécanicien peut vérifier si le joueur a des pièces de réparation avant de permettre une réparation. Un script de drogue peut vérifier l'espace dans l'inventaire avant d'ajouter un produit. Tout est connecté via des exports standardisés.

Pour les développeurs construisant des scripts personnalisés, l'inventaire fournit des événements et des rappels. Déclenchez un événement lorsque des objets sont utilisés, retirés ou abandonnés. Accrochez-vous à l'ouverture de l'inventaire pour ajouter une validation personnalisée. Écoutez les changements de métadonnées des objets pour mettre à jour les systèmes externes. Le framework est extensible sans avoir besoin de modifier les fichiers principaux, gardant votre configuration compatible avec les mises à jour lorsque de nouvelles versions sont publiées.

L'inventaire des véhicules s'intègre avec la plupart des systèmes de clés/propriété des véhicules. Seuls les joueurs autorisés peuvent accéder au coffre d'un véhicule, empêchant les joueurs aléatoires de piller votre voiture. Les cachettes de propriété sont liées aux systèmes de logement/territoire de gang, de sorte que seuls les membres du gang peuvent accéder à la cachette du gang. Les inventaires des magasins peuvent être réapprovisionnés par des joueurs autorisés, créant des opportunités commerciales gérées par les joueurs. Le système de permissions est suffisamment flexible pour supporter tout scénario de contrôle d'accès dont votre serveur a besoin.

Assistance et mises à jour

En tant que l'une des ressources QBCore les plus largement utilisées, le système d'inventaire bénéficie des tests et des retours de la communauté. Les bugs sont identifiés et corrigés rapidement car des milliers de serveurs exécutent ce code. Les mises à jour maintiennent la compatibilité avec les changements du framework QBCore, donc vous ne vous retrouverez pas bloqué sur des anciennes versions parce que l'inventaire a été cassé. La base de code est également bien documentée, ce qui facilite le dépannage des problèmes ou l'ajout de fonctionnalités personnalisées spécifiques à votre serveur.

Aperçus vidéo