QBCore est un cadre de jeu de rôle open-source pour FiveM. Son QB-Noyau 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-Noyau dossier comme une installation complète.
Points clés
QB-Noyauest la ressource principale, mais pas un serveur de jeu de rôle complet en soi.- Le guide officiel Windows déploie le modèle populaire du cadre QBCore 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
L'Objet Principal 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 de l'Objet Principal dont elle a besoin, mais sa surface API requise doit toujours correspondre à la version principale sur le serveur.
Les définitions partagées incluent les emplois, les gangs, les objets et les véhicules représentés dans des tables Lua. Les fonctions principales couvrent les opérations courantes du cadre, 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 cadre 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
Le chemin officiel actuel pour Windows utilise l'interface txAdmin bundled de FXServer. Dans le déployeur de recettes, sélectionnez le modèle populaire du cadre QBCore et suivez le guide d'installation actuel de QBCore. Le dépôt de recettes montre pourquoi l'installation d'un seul ZIP est incomplète : il provisionne la base de données et télécharge une collection de ressources autour de QB-Noyau.
- Préparez un environnement de serveur FiveM pris en charge et un artefact FXServer actuel.
- Démarrez txAdmin et créez une nouvelle déploiement en utilisant la recette populaire officielle QBCore.
- Fournissez la clé de serveur demandée et les paramètres de base de données dans le flux de configuration documenté.
- Laissez la recette déployer ses SQL et ressources au lieu de copier manuellement uniquement
QB-Noyau. - Examinez les
serveur.cfg, l'ordre des ressources et les secrets avant d'exposer le serveur. - 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, enregistrer la version exacte de QB-Noyau et chaque système connexe qu'il intégrera. Ensuite, travaillez à travers cette limite :
| 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. |
| Commande | 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 qui indique 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 ou une modification de configuration documentée. Appliquez les modifications de la base de données à une copie de test en premier et gardez un retour en arrière 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 une méthode de décision neutre. Lors de la sélection parmi les catalogue des scripts FiveM payants, commencez par Scripts QBCoreconfirmez les exigences sur la page produit exacte et mettez en scène la ressource contre une base de données représentative avant la production.
Prochaines étapes sûres
- Lisez le guide d'installation Windows QBCore actuel et la recette officielle avant de créer le serveur.
- Enregistrer les versions du cœur et des dépendances déployées après la fin de la recette.
- Choisir une ressource à la fois, lire ses notes d'installation officielles et tester ses permissions et ses chemins d'échec.
- Conservez les sauvegardes de la base de données et des ressources ensemble afin qu'un retour en arrière restaure un état cohérent.
Comparez QBCore avant de valider
Utilisez le Comparaison entre ESX, QBCore et Qbox pour la décision plus large, alors examinez le Migration et limite de compatibilité Qbox si une pile orientée Ox est en considération.
