Tutoriel
Migrer son serveur FiveM de QBCore vers QBox
QBox reprend le meilleur de QBCore avec de meilleures performances. Mais migrer un serveur RP vivant ne s'improvise pas. Voici une méthode prudente pour passer le cap sans perdre vos joueurs ni vos données.

Pourquoi migrer vers QBox ?
Si vous tenez un serveur QBCore, vous avez sans doute remarqué que le projet a ralenti. QBox, son fork, concentre désormais l’essentiel du développement. Les raisons de migrer sont concrètes :
- De meilleures performances (Lua 5.4, architecture allégée), utiles dès que le nombre de joueurs monte.
- L’écosystème ox natif (ox_inventory, ox_target, ox_lib), sans bricolage.
- Une compatibilité forte avec vos ressources QBCore existantes.
Si vous hésitez encore sur le principe, notre comparatif QBox, QBCore ou ESX remet les trois frameworks en perspective. Cet article suppose que le choix de QBox est fait et se concentre sur la migration.
Règle d'or : on ne migre jamais directement sur le serveur en production. Toute la migration se prépare et se teste sur un serveur de copie, à part.
Étape 1 - Sauvegarder et cloner
Avant tout, faites une sauvegarde complète : le dossier du serveur (ressources, server.cfg) et la base de données MySQL. C’est votre filet de sécurité.
Montez ensuite un second serveur de test, copie du premier. C’est là que vous ferez tout le travail. Vos joueurs continuent de jouer sur la production pendant ce temps. Notre guide configurer MySQL sur FiveM vous aide à dupliquer proprement la base.
Étape 2 - Installer QBox sur le serveur de test
Installez QBox et son écosystème ox sur la copie. QBox étant le successeur de QBCore, sa structure vous sera familière. Importez le schéma de base de données QBox, puis vos données existantes.
L’objectif de cette étape : un serveur QBox vierge qui démarre, avant même d’ajouter vos scripts.
Étape 3 - Vérifier la compatibilité des scripts
C’est le cœur de la migration. Reprenez vos ressources une par une :
- La plupart des scripts QBCore fonctionnent tels quels sur QBox.
- Certains demandent une petite adaptation (souvent liée à l’inventaire ou aux exports).
- Quelques scripts très anciens ou lourdement modifiés devront être remplacés par leur équivalent moderne.
Ajoutez-les progressivement, en testant après chaque ajout. Un serveur qui refuse de démarrer après l’ajout d’une ressource vous dit exactement laquelle pose problème. Notre article ajouter des scripts et ressources FiveM rappelle la bonne méthode.
Étape 4 - Tester comme un joueur
Une fois tous les scripts en place, jouez réellement : création de personnage, argent, jobs, inventaire, véhicules, sauvegarde à la déconnexion. Vérifiez la console : aucune erreur ne doit défiler en boucle. Surveillez aussi le resmon pour repérer une ressource trop gourmande.
Étape 5 - Basculer en production
Quand la copie est stable, planifiez la bascule à une heure creuse :
- Prévenez votre communauté à l’avance.
- Mettez la production en maintenance.
- Faites une dernière sauvegarde.
- Basculez sur la configuration QBox validée.
- Gardez l’ancienne version prête à être restaurée, au cas où.
Bon à savoir : ne supprimez jamais votre ancienne installation QBCore le jour de la bascule. Conservez-la quelques jours : c'est votre plan de retour si un souci apparaît en conditions réelles.
En résumé
Migrer de QBCore vers QBox se justifie par de meilleures performances et un écosystème ox natif, tout en gardant une forte compatibilité. La clé, c’est la prudence : sauvegarde complète, travail sur un serveur de test, vérification des scripts un par un, tests en conditions réelles, puis bascule planifiée avec un plan de retour. Fait méthodiquement, le passage à QBox se fait sans casse - et votre serveur y gagne en fluidité.
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.