Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

FiveM

ESX, QBCore ou Qbox : quel framework choisir pour FiveM ?

26 août 2026 13 min de lecture Mis à jour :
Partager cet article

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 oxmysql et 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_core exige le build FXServer (artifact) 10731 ou 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èreESX LegacyQBCoreQbox
Ressource principale / versiones_extended 1.16.0qb-core 1.3.0qbx_core 1.24.0
Dépendances obligatoiresesx_lib, oxmysqloxmysqlox_lib, oxmysql, artifact ≥ 10731, OneSync
Base de donnéesCompatible MySQL ; MariaDB recommandé, pas de XAMPPMariaDB + HeidiSQL (guide Windows officiel)Uniquement MariaDB ≥ 10.9.0 (12.3 LTS recommandée)
LicenceGPL-3.0GPL-3.0GPL-3 (fichier LICENSE du dépôt)
Communauté et anciennetéLe plus ancien des trois ; l'historique de forum le plus longLarge et active ; vaste écosystème qb-Le plus jeune ; issu de QBCore, étroitement lié à l'écosystème ox
Écosystème de scriptsDé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 incompatiblesTrès vaste ; plus de 50 ressources qb- dans la documentation officielleSes propres ressources qbx_ + la plupart des scripts QBCore via le bridge
PerformancesAucun benchmark comparatif officiel ; la charge dépend des scripts que vous ajoutezAucun benchmark comparatif officiel ; la charge dépend des scripts que vous ajoutezRefondu pour les performances selon la FAQ ; les ressources converties pour Qbox consomment moins de mémoire
Courbe d'apprentissageFaible ; c'est ici qu'on trouve le plus d'exemples et de tutorielsMoyenne ; 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)AbondantesAbondantesRares ; documentation et Discord surtout en anglais
Les scripts QBCore fonctionnent-ils ?Non, il n'y a pas de bridgeOuiOui 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 :

SensDifficultéRaison
ESX → QBCoreÉlevéeLes 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éeMême raison ; il n'existe de bridge officiel dans aucun des deux sens.
QBCore → QboxFaible à moyenneLa 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 → QBCoreMoyenne à élevéeLes 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éeLe 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églageESX LegacyQBCoreQbox
Recette txAdminESX LegacyQBCore FrameworkQBox Framework
Build FXServerDernier build ; le build « recommended » peut provoquer des erreursPas de minimum dans le manifesteAu moins 10731, OneSync activé
Base de données (exemple)localhost, port 3306, nom esx_legacylocalhost, port 3306, nom de votre choixIdentique ; le serveur doit faire tourner MariaDB 10.9.0 ou plus récent
Premier démarrageAucune étape supplémentaire dans la documentationAttendez la fin de yarn installLes 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_core ne démarre pas du tout.
  • « ESX Multicharacter couldn't connect to the database » : la chaîne de connexion MySQL dans server.cfg est 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 EXISTS et CREATE 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_lib pour 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

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.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.