Comment installer QBcore sur FiveM : Guide complet pour débutants et experts

Vous rêvez de créer votre propre serveur FiveM avec un framework moderne et performant ? QBcore est la solution idéale pour les développeurs et les joueurs souhaitant une expérience RP (RolePlay) riche et personnalisable. Ce framework open-source, inspiré de QBCore pour GTA V, offre une base solide pour construire des serveurs FiveM avec des systèmes de métiers, d’inventaire, de gangs et bien plus. Dans ce guide, nous vous expliquons comment installer QBcore sur FiveM étape par étape, en détaillant les prérequis, les configurations et les astuces pour éviter les erreurs courantes. Que vous soyez débutant ou administrateur expérimenté, ce tutoriel vous accompagnera vers la création d’un serveur FiveM fonctionnel et optimisé.

Qu’est-ce que QBcore et pourquoi l’utiliser sur FiveM ?

QBcore est un framework open-source conçu pour FiveM, la plateforme de modding multijoueur pour GTA V. Il se distingue par sa modularité, sa documentation complète et sa communauté active, ce qui en fait un choix privilégié pour les serveurs RP. Contrairement à d’autres frameworks comme ESX, QBcore propose une architecture plus intuitive, avec des systèmes intégrés comme l’inventaire, les métiers, les gangs, les véhicules et les économies. Son succès repose sur sa capacité à s’adapter à tous les types de serveurs, des plus simples aux plus complexes. Lancé en 2020, QBcore a rapidement gagné en popularité grâce à ses mises à jour régulières et son support actif sur des plateformes comme GitHub et Discord. Aujourd’hui, il est considéré comme l’un des frameworks les plus stables et les plus complets pour FiveM, avec des milliers de serveurs l’utilisant dans le monde entier.

Fonctionnement de QBcore : Les bases à connaître

Avant de procéder à l’installation, il est essentiel de comprendre comment QBcore fonctionne et quels sont ses principaux composants. Voici les éléments clés à maîtriser :

• Architecture modulaire : QBcore est divisé en plusieurs modules (Core, Player, Inventory, Jobs, etc.), ce qui permet une personnalisation facile. Chaque module peut être modifié ou remplacé sans affecter le reste du framework.
• Système de base de données : QBcore utilise principalement MySQL pour stocker les données des joueurs, des véhicules et des économies. Une configuration correcte de la base de données est cruciale pour éviter les bugs.
• Scripts Lua : Le framework repose sur des scripts Lua, un langage de programmation simple et puissant. Les développeurs peuvent créer leurs propres scripts ou modifier ceux existants pour adapter QBcore à leurs besoins.
• Intégration avec FiveM : QBcore s’installe comme un ressource FiveM, ce qui signifie qu’il s’exécute en arrière-plan et interagit avec le jeu via l’API FiveM. Il est compatible avec les dernières versions de FiveM et de GTA V.
• Système de permissions : QBcore inclut un système de permissions avancé, permettant de gérer les accès aux commandes et aux fonctionnalités en fonction des rôles des joueurs (admin, modérateur, etc.).

Prérequis pour installer QBcore sur FiveM

Avant de commencer l’installation, assurez-vous de disposer des éléments suivants :

• Un serveur FiveM dédié : Vous pouvez utiliser un VPS (comme OVH, Hetzner ou Scaleway) ou un hébergement FiveM spécialisé. Évitez les serveurs partagés, car QBcore nécessite des ressources dédiées.
• Un client FiveM à jour : Téléchargez la dernière version de FiveM depuis le site officiel et installez-la sur votre machine.
• Un accès FTP ou SSH : Pour transférer les fichiers de QBcore sur votre serveur, vous aurez besoin d’un client FTP (comme FileZilla) ou d’un accès SSH.
• Une base de données MySQL : QBcore nécessite une base de données pour stocker les informations des joueurs. Vous pouvez utiliser un service comme XAMPP, WAMP ou un hébergement MySQL dédié.
• Git (optionnel mais recommandé) : Si vous souhaitez cloner le dépôt GitHub de QBcore directement sur votre serveur, installez Git pour faciliter les mises à jour.
• Un éditeur de code : Pour modifier les fichiers de configuration, utilisez un éditeur comme VS Code, Notepad++ ou Sublime Text.

Étape 1 : Télécharger QBcore depuis GitHub

La première étape consiste à récupérer les fichiers de QBcore. Voici comment procéder :

1. Rendez-vous sur le dépôt GitHub officiel : Allez sur https://github.com/qbcore-framework/qb-core et cliquez sur le bouton vert "Code" puis "Download ZIP".
2. Extraire l’archive : Une fois le fichier ZIP téléchargé, extrayez-le sur votre ordinateur. Vous obtiendrez un dossier nommé "qb-core-main".
3. Renommer le dossier : Pour éviter les conflits, renommez le dossier en "qb-core" (sans le "-main").
4. Préparer les fichiers pour le serveur : Copiez l’intégralité du dossier "qb-core" dans le répertoire resources de votre serveur FiveM. Ce répertoire se trouve généralement dans le dossier principal de FiveM (ex: /home/fivem/server-data/resources/).

