Vous voulez installer QBCore FiveM en 2026 ? QBCore est devenu le framework RP le plus recommandé pour les nouveaux serveurs, grâce à son architecture moderne et ses meilleures performances par rapport à ESX Legacy. Mais l’installation demande de suivre les bonnes étapes dans le bon ordre — MySQL, oxmysql, qb-core, permissions admin — et les erreurs à ce stade bloquent tout le reste.
Ce guide vous explique tout en détail, des prérequis jusqu’aux premiers scripts RP à installer après QBCore.
QBCore ou ESX Legacy : lequel choisir en 2026 ?
C’est la première question que tout admin de serveur FiveM se pose. Les deux frameworks sont viables — le choix dépend de votre profil et de vos objectifs.
Critère | ESX Legacy | QBCore |
Niveau requis | Débutant à intermédiaire | Intermédiaire à avancé |
Architecture | Monolithique, plus simple | Modulaire, plus structurée |
Performances | Bonnes | Légèrement meilleures |
Scripts disponibles | Des milliers (base ESX plus ancienne) | En forte croissance depuis 2022 |
Documentation | Communautaire, très vaste | Officielle sur docs.qbcore.org |
Code Lua | Plus permissif | Plus strict, meilleures pratiques |
Recommandé pour | Premier serveur, équipe débutante | Projet sérieux, équipe avec dev Lua |
La règle en 2026 : si vous démarrez un premier serveur seul ou avec une équipe sans développeur Lua, ESX Legacy est plus accessible. Si vous avez quelqu’un qui sait coder en Lua ou si vous visez un serveur public professionnel sur le long terme, QBCore est le meilleur choix.
⚠️ Ne mélangez jamais ESX et QBCore ESX et QBCore sont incompatibles. Un script ESX ne fonctionnera pas sur QBCore et inversement. Choisissez un seul framework pour votre serveur et ne l’installez qu’une seule fois. Une migration ESX → QBCore représente 40 à 60 heures de travail selon la taille du serveur. |
Ce qu'il vous faut avant de commencer
- Un serveur FiveM avec txAdmin : chez Portallis, txAdmin est préconfiguré — vous pouvez installer QBCore directement via la recette txAdmin (voir étape 1)
- Une base de données MySQL : incluse chez Portallis — récupérez vos identifiants dans votre panel
- Un compte Cfx.re et une clé Keymaster : gratuits sur keymaster.fivem.net
- HeidiSQL ou phpMyAdmin : pour vérifier et gérer votre base de données si nécessaire
💡 RAM minimum pour QBCore QBCore avec les scripts de base nécessite minimum 4 Go de RAM. Pour une communauté publique avec 15-20 scripts (jobs, inventaire, véhicules), prévoyez 6 à 8 Go. QBCore est légèrement plus efficace en RAM qu’ESX à configuration équivalente. |
Installer QBCore FiveM via la recette txAdmin — méthode recommandée
La façon la plus simple d’installer QBCore sur FiveM en 2026 est d’utiliser la recette officielle txAdmin. Elle télécharge et configure automatiquement QBCore, oxmysql, ox_lib et les ressources de base dans le bon ordre.
- Connectez-vous à votre interface txAdmin (port 40120)
- Si c’est votre premier démarrage : choisissez « Popular Recipes » → « QBCore Framework »
- Si le serveur est déjà configuré : allez dans Settings → Recipe Deployer → New Recipe
- Renseignez votre clé Keymaster et vos identifiants MySQL
- Cliquez sur « Run Recipe » et attendez la fin du déploiement (2-5 minutes)
- Cliquez sur « Save & Start Server »
Ce que la recette installe automatiquement :
- [core] : qb-core, oxmysql, ox_lib — le cœur de QBCore
- [qb] : qb-multicharacter, qb-spawn, qb-apartments, qb-garages, qb-inventory, qb-clothing
- [qb-jobs] : qb-policejob, qb-ambulancejob
- [qb-vehicles] : qb-vehicleshop
💡 Recette txAdmin vs installation manuelle La recette txAdmin installe QBCore correctement en 5 minutes. L’installation manuelle (téléchargement GitHub, import SQL, server.cfg à la main) prend 30 à 60 minutes et est plus propice aux erreurs. Utilisez toujours la recette txAdmin pour un premier serveur QBCore. |
Lancer mon serveur FIVEM sur Portallis
Plans RAM dès 4 Go à 4€/mois — Ryzen 7 9700X — txAdmin inclus — Support humain
Installation manuelle de QBCore — pour les cas avancés
Si vous ne passez pas par txAdmin ou si vous devez mettre à jour QBCore manuellement, voici la procédure complète.
Télécharger QBCore depuis GitHub
Rendez-vous sur github.com/qbcore-framework/qb-core. Téléchargez le ZIP de la dernière release stable.
- Décompressez l’archive
- Placez le dossier qb-core dans resources/[core]/ de votre serveur
- Téléchargez également oxmysql et ox_lib depuis leurs dépôts GitHub respectifs
Créer et importer la base de données
Connectez-vous à votre MySQL via HeidiSQL. Créez une nouvelle base de données :
Nom : qbcore
Encodage : utf8mb4_unicode_ci
Importez le fichier SQL fourni avec qb-core (dossier qb-core/sql/). Ce fichier crée toutes les tables nécessaires : players, player_vehicles, player_houses, etc.
Configurer le server.cfg pour QBCore
Voici l’ordre de chargement correct pour QBCore :
# ── Connecteur MySQL ──────────────────────
ensure oxmysql
# ── Librairie ox ──────────────────────────
ensure ox_lib
# ── Cœur QBCore ───────────────────────────
ensure qb-core
# ── Ressources de base ────────────────────
ensure qb-multicharacter
ensure qb-spawn
ensure qb-apartments
# ── Inventaire et apparence ───────────────
ensure qb-inventory
ensure qb-clothing
# ── Véhicules ─────────────────────────────
ensure qb-garages
ensure qb-vehicleshop
# ── Jobs ──────────────────────────────────
ensure qb-policejob
ensure qb-ambulancejob
Règle absolue : oxmysql → ox_lib → qb-core → tout le reste. Ne jamais charger un script QBCore avant qb-core.
Configurer QBCore après l'installation
Une fois QBCore installé sur FiveM, plusieurs paramètres sont à personnaliser selon la philosophie de votre serveur. Tout se passe dans le fichier qb-core/shared/main.lua.
Les paramètres principaux à ajuster
Paramètre | Valeur par défaut | Ce que ça change |
QBShared.Locale | ‘en’ | Langue — mettez ‘fr’ pour un serveur français |
StarterAmount.cash | 500 | Argent liquide de départ |
StarterAmount.bank | 5000 | Argent en banque de départ |
MaxInventorySlots | 41 | Nombre de slots inventaire |
MaxInventoryWeight | 120000 | Poids max inventaire (en grammes) |
DefaultJob | ‘unemployed’ | Job par défaut des nouveaux joueurs |
MaxPlayers | 64 | Joueurs max sur le serveur |
💡 Langue française Pour un serveur francophone, ajoutez QBShared.Locale = ‘fr’ dans main.lua. Vérifiez aussi que vos scripts QBCore ont un fichier de traduction fr.lua — la plupart des scripts populaires en ont un. |
Configurer les permissions admin
Dans QBCore, les permissions admin se configurent dans le fichier qb-core/server/main.lua. Pour vous donner les droits administrateur :
- Connectez-vous à votre serveur une première fois
- Dans la console txAdmin, tapez add_ace identifier.steam:XXXXXX group.admin allow en remplaçant XXXXXX par votre Steam Hex
- Votre Steam Hex est visible dans les logs de connexion txAdmin ou via la commande info dans la console FiveM en jeu
Les niveaux de permissions QBCore disponibles :
- god : accès total à toutes les commandes — réservé au propriétaire
- admin : gestion des joueurs, téléportation, spawn de véhicules et objets
- mod : modération basique — kick, ban temporaire
- user : joueur standard — aucun accès admin
Les premiers scripts QBCore à installer
QBCore seul est une base — les scripts sont ce qui donne vie à votre serveur RP. Voici les ressources à ajouter en priorité :
Script | Rôle | Note |
qb-phone | Téléphone en jeu | Indispensable pour le RP — communications, apps |
qb-hud | Interface HUD | Santé, faim, soif, bouclier, oxygène |
qb-target | Système d’interaction | Remplace les touches pour les interactions avec le monde |
qb-menu | Menu contextuel | Requis par beaucoup de scripts QBCore |
qb-smallresources | Pack de petites ressources | Météo, heures, actions basiques — très léger |
qb-radialmenu | Menu radial | Accès rapide aux actions courantes |
qb-drugs | Système de drogues | Économie illégale — complète le système de jobs |
Comment ajouter un script QBCore :
- Téléchargez le script depuis GitHub officiel ou docs.qbcore.org
- Placez-le dans resources/[qb]/ pour une arborescence propre
- Ajoutez ensure nom-du-script dans server.cfg, après qb-core
- Importez le fichier .sql si le script en fournit un
- Redémarrez le serveur et vérifiez les logs
Les erreurs fréquentes après installation de QBCore
« qb-core is not started »
Un script tente de charger avant qb-core. Vérifiez l’ordre des ensure dans server.cfg — qb-core doit apparaître avant tous les scripts [qb].
Erreur MySQL au démarrage
Vérifiez votre chaîne de connexion dans server.cfg. La syntaxe correcte pour oxmysql est mysql://USER:PASS@localhost/qbcore?charset=utf8mb4. Attention aux caractères spéciaux dans le mot de passe — encodez-les si nécessaire.
Les personnages ne se sauvegardent pas
Vérifiez que la table players existe dans votre base de données et que l’import SQL s’est bien passé. Reconnectez-vous à HeidiSQL et vérifiez que toutes les tables QBCore sont présentes (players, player_vehicles, player_houses, etc.).
qb-multicharacter ne s’affiche pas
Ce script nécessite que qb-spawn soit chargé après lui dans server.cfg. Vérifiez également que ox_lib est bien chargé avant qb-core — qb-multicharacter dépend de ox_lib pour son interface.
FAQ — Questions fréquentes sur l'installation de QBCore FiveM
QBCore est-il gratuit ?
Oui, QBCore est entièrement gratuit et open source. Le framework principal et la plupart des scripts officiels sont disponibles gratuitement sur GitHub. Certains scripts premium créés par la communauté sont payants, mais le framework lui-même ne coûte rien.
Quelle est la différence entre QBCore et Qbox ?
Qbox est un fork de QBCore qui pousse encore plus loin la modularité et la sécurité. Il utilise un système d’items plus strict et une architecture encore plus cloisonnée. Pour un premier serveur, restez sur QBCore — Qbox est pour les équipes expérimentées qui veulent contrôle total.
Peut-on migrer un serveur ESX vers QBCore ?
Techniquement oui, mais c’est un projet majeur. La migration implique de réécrire tous vos scripts (les API ESX et QBCore sont différentes), de migrer la base de données (schéma différent), et de retester tout. Comptez 40 à 60 heures minimum pour un serveur bien développé.
Combien de RAM faut-il pour un serveur QBCore ?
Minimum 4 Go de RAM pour QBCore avec les scripts de base. Pour 20+ scripts actifs et une communauté publique de 30 joueurs, prévoyez 6 à 8 Go. QBCore est légèrement plus performant qu’ESX à configuration équivalente.
Où trouver des scripts QBCore en français ?
La documentation officielle est sur docs.qbcore.org. Pour les scripts francophones, consultez le forum officiel Cfx.re (rubrique Releases, filtre QBCore) et les serveurs Discord de la communauté FiveM française. Beaucoup de scripts populaires ont des fichiers de traduction fr.lua disponibles sur leurs GitHub.
Conclusion
Vous savez maintenant comment installer QBCore sur votre serveur FiveM correctement en 2026 : via la recette txAdmin pour aller vite, ou manuellement pour plus de contrôle. L’essentiel est de respecter l’ordre de chargement (oxmysql → ox_lib → qb-core), de configurer MySQL correctement, et d’ajouter les scripts un par un.
Chez Portallis, votre serveur FiveM avec QBCore est opérationnel en quelques minutes — txAdmin préconfiguré, MySQL inclus, plans RAM dès 4 Go à 4€/mois, et support francophone disponible.
- À lire aussi : Installer txAdmin FiveM — guide complet
- À lire aussi : Installer ESX FiveM — guide complet
- Documentation officielle QBCore : docs.qbcore.org