Mettre en place un système d’inventaire custom sans ESX ni QBCore

Créer un inventaire custom FiveM en 2025 est devenu une étape essentielle pour tout serveur roleplay souhaitant offrir une expérience immersive et unique à ses joueurs. Avec l’évolution constante des frameworks ESX et QBCore, personnaliser son système d’inventaire permet non seulement de se démarquer, mais aussi d’optimiser la jouabilité et l’ergonomie. Ce guide complet vous accompagne pas à pas dans la création, l’installation et la personnalisation d’un inventaire custom parfaitement adapté à votre serveur FiveM.

Pourquoi créer un inventaire custom FiveM pour votre serveur ?

La personnalisation d’un inventaire custom FiveM représente bien plus qu’un simple ajout cosmétique. C’est un élément central de l’expérience utilisateur qui influence directement la rétention des joueurs et l’immersion roleplay. Un inventaire bien conçu facilite la gestion des objets, améliore la fluidité des interactions et renforce l’identité visuelle de votre serveur.

Les avantages d’un inventaire personnalisé

Un système d’inventaire sur mesure apporte de nombreux bénéfices concrets à votre communauté. Premièrement, il permet d’adapter le nombre de slots disponibles selon les besoins spécifiques de votre économie roleplay. Deuxièmement, la personnalisation visuelle renforce l’identité graphique de votre serveur et améliore l’immersion. Troisièmement, vous bénéficiez d’une compatibilité totale avec vos scripts custom et pouvez intégrer des fonctionnalités uniques comme le drag & drop, le système de poids, les catégories d’objets personnalisées ou encore les animations spécifiques.

Les performances constituent également un critère majeur : un inventaire optimisé réduit les temps de chargement et minimise les bugs liés aux interactions entre joueurs. Pour héberger efficacement ces systèmes gourmands en ressources, il est recommandé d’opter pour un hébergement FiveM performant et fiable capable de supporter ces modifications avancées.

Framework compatible : ESX vs QBCore

Les deux frameworks dominants du marché FiveM proposent des architectures différentes pour gérer les inventaires. ESX utilise traditionnellement une structure SQL simple avec des items stockés en JSON dans la base de données. Ce système offre une grande flexibilité mais peut présenter des limitations en termes de performances sur les gros serveurs. QBCore, quant à lui, propose une gestion native plus moderne avec un système d’inventaire partagé optimisé dès l’origine, facilitant l’ajout de métadonnées aux objets et la synchronisation entre joueurs.

Les prérequis techniques pour développer votre inventaire custom

Avant de vous lancer dans la création d’un inventaire custom FiveM, plusieurs compétences et outils sont indispensables pour garantir un résultat professionnel et fonctionnel. La maîtrise de ces éléments vous évitera de nombreux écueils et accélérera significativement votre processus de développement.

Compétences en programmation requises

Le développement d’un inventaire personnalisé nécessite une bonne maîtrise de Lua, le langage principal de scripting FiveM côté serveur et client. Vous devrez comprendre les concepts de triggers, events, callbacks et de communication client-serveur. Des connaissances en JavaScript, HTML5 et CSS3 sont également essentielles pour créer l’interface utilisateur (NUI) responsive et attractive. La manipulation de bases de données MySQL ou MariaDB est incontournable pour stocker et récupérer les items des joueurs de manière sécurisée.

Outils et ressources nécessaires

• Visual Studio Code ou tout éditeur de code avec support Lua
• HeidiSQL ou phpMyAdmin pour gérer votre base de données
• Un serveur de test local FiveM pour développer sans risque
• Bibliothèques JavaScript comme jQuery ou Vue.js pour l’interface
• Logiciels de design (Photoshop, Figma) pour créer les icônes d’items
• Accès aux documentations officielles de FiveM Docs

Structure de base d’une ressource FiveM

Chaque inventaire custom suit une architecture standardisée pour FiveM. Voici la structure typique d’un dossier de ressource :

inventory_custom/
├── fxmanifest.lua
├── config.lua
├── client/
│   ├── main.lua
│   └── functions.lua
├── server/
│   ├── main.lua
│   ├── callbacks.lua
│   └── items.lua
├── html/
│   ├── index.html
│   ├── style.css
│   ├── script.js
│   └── images/
└── locales/
    └── fr.lua

