ESX, QBCore ou Qbox : quel framework choisir pour FiveM ?
La première grande décision à prendre quand vous ouvrez un serveur roleplay FiveM, c'est le framework de base : ESX Legacy, QBCore ou Qbox. Dans ce guide, nous comparons les trois selon la communauté, l'écosystème de scripts, les performances, la courbe d'apprentissage, la langue de la documentation et des ressources, et la difficulté de migration ; nous expliquons lequel convient à quel projet et comment installer votre choix avec une recette txAdmin. Les informations de version et de dépendances proviennent de la documentation officielle et des dépôts de code source des frameworks.
Avant de commencer
- Un VDS : la gamme recommandée pour FiveM est le VDS AMD Ryzen 9 9950X, avec ses performances élevées en monocœur. Les offres adaptées à FiveM sont listées sur la page Location de serveur FiveM.
- Un compte Cfx.re et une clé de licence : la clé ne s'obtient plus sur Keymaster ; vous la créez gratuitement sur la page « Registration keys » du Cfx.re Portal (portal.cfx.re). Le guide d'installation Windows de QBCore mentionne encore Keymaster ; cette information est dépassée.
- MariaDB : les trois frameworks se connectent à la base de données via
oxmysqlet ont besoin d'un serveur compatible MySQL. Les documentations d'ESX et de Qbox vous demandent explicitement de ne pas utiliser XAMPP. Pour Qbox, la version minimale est MariaDB 10.9.0 et la version recommandée est la 12.3 LTS (support à long terme) ; MySQL n'est pas pris en charge. - Disque : la documentation d'installation d'ESX demande environ 10 Go d'espace libre pour les fichiers du serveur (artifact), les ressources et la base de données ; prévoyez au moins autant pour les autres frameworks.
- Exigence supplémentaire pour Qbox :
qbx_coreexige le build FXServer (artifact)10731ou plus récent, ainsi que l'activation de OneSync. - Si vous n'avez pas encore installé FXServer, suivez d'abord le guide d'installation de FXServer ; cet article part de cette base.
1. Découvrez les trois frameworks
ESX Legacy est le plus ancien des trois. Sa forme actuelle se trouve dans le dépôt esx_core ; la ressource principale est es_extended (version 1.16.0 dans le manifeste), et elle dépend des ressources esx_lib et oxmysql. Les add-ons officiels sont regroupés dans un dépôt séparé (esx-legacy-addons). Il est publié sous licence GPL-3.0. Selon la documentation officielle, les briques de base fournies par ESX sont un système de métiers, un système bancaire et monétaire, la création de personnage et la gestion d'inventaire.
QBCore est un framework construit autour de la ressource qb-core, qui utilise le modèle « core object » (objet central) : les scripts accèdent au cœur avec l'appel exports['qb-core']:GetCoreObject(). Le manifeste indique la version 1.3.0, sa seule dépendance est oxmysql et la licence est GPL-3.0. La documentation officielle décrit une à une des ressources comme qb-inventory, qb-target, qb-multicharacter, qb-phone, qb-policejob, qb-garages, qb-banking et qb-houses, soit plus de 50 ressources au préfixe qb- au total ; c'est de là que vient son côté « pack prêt à l'emploi ».
Qbox est un framework dérivé (fork) de QBCore qui vise à l'améliorer. La ressource principale est qbx_core (version 1.24.0 dans le manifeste) ; ox_lib et oxmysql sont des dépendances obligatoires, et le README mentionne aussi ox_inventory. Le manifeste fournit également le nom qb-core : comme la couche de compatibilité (bridge) couvre les usages documentés de qb-core, la plupart des scripts QBCore fonctionnent sans modification. Selon la FAQ du projet, la plupart des ressources ont été refondues (refactor) pour la qualité du code, la sécurité et les performances ; plutôt que de maintenir ses propres ressources, qui resteraient moins abouties, le projet s'appuie sur des projets open source, en particulier les ressources ox d'Overextended.
La page officielle Frameworks de FiveM cite aussi ND et vRP à côté de ces trois-là. Cfx.re n'est lié à aucun framework, ne fournit pas d'assistance pour les frameworks et vous renvoie à la documentation de chaque projet ; le support communautaire se trouve sur les serveurs Discord des projets eux-mêmes.
2. Tableau comparatif
| Critère | ESX Legacy | QBCore | Qbox |
|---|---|---|---|
| Ressource principale / version | es_extended 1.16.0 | qb-core 1.3.0 | qbx_core 1.24.0 |
| Dépendances obligatoires | esx_lib, oxmysql | oxmysql | ox_lib, oxmysql, artifact ≥ 10731, OneSync |
| Base de données | Compatible MySQL ; MariaDB recommandé, pas de XAMPP | MariaDB + HeidiSQL (guide Windows officiel) | Uniquement MariaDB ≥ 10.9.0 (12.3 LTS recommandée) |
| Licence | GPL-3.0 | GPL-3.0 | GPL-3 (fichier LICENSE du dépôt) |
| Communauté et ancienneté | Le plus ancien des trois ; l'historique de forum le plus long | Large et active ; vaste écosystème qb- | Le plus jeune ; issu de QBCore, étroitement lié à l'écosystème ox |
| Écosystème de scripts | Dépôt d'add-ons officiel et scripts communautaires accumulés depuis des années ; les scripts écrits pour d'anciennes versions d'ESX peuvent être incompatibles | Très vaste ; plus de 50 ressources qb- dans la documentation officielle | Ses propres ressources qbx_ + la plupart des scripts QBCore via le bridge |
| Performances | Aucun benchmark comparatif officiel ; la charge dépend des scripts que vous ajoutez | Aucun benchmark comparatif officiel ; la charge dépend des scripts que vous ajoutez | Refondu pour les performances selon la FAQ ; les ressources converties pour Qbox consomment moins de mémoire |
| Courbe d'apprentissage | Faible ; c'est ici qu'on trouve le plus d'exemples et de tutoriels | Moyenne ; il faut apprendre le core object et la structure qb- | Moyenne à élevée ; connaître ox_lib et lire de la documentation en anglais est indispensable |
| Ressources en turc (observation) | Abondantes | Abondantes | Rares ; documentation et Discord surtout en anglais |
| Les scripts QBCore fonctionnent-ils ? | Non, il n'y a pas de bridge | Oui | Oui pour la plupart (bridge), avec des exceptions |
Faites attention à la ligne des performances : d'anciens guides font circuler des affirmations comme « QBCore consomme beaucoup moins de CPU et de RAM », mais la documentation officielle des frameworks ne contient aucune mesure comparative de ce type. En pratique, ce qui charge le serveur, ce sont le plus souvent les scripts d'inventaire, de téléphone, de HUD et de véhicules que vous ajoutez par-dessus. Faites la comparaison sur votre propre serveur avec resmon ; la façon de lire ses résultats est expliquée dans le guide Resmon.
3. Langue de la documentation et des ressources
Cette section n'est pas une donnée mesurable, mais une observation faite dans la communauté FiveM turque. Comme ESX existe depuis le plus longtemps, c'est le framework qui y compte le plus de vidéos, de sujets de forum et de scripts traduits en turc ; quand on y cherche une erreur ESX, on trouve souvent une solution en turc. QBCore s'y est lui aussi très largement répandu ; les paquets qb- traduits en turc et les tutoriels d'installation en turc abondent. Pour Qbox, la situation est différente : la documentation officielle et le Discord sont surtout en anglais, et le contenu en turc est rare. Si vous avez du mal à lire de la documentation en anglais, cela peut suffire, à lui seul, à vous faire écarter Qbox. Pour obtenir de l'aide dans une autre langue que l'anglais, il faut se tourner vers les forums communautaires et les groupes de propriétaires de serveurs.
4. Difficulté de migration : passer d'un framework à un autre
Changer de framework ne se résume pas à copier des fichiers : la structure des tables de la base de données, les données des joueurs, les définitions de métiers et d'objets, ainsi que les événements (events) écoutés par les scripts changent tous. Voici ce à quoi vous pouvez raisonnablement vous attendre selon le sens de la migration :
| Sens | Difficulté | Raison |
|---|---|---|
| ESX → QBCore | Élevée | Les noms d'événements, les données des joueurs et les tables sont complètement différents ; les scripts sont réécrits et les données des joueurs converties à la main. |
| QBCore → ESX | Élevée | Même raison ; il n'existe de bridge officiel dans aucun des deux sens. |
| QBCore → Qbox | Faible à moyenne | La couche de compatibilité fait tourner la plupart des scripts qb- ; les scripts qui accèdent directement aux tables ou utilisent les fichiers internes de qb-core ne fonctionnent plus. |
| Qbox → QBCore | Moyenne à élevée | Les ressources écrites avec les fonctions exportées (exports) par qbx_core n'ont pas d'équivalent dans QBCore ; elles doivent être réécrites. |
| ESX → Qbox | Élevée | Le bridge ne concerne que les scripts QBCore ; il n'aide en rien pour les scripts ESX. |
La FAQ de Qbox énumère explicitement les exceptions : l'accès direct aux tables de la base de données, l'accès à des fichiers de qb-core qui n'étaient pas prévus pour être utilisés par d'autres ressources, et la mauvaise utilisation de fonctions existantes. Les scripts multijob fonctionnent s'ils ajoutent, modifient et suppriment les métiers via les exports de qbx_core. Avant de vous décider, posez la question aux auteurs de vos scripts payants : « Est-ce que cela fonctionne avec le bridge Qbox ? »
5. Choisissez en fonction de votre projet
- Votre premier serveur, un petit groupe d'amis, et vous voulez trouver de l'aide facilement : ESX Legacy. C'est là que l'on trouve le plus d'exemples, le plus de scripts prêts à l'emploi et le dépannage le plus simple.
- Vous voulez un pack de ville intégré avec téléphone, inventaire, police, garage et logements : QBCore. Toutes ces ressources qb- sont décrites une à une dans la même documentation officielle.
- Vous avez une équipe technique et voulez un projet durable et l'écosystème ox_lib/ox_inventory : Qbox. Vous obtenez des ressources refondues pour la sécurité et la qualité du code, et grâce au bridge, vous continuez à utiliser la plupart de vos scripts QBCore existants. En contrepartie, vous devez lire de la documentation en anglais ; le README vous conseille aussi de ne pas modifier le cœur au-delà de ses fichiers de configuration.
- Vous avez un serveur QBCore en service et voulez le moderniser : passez d'abord à Qbox sur un serveur de test, listez les scripts qui ne fonctionnent plus avec le bridge, puis mettez en production.
- Vous avez un serveur ESX en service : si le serveur fonctionne sans problème, ne changez pas de framework ; maintenez
es_extendedà jour et remplacez les anciens scripts par leurs versions compatibles Legacy.
6. Installez le framework choisi avec une recette txAdmin
La documentation des trois frameworks renvoie, pour l'installation, à la liste « Popular Recipes » (recettes populaires) de txAdmin. txAdmin est fourni avec FXServer : il s'ouvre lorsque vous démarrez FXServer sans le paramètre +exec server.cfg et affiche l'adresse de configuration dans la console. Sous Windows Server, extrayez l'archive dans C:\FXServer\server et lancez FXServer.exe. Sous Linux (Ubuntu/Debian), après avoir téléchargé l'artifact dans le dossier ~/FXServer/server :
cd ~/FXServer/server && tar xf fx.tar.xz
bash ~/FXServer/server/run.sh
Dans le navigateur, associez votre compte Cfx.re avec le code PIN, définissez un mot de passe administrateur, choisissez la recette, puis saisissez les informations de la base de données et la clé de licence dans le « Recipe Deployer » ; à la dernière étape, démarrez le serveur avec « Save & Run Server ». L'installation de MariaDB et les réglages de server.cfg sont détaillés dans le guide d'installation de QBCore, et le reste de txAdmin dans le guide txAdmin. Les réglages qui diffèrent d'un framework à l'autre sont les suivants :
| Réglage | ESX Legacy | QBCore | Qbox |
|---|---|---|---|
| Recette txAdmin | ESX Legacy | QBCore Framework | QBox Framework |
| Build FXServer | Dernier build ; le build « recommended » peut provoquer des erreurs | Pas de minimum dans le manifeste | Au moins 10731, OneSync activé |
| Base de données (exemple) | localhost, port 3306, nom esx_legacy | localhost, port 3306, nom de votre choix | Identique ; le serveur doit faire tourner MariaDB 10.9.0 ou plus récent |
| Premier démarrage | Aucune étape supplémentaire dans la documentation | Attendez la fin de yarn install | Les mises à jour de tables et les index sont appliqués automatiquement au démarrage de la ressource |
Pour les trois, le port de jeu est 30120 en TCP+UDP (endpoint_add_tcp "0.0.0.0:30120" et endpoint_add_udp "0.0.0.0:30120") ; l'interface web de txAdmin écoute par défaut sur 40120 en TCP. Ouvrez ces ports dans le pare-feu du système d'exploitation.
Erreurs fréquentes
- « Native XXXXXXXX is not supported » : selon la documentation d'ESX, la cause est le build marqué « recommended » ; téléchargez le dernier artifact. Sur Qbox, si le build est antérieur à 10731,
qbx_corene démarre pas du tout. - « ESX Multicharacter couldn't connect to the database » : la chaîne de connexion MySQL dans
server.cfgest incorrecte ou la base de données ne tourne pas. Corrigez la chaîne selon la documentation d'oxmysql et vérifiez que le service MariaDB est bien démarré. - « ESX = nil » : la solution de la documentation d'ESX consiste à mettre
es_extendedà jour vers la dernière version ; procurez-vous aussi les versions compatibles Legacy des scripts écrits pour d'anciennes versions d'ESX. - Qbox ne démarre pas avec MySQL ou XAMPP : c'est le comportement attendu. Qbox a besoin de
JSON_VALUE(),ADD COLUMN IF NOT EXISTSetCREATE INDEX IF NOT EXISTS; installez MariaDB 10.9.0 ou plus récent. - Un script QBCore provoque des erreurs sur Qbox : le script écrit très probablement directement dans les tables ou accède aux fichiers internes de qb-core. Demandez une version Qbox à son auteur ; pour le multijob, il vous faut une version qui utilise les exports de
qbx_core. - Votre propre système de notifications ne s'affiche pas sur Qbox : selon la FAQ, vous devez modifier
ox_libpour rediriger les événements de notification vers votre propre système. - La clé de licence n'est pas acceptée : au lieu de l'adresse Keymaster des anciens guides, créez la clé sur la page « Registration keys » du Cfx.re Portal et collez-la, sans espaces, dans le champ de licence du « Recipe Deployer ».
Questions fréquentes
ESX Legacy, est-ce la même chose que « l'ancien ESX » ?
Non. Legacy est la branche actuelle, maintenue dans le dépôt esx_core ; les scripts écrits pour d'anciennes versions d'ESX peuvent être incompatibles avec le cœur actuel. Pour une nouvelle installation, utilisez uniquement Legacy et procurez-vous les versions compatibles Legacy de vos scripts.
Qbox fait-il vraiment tourner mes scripts QBCore ?
La couche de compatibilité couvre les usages documentés de qb-core, y compris exports['qb-core']:GetCoreObject() ; c'est pourquoi la plupart des scripts fonctionnent sans retouche. Les scripts qui accèdent directement à la base de données, utilisent les fichiers internes de qb-core ou appellent des fonctions de manière incorrecte font exception. Testez d'abord sur un serveur de test.
Quelle base de données dois-je installer ?
MariaDB. Les documentations d'ESX et de Qbox écartent explicitement XAMPP, et Qbox ne prend pas non plus en charge MySQL. Installer MariaDB sous Windows et le gérer avec HeidiSQL, c'est la méthode décrite dans le guide officiel de QBCore.
Puis-je changer de framework plus tard ?
Oui, mais passer d'ESX à QBCore/Qbox (ou l'inverse) implique de reprendre de zéro les données des joueurs et les scripts. Le sens le moins pénible est le passage de QBCore à Qbox. Prenez donc la décision avant d'ouvrir le serveur, en vous basant sur la liste des scripts dont vous disposez.
Le choix du framework change-t-il le VDS dont j'ai besoin ?
Pas de manière notable ; les trois demandent de bonnes performances en monocœur, un disque NVMe et suffisamment de RAM. Les besoins en ressources dépendent surtout du nombre de joueurs et de la charge des scripts. Surveillez la consommation avec resmon et les graphiques d'utilisation en temps réel (CPU, RAM, disque, réseau) du panneau de gestion du VDS.
Guides associés
- Installer FXServer : un serveur FiveM de zéro (Windows et Linux)
- Comment installer QBCore : recette txAdmin, installation manuelle et premier admin
- Utiliser txAdmin : guide de gestion d'un serveur FiveM
- Optimiser un serveur FiveM : lire resmon et augmenter les FPS
- Tous les articles FiveM : guides FiveM
La documentation propre aux frameworks : le tutoriel d'installation d'ESX et la FAQ de Qbox ; pour QBCore, les guides d'installation Windows et Linux sur qbcore.org/docs.
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.