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 | QB-Core |
|---|---|---|
| Origine | A commencé comme une fourche 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, correctement écrits, fonctionnent à travers 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 du stack de serveur choisi et des ports de ressources |
| Accès au noyau | Utilise des exports et des modules importés ; aucun objet central Qbox natif | De nombreuses ressources utilisent le cœur d'objet 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 cadre de jeu de rôle FiveM créé en 2022. Il a commencé comme une bifurcation de QBCore, maintient la compatibilité ascendante 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 documentation propre de Qbox recommande les ressources publiées et met en garde contre l'accès non supporté aux tables de base de données ou aux fichiers 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 ont plus de chances d'échouer lorsqu'ils :
- lire ou modifier directement les tables de base de données appartenant à QBCore ;
- ouvrez ou corrigez les fichiers internes du cœur ;
- dépendent de fonctions non documentées ou d'une utilisation incorrecte des événements ;
- remplacer les données multijob ou multigang intégrées par des tables incompatibles;
- supposez qu'un objet principal Qbox existe au lieu d'utiliser les exports et modules pris en charge.
Qbox décrit sa compatibilité comme 99% pour les scripts QB existants, mais cela ne remplace pas le test de vos ressources personnalisées et payées exactes.
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 déplacer le code personnalisé vers les exports et les modules plutôt que vers les modifications du cœur.
- Vous pouvez tester la migration de la base de données et des personnages sur une copie complète de staging.
Explorer Scripts Qbox et notre aperçu de la Stack OX Qbox.
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 internes 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.
Parcourir Scripts QBCore et le Guide central QBCore.
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 emplois et les gangs. Qbox utilise des grades numériques pour les emplois 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 emplois, 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.
- Passer en production uniquement après les tests de parité. Conservez un plan de rétroaction temporisé et une sauvegarde pré-migration intacte.
Décision
Pour un nouveau projet, Qbox est un bon choix par défaut lorsque l'équipe veut son architecture et son ensemble de ressources compatibles. Pour un serveur QBCore rentable ou fortement personnalisé, ne migrez pas par mode : déplacez-vous uniquement lorsque l'audit prouve que le bénéfice dépasse le risque de compatibilité et de données.
