Comment installer ESX ou QBCore sur votre serveur FiveM

ESX et QBCore sont les deux frameworks sur lesquels reposent la quasi-totalité des serveurs roleplay FiveM. Ils apportent les métiers, l'argent, l'inventaire et la couche de données partagée à laquelle les scripts se raccordent. Ce guide montre comment installer l'un ou l'autre sur un serveur FiveM DoomHosting, y compris la base MySQL dont ils ont tous les deux besoin et le bon ordre des ensure dans votre server.cfg.

ESX ou QBCore : quel framework choisir ?

Les deux sont gratuits, open source et adossés à MySQL. Le choix porte donc surtout sur l'écosystème sur lequel vous voulez construire :

• ESX est le plus ancien et le plus répandu. On trouve beaucoup plus de métiers, de scripts tiers et de tutoriels écrits pour lui, c'est donc le choix le plus sûr si vous comptez acheter ou télécharger beaucoup de ressources toutes faites.
• QBCore est plus récent, plus modulaire, et beaucoup de développeurs trouvent son code plus agréable à étendre. Si vous avez un scripteur dans l'équipe ou que vous voulez écrire beaucoup de logique maison, QBCore est très apprécié pour ça.

Vous ne pouvez pas faire tourner les deux en même temps. Choisissez-en un, construisez votre serveur autour et tenez-vous-y. Quel que soit votre choix, les étapes d'installation ont la même forme : créer une base, envoyer le framework, le brancher dans server.cfg.

Avant de commencer : clé de licence et base de données

Deux choses doivent être en place avant qu'un framework puisse se charger.

D'abord, votre serveur a besoin d'une clé de licence CFX valide, sinon FXServer ne démarre pas du tout. Le panneau vous la demande au premier appui sur Start. Si vous n'en avez pas encore, suivez d'abord comment obtenir une clé de licence FiveM.

Ensuite, ESX et QBCore stockent tout dans une base MySQL. Votre serveur FiveM DoomHosting en inclut une. Ouvrez l'onglet Bases de données du panneau et cliquez sur New database. Le panneau crée la base et vous affiche l'hôte, le nom de la base, l'utilisateur et le mot de passe. Gardez cet onglet ouvert, vous aurez besoin de ces quatre valeurs dans un instant.

Il n'y a pas de phpMyAdmin sur le serveur : pour importer le SQL d'un framework, vous vous connectez à ce même hôte depuis un client MySQL gratuit installé sur votre PC (HeidiSQL, DBeaver ou MySQL Workbench). Utilisez l'hôte, l'utilisateur et le mot de passe de l'onglet Bases de données, puis exécutez le fichier .sql du framework sur votre base.

Comment installer ESX sur un serveur FiveM ?

1. Téléchargez la dernière release d'ESX (la ressource es_extended) et oxmysql depuis leurs releases GitHub officielles.

2. Ouvrez l'onglet Fichiers, entrez dans le dossier resources et envoyez-y es_extended et oxmysql. C'est là que vivent toutes les ressources.

   

3. Importez le fichier SQL d'ESX dans votre base avec votre client MySQL (étape ci-dessus). Cela crée les tables users, jobs et les autres tables attendues par ESX.

4. Ouvrez server.cfg dans l'éditeur de fichiers et ajoutez la connexion à la base ainsi que les lignes ensure. L'ordre compte : oxmysql et es_extended doivent se charger avant tout ce qui en dépend.

   set mysql_connection_string "mysql://USER:PASSWORD@HOST/DATABASE?charset=utf8mb4"
   
   ensure oxmysql
   ensure es_extended
   

   

5. Redémarrez le serveur depuis le panneau. Surveillez l'onglet Console : vous devez voir oxmysql se connecter et es_extended démarrer sans erreur en rouge.

Comment installer QBCore sur un serveur FiveM ?

Les étapes reprennent celles d'ESX :

1. Téléchargez le framework QBCore (qb-core) et oxmysql depuis le GitHub officiel de QBCore.

2. Envoyez les deux dans le dossier resources via l'onglet Fichiers.

3. Importez le dump SQL de QBCore dans votre base avec votre client MySQL.

4. Dans server.cfg, renseignez la chaîne de connexion et placez oxmysql avant qb-core :

   set mysql_connection_string "mysql://USER:PASSWORD@HOST/DATABASE?charset=utf8mb4"
   
   ensure oxmysql
   ensure qb-core
   

5. Redémarrez et vérifiez dans la console que le démarrage est propre.

Dans quel ordre placer les ressources dans server.cfg ?

Les dépendances d'abord, ce qui en dépend ensuite. Une ressource qui interroge la base a besoin qu'oxmysql tourne déjà, un script de métier a besoin du framework déjà démarré. Un schéma sûr :

ensure oxmysql
ensure es_extended     # or qb-core
ensure your-inventory
ensure your-jobs
ensure your-other-scripts

Si vous faites un ensure sur une ressource de métier avant le framework, elle plante au démarrage parce que les exports du framework n'existent pas encore.

Comment devenir admin ?

Sur ESX, les groupes admin s'attribuent en base ou via une ressource de permissions, et la documentation du framework indique la table exacte. Sur QBCore, vous ajoutez votre identifiant license dans qb-core/shared/config.lua ou vous passez par les permissions en jeu. Le plus rapide pour trouver votre identifiant : rejoignez le serveur une fois, puis regardez l'onglet Console, où FXServer affiche votre identifiant license: au moment de la connexion. Copiez cette valeur dans la config admin du framework et redémarrez.

Erreurs fréquentes

• [oxmysql] failed to connect : la mysql_connection_string est incorrecte. Recopiez l'hôte, le nom de la base, l'utilisateur et le mot de passe depuis l'onglet Bases de données. Le nom de la base est le sNNN_name complet affiché là, pas seulement le nom court que vous avez saisi.
• Unable to load resource es_extended / qb-core : le nom du dossier dans resources ne correspond pas à la ligne ensure, ou vous avez dézippé un niveau trop profond (un dossier dans un dossier). Le dossier de la ressource doit contenir directement fxmanifest.lua.
• Le framework démarre mais aucune table n'existe : vous avez sauté l'import SQL, ou vous l'avez importé dans une autre base. Rejouez le .sql du framework sur exactement la base indiquée dans l'onglet Bases de données.
• Tout se charge mais les joueurs apparaissent sans argent ni métier : en général une dépendance manquante (une ressource d'inventaire ou un esx_*) ou un mauvais ordre de chargement. Lisez la console de haut en bas, la première ligne rouge est la vraie cause.

Pour aller plus loin

Une fois le framework en place, vous allez empiler par-dessus des véhicules, des métiers et des scripts. Voir comment ajouter des véhicules et des scripts personnalisés à votre serveur FiveM pour la structure des ressources et les véhicules streamés. Si vous préférez un tableau de bord web avec déploiement de recette en un clic, passez par l'installation de txAdmin sur votre serveur FiveM : txAdmin peut déployer une base ESX ou QBCore complète à votre place.

Il vous faut d'abord un serveur ? Voir l'hébergement de serveurs FiveM ou découvrez notre panneau de contrôle.