Comment installer qbCore sur un serveur FiveM

Comment installer qbCore sur un serveur FiveM

Lorsque vous êtes prêt à donner vie à votre serveur de jeu de rôle FiveM, choisir le bon framework est essentiel. qbCore est devenu un plébiscité par la communauté car il simplifie l'installation, est constamment mis à jour et propose une riche bibliothèque de scripts gratuits pour une immersion optimale. Ce guide vous guidera étape par étape pour une installation fluide de qbCore.

Présentation de qbCore

qbCore est un framework open source simplifié, spécialement conçu pour FiveM. Il étend les fonctionnalités de base du serveur grâce à des scripts RP faciles à déployer, une architecture modulaire et des outils d'administration performants. Que vous soyez novice ou expérimenté, qbCore simplifie la configuration et vous permet de vous concentrer sur le plaisir de jeu.

Installation de qbcore : guide étape par étape

1. Conditions préalables

Avant de commencer, assurez-vous d'avoir :
– Un serveur FiveM fonctionnel – utilisez notre tutoriel de démarrage rapide s'il vous en manque un.
– Connaissances de base en administration de serveur – possibilité de modifier les fichiers de configuration et de redémarrer les services.
– Accès au dossier « ressources/ » de votre serveur – généralement situé dans le répertoire principal du serveur.
– Un éditeur de texte brut comme Notepad++ pour éditer des fichiers Lua.

Ce sont les seules conditions dont vous avez besoin ; qbCore lui-même ne nécessite aucun logiciel spécial.

2. Téléchargez qbCore

Rendez-vous sur le dépôt officiel sur GitHub : `https://github.com/qbcore-framework`.
Cliquez Code → Télécharger le ZIP pour récupérer la dernière version.
Une fois le téléchargement terminé, décompressez le dossier dans un emplacement temporaire sur votre ordinateur.
Aucun compte GitHub n'est nécessaire, mais la connexion peut vous aider à rester informé des nouvelles versions.

3. Transférer qbCore dans Ressources

Ouvrez votre dossier de ressources FiveM.
Faites glisser le dossier « qb-core » extrait dans ce répertoire et laissez-le intact – vous n'ouvrirez plus jamais le ZIP compressé.

4. Configurer qbCore

Accédez à `qb-core/qb-core/config.lua`.
Faites un clic droit et ouvrez-le avec votre éditeur préféré.
Ici vous allez :
– Définir la base de données: collez votre chaîne de connexion sous `Config.Database`.
– Ajuster l'identité du serveur: modifiez les valeurs « Config.ServerName » et « Config.Webhook » pour qu'elles correspondent à votre image de marque.
– Choisir les modules: basculez les sections pour activer ou désactiver des fonctionnalités telles que les systèmes de travail ou les ateliers de véhicules.
Prenez note des commentaires dans le fichier pour vous guider.
Une fois terminé, enregistrez et fermez le fichier.

5. Activer qbCore dans la configuration du serveur

Ouvrez « server.cfg » situé à côté de « resources/ ».
Ajoutez la ligne suivante en bas :
“`
assurer le qb-core
“`
Cela indique à FiveM de charger la ressource qb-core au démarrage.
Enregistrez et fermez le fichier.

6. Redémarrez le serveur

Redémarrez correctement votre service FiveM, soit à partir de votre panneau de contrôle d'hébergement, soit en exécutant « exit » dans l'invite de commande.
Un redémarrage propre ferme les connexions ouvertes, efface la mémoire et garantit que la ressource qb-core nouvellement ajoutée est entièrement initialisée.

7. Vérifiez l'installation

Connectez-vous à votre serveur avec le client FiveM.
Ouvrez la console (F8) et tapez les commandes « qb_ » ; la liste de commandes qui apparaît prouve que qbCore est actif.
Vous devriez également voir un message « qbCore boot » dans le journal du serveur.

Si tout se charge sans erreur, vous avez terminé avec succès l'installation de qbcore.

Ajout de scripts supplémentaires

La nature modulaire de qbCore signifie que vous pouvez déposer des dossiers de scripts supplémentaires dans « resources/ » et simplement les « assurer » dans « server.cfg ».
Les choix populaires incluent :

– emplois – des scripts de travail pré-établis pour les carrières dans la police, les services médicaux d’urgence ou la criminalité.
– magasins – des magasins d’armes, de voitures et de cosmétiques à l’intérieur de la ville.
– véhicules – listes de véhicules personnalisés et systèmes de garage.
Tous les scripts sont disponibles gratuitement sur qbCore GitHub ou forums communautaires.

Exemple : ajout d'une tâche simple

Téléchargez un script de travail zip, décompressez-le, déplacez le dossier vers `resources/`.
Ajoutez « ensure myjob » à « server.cfg ».
Redémarrez, puis utilisez « setplayerjob myjob » pour tester.

Questions fréquemment posées

Q : Qbcore est-il meilleur qu'ESX ?
R : Les deux frameworks bénéficient de communautés fortes. qbCore se distingue par son style de codage Lua moderne et son utilisation allégée des ressources, tandis qu'ESX offre une base stable vieille de plusieurs décennies. Le choix dépend généralement des préférences personnelles et des fonctionnalités requises.

Q : Où puis-je trouver des scripts qbcore gratuits ?
R : Visitez des portails populaires comme Cfx.re, HiFiveM et Tebex. Recherchez « qbcore » pour trouver des modules complémentaires compatibles.

Q : qbCore est-il gratuit ?
R : Absolument. L'ensemble du framework est open source sous licence MIT, vous pouvez donc le modifier et l'héberger gratuitement.

Réflexions finales – Votre parcours d'installation de qbcore

L'installation complète de qbcore ouvre la voie à des possibilités de jeu de rôle infinies. La configuration simple du framework, associée au soutien actif de la communauté, vous permet de vous concentrer sur la création d'expériences uniques plutôt que de vous attaquer à du code serveur de bas niveau.

En suivant ces étapes, vous aurez établi une base solide qui évoluera avec votre serveur. À mesure que de nouveaux scripts et mises à jour apparaîtront, vous pourrez facilement améliorer votre environnement, maintenir l'engagement des joueurs et gérer efficacement votre communauté.

Il est maintenant temps de vous lancer, d'explorer les fonctionnalités de qbCore et de créer un serveur FiveM qui donne vie à votre vision. Bonne chance et profitez de chaque instant de création.