Comment installer un inventaire FiveM (pas à pas)

L’inventaire est l’un des premiers systèmes payants que la plupart des propriétaires installent — et l’une des sources les plus fréquentes d’erreurs « ça ne démarre pas ». Ce tutoriel décrit une installation propre qui fonctionne du premier coup, que vous soyez sous ESX, QBCore ou Qbox.

Étape 1 — Vérifier les prérequis

Chaque inventaire liste ses dépendances. Les quasi-universelles aujourd’hui :

• oxmysql — la couche base de données.
• ox_lib — bibliothèque UI/utilitaires partagée qu’utilisent la plupart des ressources modernes.
• Votre framework (es_extended, qb-core, ou qbx_core).

Installez-les et vérifiez qu’elles démarrent proprement avant d’ajouter l’inventaire. Vous pouvez constater à quel point elles sont répandues sur notre page de métriques des ressources : oxmysql et ox_lib trônent tout en haut de l’écosystème.

Étape 2 — Ajouter les fichiers de la ressource

1. Déposez le dossier de l’inventaire dans votre répertoire resources/ (gardez exactement le nom de dossier livré par le développeur).
2. S’il est arrivé dans un dossier entre crochets [inventory], conservez cette structure — les crochets regroupent les ressources et peuvent influencer l’ordre de chargement.

Étape 3 — Importer la base de données

La plupart des inventaires livrent un fichier .sql qui ajoute des tables d’objets, des coffres ou des colonnes de métadonnées.

1. Sauvegardez d’abord votre base. Non négociable.
2. Importez le .sql fourni via HeidiSQL, phpMyAdmin ou la ligne de commande.
3. Si le script utilise une table d’objets, assurez-vous que vos objets sont bien initialisés (beaucoup d’inventaires payants incluent une liste de départ).

Étape 4 — Définir l’ordre de chargement dans server.cfg

L’ordre, c’est là que la plupart des installations cassent. Les dépendances doivent démarrer avant l’inventaire :

# Le cœur d'abord
ensure oxmysql
ensure ox_lib
ensure es_extended      # ou qb-core / qbx_core

# Puis l'inventaire
ensure mon-inventaire

Si l’inventaire remplace celui par défaut de votre framework, désactivez l’ancien (commentez sa ligne ensure) pour qu’ils ne se disputent pas les mêmes événements.

Étape 5 — Le configurer

Ouvrez le config.lua de la ressource (ou le dossier config/) et réglez l’essentiel :

• Framework — certains produits détectent automatiquement ; d’autres exigent une ligne Config.Framework = 'esx'.
• Slots / poids — choisissez un système et tenez-vous-y sur tout le serveur.
• Touche pour ouvrir l’inventaire.
• Coffres, boutiques, coffres de voiture — activez ce que vous utilisez vraiment ; désactivez le reste pour économiser des performances.

Étape 6 — Tester avant d’annoncer

Démarrez le serveur et surveillez la console txAdmin au premier chargement. Puis, en jeu, vérifiez la boucle principale :

• Ouvrir/fermer l’inventaire.
• Ramasser et poser un objet.
• Déplacer des objets entre la barre rapide et le sac.
• Ouvrir un coffre / un coffre de voiture / une boutique.
• Se reconnecter et confirmer que les objets persistent (la base enregistre bien).

Quel inventaire installer ?

Si vous voulez une base gratuite et fiable, ox_inventory est la référence de la communauté. Si l’inventaire est central dans l’identité de votre serveur — craft, progression, stockage poussé et interface soignée — un système payant en vaut la peine. Dans nos tests, le polyvalent qui se détache est Quasar Inventory, qui gère ESX, QB, QBCore et Qbox depuis un seul produit et est conçu pour garder un coût par frame faible même dans une ville pleine. Vous pouvez le voir sur la page inventaire de Quasar Store, et nous le comparons au reste du marché dans notre guide des meilleurs inventaires FiveM.

Erreurs d’installation courantes (et solutions)

Une fois votre inventaire stable, associez-le à un HUD propre — voyez notre guide de personnalisation du HUD — et vérifiez que l’ensemble reste rapide avec notre guide d’optimisation.