Tutoriel
Installer QBox sur FiveM : le guide de démarrage 2026
QBox s'installe presque comme QBCore, avec l'écosystème ox intégré. Voici la marche à suivre, étape par étape, pour poser une base propre sur laquelle construire votre serveur RP.

Avant de commencer : les prérequis
QBox est le successeur moderne de QBCore. Si vous avez déjà installé un serveur FiveM, l’essentiel vous sera familier. Il vous faut :
- un serveur FiveM fonctionnel avec des artifacts récents ;
- txAdmin pour piloter le serveur ;
- une base de données MySQL accessible ;
- l’écosystème ox (ox_lib, oxmysql, ox_inventory), au cœur de QBox.
Si votre serveur n’est pas encore monté, commencez par nos guides créer un serveur FiveM RP et installer txAdmin. Pour la base, voyez configurer MySQL sur FiveM.
Bon à savoir : QBox s'appuie nativement sur ox. Inutile de bricoler l'installation de l'inventaire ou de la bibliothèque : tout est prévu pour fonctionner ensemble.
Étape 1 - Récupérer QBox et oxmysql
Téléchargez la dernière version stable de QBox et placez ses ressources dans votre dossier resources. Ajoutez oxmysql et ox_lib, indispensables au fonctionnement. Respectez l’ordre de démarrage : les dépendances ox doivent se lancer avant les ressources qui les utilisent.
Étape 2 - Préparer la base de données
Importez le schéma SQL fourni par QBox dans votre base. Il crée les tables nécessaires aux joueurs, aux personnages et à l’inventaire. Vérifiez ensuite que la chaîne de connexion mysql_connection_string de votre server.cfg pointe bien vers cette base - une erreur ici, et le serveur démarre mais rien ne se sauvegarde.
Étape 3 - Configurer le server.cfg
Dans server.cfg, déclarez les ressources dans le bon ordre :
- les dépendances (oxmysql, ox_lib) ;
- les ressources cœur de QBox ;
- l’inventaire (ox_inventory) et les modules ;
- vos scripts additionnels ensuite seulement.
Renseignez aussi votre clé de licence cfx.re, vos endpoints et le nom du serveur. Démarrez enfin le serveur vide de scripts tiers : l’objectif de cette étape est un QBox propre qui se lance sans erreur en console.
Étape 4 - Tester le socle
Connectez-vous et vérifiez les fondamentaux : création de personnage, apparition dans le monde, portefeuille, ouverture de l’inventaire ox. Surveillez la console : elle doit être calme. Une erreur qui défile en boucle signale presque toujours une dépendance mal ordonnée ou une base mal connectée.
Astuce : ajoutez vos scripts un par un, en testant après chaque ajout. Un serveur qui casse juste après un ajout vous désigne le coupable immédiatement. Voir ajouter des scripts et ressources FiveM.
Étape 5 - Surveiller les performances
Une fois vos scripts en place, tapez resmon en jeu pour afficher le temps CPU de chaque ressource. Tout ce qui dépasse durablement 1 ms mérite votre attention. QBox est déjà plus léger que QBCore, mais un script mal optimisé peut ruiner ce gain. Pour aller plus loin, notre guide réduire le lag sur FiveM détaille les réflexes utiles.
La fluidité finale dépendra aussi du matériel : un CPU à haute fréquence et un stockage NVMe font la différence sur un serveur chargé. C’est ce que propose notre hébergement FiveM.
En résumé
Installer QBox suit une logique claire : prérequis (artifacts, txAdmin, MySQL), ajout de QBox et de l’écosystème ox, import du schéma SQL, configuration ordonnée du server.cfg, puis tests sur un socle vide avant d’ajouter vos scripts un par un. En respectant l’ordre des dépendances et en surveillant le resmon, vous posez une base RP moderne, propre et performante - prête à accueillir votre univers.
Articles liés
Tutoriel
Créer un serveur DayZ moddé : mods Workshop, clés et ordre de chargement
Créer un serveur DayZ moddé : compte Steam, mods du Workshop, ordre de chargement, clés .bikey, types.xml et erreurs fréquentes, étape par étape.
Tutoriel
Créer un serveur Rust en 2026 : Oxide, Carbon, wipes et RAM
Créer un serveur Rust en 2026 : installation, server.cfg, Oxide ou Carbon, plugins, wipes mensuels et RAM à prévoir : le guide pas à pas et les pièges courants.
Tutoriel
Slash commands Discord : le guide pour bien démarrer
Guide des slash commands Discord : fonctionnement, enregistrement global ou par serveur, permissions, pièges courants et hébergement du bot.