Aller au contenu

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.

Publié le 3 min de lecturePar Jupiter

Migration d'un serveur FiveM de QBCore vers QBox, hébergé chez TalCloud

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 :

  1. Prévenez votre communauté à l’avance.
  2. Mettez la production en maintenance.
  3. Faites une dernière sauvegarde.
  4. Basculez sur la configuration QBox validée.
  5. 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