Le fichier fxmanifest.lua déclare tous les fichiers utilisés, les dépendances et les métadonnées de votre ressource. C’est le point d’entrée essentiel reconnu par le serveur FiveM.

Guide étape par étape : créer votre inventaire custom FiveM

Passons maintenant à la pratique avec un processus détaillé de création d’un inventaire custom FiveM fonctionnel et optimisé. Chaque étape a été conçue pour vous guider progressivement, du concept initial jusqu’à la mise en production sur votre serveur.

Étape 1 : Configuration du manifest et structure de base

Commencez par créer votre dossier de ressource dans le répertoire resources de votre serveur. Le fichier fxmanifest.lua constitue le squelette de votre script :

fx_version 'cerulean'
game 'gta5'

author 'Votre Nom'
description 'Inventaire Custom pour FiveM'
version '1.0.0'

shared_scripts {
    'config.lua'
}

client_scripts {
    'client/main.lua',
    'client/functions.lua'
}

server_scripts {
    '@mysql-async/lib/MySQL.lua',
    'server/main.lua',
    'server/items.lua'
}

ui_page 'html/index.html'

files {
    'html/index.html',
    'html/style.css',
    'html/script.js',
    'html/images/*.png'
}

Étape 2 : Création de la base de données

Votre inventaire nécessite une structure SQL adaptée pour stocker les items. Voici un exemple de table optimisée pour ESX :

