Qbox vs QBCore : Différences, compatibilité et migration

Choisissez Qbox pour un nouveau serveur lorsque vous voulez son stack moderne, intégré à OX et que vous êtes prêt à suivre ses conventions. Gardez QBCore lorsque votre serveur stable dépend des ressources spécifiques à QBCore et qu'une migration n'a pas d'avantage clair. Qbox fournit un pont de compatibilité pour la plupart des scripts QBCore correctement écrits, mais la compatibilité n'est pas universelle.

Vous installez votre premier serveur ? Suivez notre guide étape par étape pour créer un serveur FiveM.

Qbox vs QBCore en un coup d'œil

Question	Qbox	QBCore
Origine	A commencé comme un fork de QBCore et suit maintenant sa propre architecture	Cadre et écosystème de jeu de rôle FiveM établis
Scripts QB existants	La plupart des scripts documentés et correctement écrits fonctionnent via le pont	Cible native pour les ressources QBCore
Intégration OX	Conçu autour d'intégrations telles que ox_lib et ox_inventory	Dépend de l'ensemble logiciel choisi pour le serveur et des portages de ressources
Accès au noyau	Utilise des exports et des modules importés ; aucun objet central Qbox natif	De nombreuses ressources utilisent l'objet central QBCore familier
Risque de migration	Nécessite l'audit de l'accès à la base de données, de l'accès aux fichiers principaux et des ressources personnalisées	Aucune migration de framework si le serveur est déjà stable

Qu'est-ce que Qbox ?

Qbox est un framework de jeu de rôle FiveM créé en 2022. Il a commencé comme un fork de QBCore, maintient une rétrocompatibilité pour presque tous les scripts QBCore correctement implémentés, et utilise de plus en plus ses propres exports, modules et intégrations basées sur OX. La propre documentation de Qbox recommande les ressources publiées et met en garde contre l'accès non pris en charge aux tables ou fichiers de base de données appartenant au cœur.

Qu'est-ce que QBCore ?

QBCore est un framework de rôle mature avec un large catalogue de métiers, d'inventaires, d'outils d'administration et de scripts personnalisés. Son principal avantage pour un serveur existant est la prévisibilité : si vos ressources sont testées contre votre version actuelle de QBCore, rester évite le coût et le risque d'une migration de framework.

Les scripts QBCore fonctionneront-ils sur Qbox ?

La plupart le feront, mais pas tous. Qbox fournit un pont QB pour les ressources qui utilisent correctement les exports et événements QBCore documentés. Les scripts sont plus susceptibles d'échouer lorsqu'ils :

• lisent ou modifient directement les tables de base de données appartenant à QBCore ;
• ouvrent ou corrigent les fichiers internes du cœur ;
• dépendent de fonctions non documentées ou d'une utilisation invalide des événements ;
• remplacent les données multijob ou multigang intégrées par des tables incompatibles ;
• supposent qu'un objet principal Qbox existe au lieu d'utiliser les exports et modules pris en charge.

Quand Qbox est le meilleur choix

• Vous construisez un nouveau serveur et souhaitez une fondation orientée Qbox/OX.
• Vos scripts critiques utilisent des API documentées ou déclarent déjà une prise en charge de Qbox.
• Vous voulez faire évoluer votre code personnalisé vers l'utilisation des exports et des modules plutôt que modifier le cœur du framework.
• Vous pouvez tester la migration de la base de données et des personnages sur une copie complète de staging.

Quand QBCore est le meilleur choix

• Votre serveur en direct est stable et la migration ne résoudrait pas un problème mesuré.
• Une ressource critique dépend directement des composants internes de QBCore.
• Vous n'avez pas de sauvegarde complète de la base de données et d'environnement de préproduction.
• Votre équipe maintient déjà un déploiement et un processus de mise à jour QBCore testés.

Migration sûre de QBCore à Qbox

1. Inventoriez chaque ressource. Enregistrez sa version, ses tables de base de données, ses appels de framework et son statut de support.
2. Sauvegardez les fichiers et la base de données. Prouvez que la sauvegarde se restaure avant de modifier la production.
3. Installez Qbox avec la recette recommandée. Commencez à partir des fichiers de configuration actuels plutôt que de mélanger les anciens fichiers du cœur dans la nouvelle pile.
4. Examinez les métiers et les gangs. Qbox utilise des grades numériques pour les métiers et les gangs, et sa documentation de migration souligne les modifications requises des fichiers partagés et de la collation.
5. Configurez et convertissez la base de données d'inventaire. Suivez la documentation exacte de l'inventaire et travaillez sur une copie.
6. Testez les scripts par catégorie. Commencez par l'identité, les personnages, les métiers, l'argent et l'inventaire, puis les véhicules, le logement, les téléphones et les outils d'administration.
7. Remplacez progressivement les éléments internes non pris en charge. Qbox prend en charge la conversion partielle des appels QBCore vers les exports et modules Qbox.
8. Basculez uniquement après la réussite des tests de parité. Conservez un plan de retour en arrière assorti de délais et la sauvegarde intacte réalisée avant la migration.

Décision

Pour un nouveau projet, Qbox est un bon choix par défaut si l'équipe souhaite son architecture et ses ressources compatibles. Pour un serveur QBCore rentable ou fortement personnalisé, ne migrez pas pour suivre la mode : ne le faites que lorsqu'un audit en préproduction démontre que les avantages dépassent les risques pour la compatibilité et les données.

Références officielles

• Introduction Qbox
• FAQ de compatibilité Qbox
• Guide officiel de conversion de QBCore à Qbox
• Dépôt central QBCore

La mention QBCore garantit-elle la compatibilité Qbox ?

Non. Qbox documente un pont de compatibilité, mais les scripts qui accèdent aux éléments internes du framework peuvent nécessiter des modifications. Vérifiez la version exacte, les accès à la base, l’inventaire et la voix avant l’achat. La catégorie QBCore seule ne constitue pas un test de compatibilité Qbox.

Documentation de compatibilité Qbox

Voir les exigences du pack FiveM Baby Script

Comment migrer un serveur ESX vers QBCore