Étape 2 : Configurer la base de données MySQL

QBcore nécessite une base de données MySQL pour fonctionner correctement. Voici comment la configurer :

1. Créer une base de données : Connectez-vous à votre panneau de contrôle MySQL (via phpMyAdmin ou un client comme MySQL Workbench) et créez une nouvelle base de données. Notez son nom, car vous en aurez besoin plus tard.
2. Importer les tables QBcore : Dans le dossier "qb-core", vous trouverez un sous-dossier nommé "sql". À l’intérieur, il y a un fichier nommé qb-core.sql. Importez ce fichier dans votre base de données fraîchement créée.
3. Configurer les identifiants de connexion : Ouvrez le fichier config.lua situé dans le dossier "qb-core/server". Modifiez les lignes suivantes pour correspondre à vos identifiants MySQL : Config.Mysql = { host = "localhost", username = "votre_utilisateur", password = "votre_mot_de_passe", database = "nom_de_votre_base_de_donnees" }
4. Vérifier les permissions : Assurez-vous que l’utilisateur MySQL que vous utilisez a les permissions nécessaires pour lire et écrire dans la base de données.

Étape 3 : Ajouter QBcore au fichier server.cfg

Pour que QBcore soit reconnu par FiveM, vous devez l’ajouter à la liste des ressources à démarrer automatiquement. Voici comment faire :

1. Ouvrir le fichier server.cfg : Ce fichier se trouve généralement dans le dossier principal de votre serveur FiveM (ex: /home/fivem/server-data/server.cfg).
2. Ajouter la ligne suivante : Insérez cette ligne dans le fichier, de préférence en haut de la liste des ressources : ensure qb-core
3. Sauvegarder et redémarrer le serveur : Enregistrez le fichier et redémarrez votre serveur FiveM pour appliquer les changements. Vous devriez voir QBcore apparaître dans la liste des ressources chargées.

Étape 4 : Configurer les permissions et les groupes

QBcore inclut un système de permissions avancé pour gérer les administrateurs et les modérateurs. Voici comment le configurer :

1. Ouvrir le fichier admin.lua : Ce fichier se trouve dans le dossier qb-core/server/permissions.
2. Ajouter un administrateur : Cherchez la section ["admin"] et ajoutez votre identifiant FiveM (Steam ID ou License) comme suit : ["steam:110000123456789"] = { rank = "admin", permission = "all" }
3. Définir les permissions : Vous pouvez personnaliser les permissions en modifiant les valeurs dans le même fichier. Par exemple, pour donner un accès limité, utilisez : ["steam:110000987654321"] = { rank = "mod", permission = "kick, ban, warn" }
4. Sauvegarder et tester : Enregistrez le fichier et connectez-vous à votre serveur avec l’identifiant que vous avez ajouté. Vous devriez avoir accès aux commandes admin.

Étape 5 : Personnaliser QBcore avec des scripts supplémentaires

QBcore est conçu pour être personnalisable. Vous pouvez ajouter des scripts supplémentaires pour étendre ses fonctionnalités. Voici quelques exemples populaires :

• QB-Inventory : Pour un système d’inventaire plus avancé.
• QB-Jobs : Pour ajouter des métiers personnalisés.
• QB-Menu : Pour créer des menus interactifs.
• QB-Admin : Pour des commandes admin supplémentaires.

Pour installer un script supplémentaire :

1. Télécharger le script : Récupérez le script depuis GitHub ou un site spécialisé comme Cfx.re.
2. Placer le dossier dans resources : Copiez le dossier du script dans le répertoire resources de votre serveur.
3. Ajouter au server.cfg : Insérez une ligne ensure nom_du_script dans le fichier server.cfg.
4. Configurer le script : Modifiez les fichiers de configuration du script selon vos besoins.

Astuces pour optimiser votre serveur QBcore

Une fois QBcore installé, voici quelques astuces pour optimiser votre serveur et éviter les problèmes courants :

• Mettre à jour QBcore régulièrement : Consultez le dépôt GitHub de QBcore pour télécharger les dernières mises à jour. Utilisez Git pour faciliter les mises à jour automatiques : cd /home/fivem/server-data/resources/qb-core git pull origin main
• Optimiser la base de données : Utilisez des outils comme phpMyAdmin pour optimiser les tables MySQL et améliorer les performances. Vous pouvez aussi configurer des sauvegardes automatiques.
• Limiter les ressources gourmandes : Évitez d’installer trop de scripts en même temps. Testez chaque script un par un pour identifier les éventuels conflits.
• Configurer le fichier fxmanifest.lua : Ce fichier, présent dans chaque ressource, permet de définir les dépendances et les fichiers à charger. Assurez-vous qu