Aller au contenu

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.

Publié le 3 min de lecturePar Jupiter

Installation du framework QBox sur un serveur FiveM hébergé chez TalCloud

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 :

  1. les dépendances (oxmysql, ox_lib) ;
  2. les ressources cœur de QBox ;
  3. l’inventaire (ox_inventory) et les modules ;
  4. 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