CREATE TABLE IF NOT EXISTS `user_inventory` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `identifier` varchar(60) NOT NULL,
  `item` varchar(100) NOT NULL,
  `count` int(11) NOT NULL DEFAULT 0,
  `slot` int(11) NOT NULL,
  `metadata` longtext DEFAULT '{}',
  PRIMARY KEY (`id`),
  KEY `identifier` (`identifier`),
  KEY `item` (`item`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

Cette structure inclut un champ metadata permettant de stocker des informations supplémentaires en JSON (durabilité, propriétaire, personnalisation, etc.).

Étape 3 : Développement de l’interface utilisateur (NUI)

L’interface visuelle de votre inventaire custom FiveM se construit en HTML/CSS/JavaScript. Créez un fichier index.html moderne avec un design responsive :

<div class="inventory-container">
  <div class="inventory-header">
    <h2>Inventaire</h2>
    <span class="weight">25kg / 50kg</span>
  </div>
  <div class="inventory-grid">
    <!-- Slots générés dynamiquement -->
  </div>
</div>

Associez un fichier CSS pour styliser votre inventaire avec des effets modernes, des transitions fluides et un design cohérent avec votre serveur. Utilisez JavaScript pour gérer les interactions drag & drop, les clics droits pour utiliser les items et la communication avec le client Lua via SendNUIMessage.

Étape 4 : Programmation côté client (Lua)

Le script client gère l’ouverture/fermeture de l’inventaire et la communication avec l’interface. Dans client/main.lua :

local inventoryOpen = false

RegisterCommand('inventory', function()
    ToggleInventory()
end)

RegisterKeyMapping('inventory', 'Ouvrir inventaire', 'keyboard', 'F2')

function ToggleInventory()
    inventoryOpen = not inventoryOpen
    SetNuiFocus(inventoryOpen, inventoryOpen)
    
    if inventoryOpen then
        ESX.TriggerServerCallback('inventory:getItems', function(items)
            SendNUIMessage({
                action = 'openInventory',
                items = items
            })
        end)
    else
        SendNUIMessage({action = 'closeInventory'})
    end
end

RegisterNUICallback('useItem', function(data, cb)
    TriggerServerEvent('inventory:useItem', data.item, data.slot)
    cb('ok')
end)

Étape 5 : Programmation côté serveur (Lua)

Le serveur gère la logique métier, les vérifications de sécurité et les interactions avec la base de données. Dans server/main.lua :

ESX.RegisterServerCallback('inventory:getItems', function(source, cb)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    MySQL.Async.fetchAll('SELECT * FROM user_inventory WHERE identifier = @identifier', {
        ['@identifier'] = xPlayer.identifier
    }, function(result)
        cb(result)
    end)
end)

RegisterServerEvent('inventory:useItem')
AddEventHandler('inventory:useItem', function(item, slot)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    -- Vérifications de sécurité
    if not item or not slot then return end
    
    -- Logique d'utilisation de l'item
    xPlayer.removeInventoryItem(item, 1)
    
    -- Effets selon le type d'item
    if item == 'bread' then
        TriggerClientEvent('esx_status:add', source, 'hunger', 200000)
    end
end)

Étape 6 : Configuration et personnalisation

Créez un fichier config.lua partagé entre client et serveur pour centraliser tous vos paramètres :

Config = {}

Config.MaxSlots = 40
Config.MaxWeight = 50000 -- en grammes
Config.EnableHotbar = true
Config.HotbarSlots = 5

Config.Items = {
    ['bread'] = {
        label = 'Pain',
        weight = 200,
        usable = true,
        rare = false,
        canRemove = true
    },
    ['water'] = {
        label = 'Bouteille d\'eau',
        weight = 500,
        usable = true,
        rare = false,
        canRemove = true
    }
    -- Ajoutez tous vos items ici
}

Optimisations et bonnes pratiques

Pour garantir des performances optimales, implémentez ces recommandations techniques :

• Utilisez des debounce sur les interactions répétées pour éviter le spam
• Limitez les requêtes SQL avec un système de cache côté serveur
• Validez toutes les entrées utilisateur côté serveur pour éviter les exploits
• Compressez les images d’icônes (format WebP recommandé, max 50kb par icône)
• Utilisez des net events plutôt que des commands pour les actions sensibles
• Implémentez un système de logs pour tracer les transactions d’items

Intégration avancée et fonctionnalités supplémentaires

Un inventaire custom FiveM moderne ne se limite pas aux fonctions basiques. Les joueurs attendent désormais des fonctionnalités avancées qui enrichissent l’expérience roleplay et simplifient les interactions quotidiennes sur votre serveur.

Système de métadonnées pour items uniques

Les métadonnées permettent de rendre chaque item unique avec des propriétés spécifiques. Par exemple, une arme peut stocker son numéro de série, sa durabilité, ses modifications et son propriétaire légitime. Implémentez ce système en étendant la structure de vos items :

-- Exemple d'ajout d'item avec métadonnées
xPlayer.addInventoryItem('weapon_pistol', 1, {
    serial = GenerateSerial(),
    durability = 100,
    ammo = 12,
    attachments = {'suppressor', 'flashlight'},
    owner = xPlayer.getName()
})

Partage d’inventaire et coffres partagés

Créez des systèmes de coffres, de véhicules et de propriétés avec inventaires partagés. Cette fonctionnalité nécessite une synchronisation temps réel entre plusieurs joueurs accédant simultanément au même stockage. Utilisez des mutex locks pour éviter les conflits de données et des événements réseau pour mettre à jour instantanément tous les clients connectés.

Système de craft et combinaisons d’items

Intégrez un menu de craft permettant aux joueurs de combiner des ressources pour créer de nouveaux objets. Définissez des recettes dans votre configuration :

Config.Recipes = {
    ['bandage'] = {
        label = 'Bandage',
        ingredients = {
            {item = 'cloth', count = 2},
            {item = 'alcohol', count = 1}
        },
        time = 5000, -- en ms
        result = {item = 'bandage', count = 1}
    }
}

Compatibilité multi-framework

Pour maximiser la portabilité de votre inventaire custom, créez une couche d’abstraction compatible ESX, QBCore et même standalone. Utilisez des fonctions wrapper qui s’adaptent automatiquement au framework détecté au démarrage de la ressource.

Raccourcis clavier et hotbar

Implémentez un système de raccourcis clavier (touches 1-5) permettant d’utiliser rapidement les items placés dans des slots dédiés. Cette fonctionnalité améliore considérablement l’expérience utilisateur lors de situations dynamiques comme les combats ou les courses-poursuites.

Animations et effets visuels

Enrichissez l’immersion en déclenchant des animations spécifiques lors de l’utilisation de certains items. Par exemple, déclenchez l’animation de manger lorsqu’un joueur consomme de la nourriture, ou celle de boire pour les boissons. Utilisez les natives FiveM TaskPlayAnim combinées à des progressbars pour un rendu professionnel.

Tests, débogage et mise en production

La phase de tests est cruciale pour garantir la stabilité et la sécurité de votre inventaire custom FiveM. Une ressource mal testée peut engendrer des duplications d’items, des pertes de données ou des exploits compromettant l’économie de votre serveur.

Procédure de tests complète

Testez systématiquement ces scénarios avant la mise en production :

Outils de débogage essentiels

Utilisez ces techniques pour identifier rapidement les problèmes :

• Activez le mode développeur de FiveM avec developer_mode 1 dans server.cfg
• Implémentez des logs détaillés avec timestamps dans un fichier dédié
• Utilisez la console F8 côté client pour tracer les événements NUI
• Installez oxmysql avec mode debug pour voir toutes les requêtes SQL
• Créez des commandes admin pour manipuler l’inventaire en test

Sécurité et prévention des exploits

La sécurité est primordiale pour éviter que des joueurs malveillants n’exploitent votre système. Implémentez ces protections :

• Validation serveur : ne jamais faire confiance aux données du client
• Rate limiting : limiter le nombre d’actions par seconde
• Chiffrement : encoder les communications NUI sensibles
• Logs complets : tracer toutes les transactions pour enquêter en cas d’abus
• Whitelist d’items : rejeter tout item non défini dans la configuration
• Vérification des distances : bloquer les interactions à distance excessive

Mise en production progressive

Ne déployez jamais directement sur votre serveur principal. Suivez cette méthodologie :

1. Tests approfondis sur serveur de développement local
2. Phase de beta test avec un groupe restreint de joueurs de confiance
3. Déploiement sur serveur de préproduction (clone de production)
4. Migration progressive : quelques joueurs puis élargissement
5. Monitoring intensif des performances pendant 48h
6. Sauvegarde complète de la base avant et après migration

Un hébergement stable et performant est indispensable pour supporter ces opérations complexes sans interruption de service. Les solutions proposées sur locationfivem.fr offrent l’infrastructure nécessaire pour héberger sereinement votre inventaire custom avec des performances optimales.

Maintenance et évolution de votre inventaire custom

Une fois votre inventaire custom FiveM déployé, le travail ne s’arrête pas. La maintenance régulière et l’évolution continue de votre système garantissent sa pérennité et l’adaptation aux besoins changeants de votre communauté.

Collecte de retours utilisateurs

Mettez en place des canaux de feedback structurés : formulaires ingame, sondages Discord, sessions de suggestions. Analysez les demandes récurrentes et priorisez les améliorations selon leur impact sur l’expérience joueur. Les statistiques d’utilisation (items les plus échangés, fonctionnalités les plus sollicitées) vous guident dans vos décisions d’évolution.

Optimisation continue des performances

Surveillez régulièrement les métriques de votre serveur : temps de réponse des requêtes SQL, charge CPU/RAM générée par l’inventaire, latence réseau. Identifiez les requêtes lentes avec des outils de profiling et optimisez-les. Implémentez progressivement des systèmes de cache plus sophistiqués et envisagez des architectures distribuées pour les très gros serveurs.

Compatibilité avec les mises à jour FiveM

FiveM évolue constamment avec de nouvelles fonctionnalités et corrections. Testez systématiquement votre inventaire après chaque mise à jour majeure de FiveM ou de vos frameworks. Abonnez-vous aux changelogs officiels et aux forums de développeurs pour anticiper les breaking changes potentiels.

Documentation et formation

Maintenez une documentation technique complète de votre inventaire : architecture, API disponibles, procédures d’ajout d’items, guide de troubleshooting. Formez votre équipe d’administration aux commandes spécifiques et aux procédures d’intervention en cas de problème. Une documentation claire facilite considérablement la transmission de connaissances et la résolution rapide des incidents.

Créer et maintenir un inventaire custom FiveM représente un investissement significatif en temps et en compétences, mais les bénéfices pour votre serveur sont considérables. Un système d’inventaire bien conçu devient rapidement un atout majeur qui fidélise votre communauté et distingue votre serveur de la concurrence. Avec les bonnes pratiques présentées dans ce guide, les outils appropriés et un hébergement fiable, vous disposez de toutes les clés pour développer un inventaire performant, sécurisé et évolutif qui accompagnera la croissance de votre projet FiveM sur le long terme.

FAQ