Guide du framework QBCore : Architecture, Installation et Compatibilité

QBCore est un framework de jeu de rôle open-source pour FiveM. Son qb-core ressource expose les données partagées des joueurs, les fonctions du cadre, les commandes et les définitions que d'autres ressources QB peuvent utiliser. Pour un nouveau serveur, utilisez la recette officielle QBCore txAdmin plutôt que de traiter le qb-core dossier comme une installation complète.

Points clés

• qb-core est la ressource principale, pas un serveur de jeu de rôle complet en soi.
• Le guide officiel pour Windows déploie le modèle populaire QBCore Framework via txAdmin.
• La recette officielle inclut la configuration de la base de données et un ensemble plus large de ressources QB.
• La compatibilité dépend des versions exactes, des dépendances, des exports, de SQL et de l'ordre des ressources.
• Aucune source officielle n'établit QBCore comme un gagnant universel en termes de performance ; profilez la pile complète que vous prévoyez d'exécuter.

Ce que QBCore fournit

Le Core Object de QBCore est l’interface partagée utilisée par de nombreuses ressources QB. La documentation officielle regroupe ses capacités autour des fonctions, des données des joueurs, des données partagées, de la configuration et des commandes. Une ressource peut demander uniquement les parties du Core Object dont elle a besoin, mais les API requises doivent correspondre à la version du cœur installée sur le serveur.

Les définitions partagées incluent les métiers, les gangs, les objets et les véhicules représentés dans des tables Lua. Les fonctions principales couvrent les opérations courantes du framework, tandis que les objets des joueurs exposent les données structurées des personnages et les fonctions liées aux joueurs. Les commandes et les autorisations font partie du modèle de framework plus large. Ce sont des capacités architecturales, pas une preuve que chaque serveur ou ressource aura les mêmes performances ou comportements.

Installez QBCore avec la recette officielle

La procédure d’installation officielle actuelle pour Windows utilise l’interface txAdmin fournie avec FXServer. Dans le déployeur de recettes, sélectionnez le modèle QBCore Framework parmi les modèles populaires et suivez le guide d’installation actuel de QBCore. Le dépôt de recettes explique pourquoi un seul ZIP ne suffit pas : il prépare la base de données et télécharge un ensemble de ressources autour de qb-core.

1. Préparez un environnement de serveur FiveM pris en charge et un artefact FXServer actuel.
2. Démarrez txAdmin et créez un nouveau déploiement avec la recette populaire officielle QBCore.
3. Fournissez la clé de serveur demandée et les paramètres de base de données dans le flux de configuration documenté.
4. Laissez la recette déployer ses SQL et ressources au lieu de copier manuellement uniquement qb-core.
5. Examinez les server.cfg, l'ordre des ressources et les secrets avant d'exposer le serveur.
6. Démarrez le serveur et vérifiez la connectivité de la base de données, la création de personnages, les autorisations et les journaux.

La connexion à la base de données appartient à la configuration du serveur utilisée par oxmysql. Ne cherchez pas un champ de connexion à la base de données générique dans qb-core/config.lua; ce fichier est utilisé pour la configuration principale et des joueurs.

Ajouter une ressource QBCore en toute sécurité

Avant d'installer une ressource de job, d'inventaire, de cible, de téléphone ou d'interface utilisateur, enregistrez la version exacte de qb-core et de chaque système connexe avec lequel elle doit s’intégrer. Vérifiez ensuite les points suivants :

Vérifier	Ce qu'il faut vérifier
API du framework	Fonctions, exports, événements et champs de données de joueur requis pour le Core Object.
Dépendances	Ressources d'inventaire, de cible, de menu, d'entrée, de base de données et d'utilitaires avec des versions exactes.
Données	Migrations SQL, hypothèses de table, définitions d'objets ou de jobs et retour en arrière sécurisé.
Configuration	Permissions, locales, coordonnées, indicateurs de fonctionnalités et secrets réservés au serveur.
Ordre	Les dépendances démarrent avant la ressource et aucune duplication de remplacement n'est active.
Validation	Rôles autorisés et refusés, reconnexions, redémarrages, journaux client et journaux serveur.

Une étiquette de produit indiquant QBCore n'est que le premier signal de compatibilité. Si le serveur remplace la couche d'inventaire, de cible ou de menu de la recette, un script peut nécessiter un adaptateur documenté ou un changement de configuration. Appliquez d'abord les modifications de base de données à une copie de test et conservez une restauration qui couvre à la fois les fichiers et les données.

À qui QBCore convient

QBCore est un candidat raisonnable pour un nouveau serveur dont les ressources requises prennent explicitement en charge l'écosystème QB actuel, ou un serveur QB existant qui utilise déjà son Core Object et son modèle de données. Le choix devient plus coûteux lorsqu'une équipe dispose d'un grand ensemble de données ESX, de scripts spécifiques au framework ou d'événements personnalisés non documentés. Dans ce cas, inventoriez la surface de migration avant de sélectionner un nouveau framework.

Qbox a commencé à partir de la base de code QBCore et fournit un pont de compatibilité pour de nombreuses ressources QB bien écrites, mais la documentation officielle Qbox liste des exceptions. Ne supposez pas que chaque script QBCore est un script Qbox prêt à l'emploi. De même, ne migrez pas de ESX à QBCore en fonction d'une affirmation de performance générale. Comparez la couverture des ressources, les connaissances de l'équipe, la conversion des données et le plan de test.

QBCore, Qbox ou ESX

• Rester avec QBCore lorsque vos ressources et votre équipe actuelles dépendent déjà des API QBCore documentées et que le chemin de mise à niveau est compris.
• Prenez en compte Qbox lorsque vous voulez délibérément ses API et recette actuelles et pouvez auditer les exceptions de pont ressource par ressource.
• Restez avec ESX lorsque vos données de production, vos intégrations et vos connaissances opérationnelles sont spécifiques à ESX et qu'il n'y a pas de raison testée de migrer.

Utilisez la comparaison des frameworks pour prendre une décision selon des critères neutres. Lors de votre choix dans le catalogue des scripts FiveM payants, commencez par Scripts QBCore, confirmez les exigences sur la page exacte du produit et testez la ressource en préproduction avec une base de données représentative avant de la mettre en production.

Utilisez la recette officielle QBCore comme limite d'installation

Commencez par la recette QBCore txAdmin actuellement maintenue et le guide d'installation officiel. Une recette fournit une base de référence ; elle ne prouve pas qu'un ancien script tiers prend en charge les versions installées du framework, de la base de données, de l'inventaire ou de la cible. Enregistrez le commit de la recette et vérifiez chaque ressource ajoutée sur la pré-production avant la production.