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.
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
- Inventoriez chaque ressource. Enregistrez sa version, ses tables de base de données, ses appels de framework et son statut de support.
- Sauvegardez les fichiers et la base de données. Prouvez que la sauvegarde se restaure avant de modifier la production.
- 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.
- 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.
- Configurez et convertissez la base de données d'inventaire. Suivez la documentation exacte de l'inventaire et travaillez sur une copie.
- 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.
- 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.
- 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