Installer et configurer ESX ou QBCore sur votre serveur FiveM

Avant de commencer

Installer ESX ou QBCore consiste à déployer la base technique de votre serveur FiveM RP : gestion des personnages, argent, métiers, inventaire et nombreuses ressources indispensables. Pour éviter les fichiers manquants et les erreurs de base de données, la méthode recommandée consiste à utiliser une recipe txAdmin officielle.

Avant de commencer, vérifiez que vous disposez :

• d’un serveur FiveM fonctionnel ;
• d’un accès à txAdmin ;
• d’une clé de licence Cfx.re valide ;
• d’une base de données MySQL ou MariaDB ;
• des identifiants de connexion à cette base ;
• d’un framework choisi entre ESX et QBCore.

Si txAdmin n’est pas encore configuré, suivez d’abord le guide pour démarrer avec txAdmin.

ESX et QBCore répondent à des logiques différentes. Évitez de choisir uniquement en fonction d’un script repéré sur Internet : l’écosystème, la structure des ressources et les habitudes de développement comptent aussi. Consultez le comparatif ESX ou QBCore : quel framework choisir ? avant le déploiement.

ESX et QBCore ne doivent pas être installés ensemble dans la même base. Un script prévu pour ESX n’est pas automatiquement compatible avec QBCore, et inversement.

Avant une réinstallation, des sauvegardes automatiques sont incluses pour vous aider à restaurer. Conservez aussi vos propres exports réguliers : vous restez responsable de vos données.

Installer ESX ou QBCore avec une recipe txAdmin

Une recipe txAdmin est un fichier de déploiement automatisé. Elle indique au panel quels fichiers télécharger, où placer les ressources, comment préparer server.cfg et quels fichiers SQL importer dans la base de données.

Depuis l’assistant de configuration txAdmin :

1. ouvrez le Recipe Deployer ;
2. sélectionnez une recipe recommandée ;
3. choisissez ESX Legacy ou QBCore Framework ;
4. renseignez le nom du serveur ;
5. indiquez votre clé de licence Cfx.re ;
6. saisissez les informations de la base de données ;
7. vérifiez les ports et le nombre de slots ;
8. lancez le déploiement.

Les intitulés peuvent légèrement varier selon la version de txAdmin ou l’intégration du panel TalCloud. Utilisez de préférence la recipe officielle présentée dans la liste recommandée, plutôt qu’un pack récupéré sur un site de republication.

Une recipe complète peut automatiquement :

• télécharger les ressources Cfx.re de base ;
• installer le cœur du framework ;
• récupérer les ressources RP initiales ;
• installer le connecteur MySQL ;
• créer ou importer les tables SQL ;
• générer un fichier server.cfg ;
• configurer les principales lignes ensure.

Le déploiement peut demander plusieurs minutes, car txAdmin télécharge de nombreux dépôts et prépare leur arborescence.

Ne fermez pas la page et ne redémarrez pas FXServer pendant l’exécution de la recipe. Une interruption peut laisser une installation incomplète.

Lorsque le déploiement est terminé, vérifiez que txAdmin a bien créé au minimum :

server.cfg
resources/

Comprendre la base de données ESX ou QBCore

ESX et QBCore utilisent une base MySQL ou MariaDB pour conserver les données persistantes du serveur.

Elle peut contenir notamment :

• les personnages ;
• l’argent et les comptes bancaires ;
• les métiers ;
• les véhicules possédés ;
• les logements ;
• les inventaires ;
• les licences et autres informations RP.

Les scripts communiquent généralement avec la base à travers une ressource comme oxmysql. La connexion est définie dans server.cfg avec une chaîne proche de celle-ci :

set mysql_connection_string "mysql://utilisateur:mot_de_passe@hote:3306/nom_de_la_base?charset=utf8mb4"

Chaque valeur doit correspondre aux identifiants fournis pour votre base :

utilisateur      = compte MySQL
mot_de_passe     = mot de passe MySQL
hote             = adresse du serveur de base de données
3306             = port MySQL habituel
nom_de_la_base   = base utilisée par FiveM

Évitez d’utiliser un compte administrateur global lorsque vous pouvez créer un utilisateur dédié à la base FiveM.

La recipe importe également un ou plusieurs fichiers .sql. Ces fichiers créent les tables attendues par le framework. Pour QBCore, vous trouverez par exemple des tables consacrées aux joueurs, aux appartements ou aux véhicules. ESX crée ses propres tables pour les utilisateurs, métiers, objets et autres composants.

N’importez pas plusieurs fois un fichier SQL sans vérifier son contenu. Vous pourriez provoquer des erreurs de doublon ou réinitialiser certaines données.

Après le déploiement, ne partagez jamais publiquement la chaîne de connexion. Elle contient des informations sensibles permettant d’accéder à la base.

Comprendre la structure du dossier resources/

Toutes les ressources FiveM sont installées dans :

resources/

Les dossiers entourés de crochets servent à organiser les scripts par catégorie. Ils ne représentent pas une ressource à eux seuls.

Une installation ESX peut ressembler à ceci :

resources/
├── [cfx-default]/
├── [core]/
│   ├── es_extended/
│   ├── esx_identity/
│   └── esx_multicharacter/
├── [esx_addons]/
├── [standalone]/
│   ├── oxmysql/
│   └── pma-voice/
└── [local]/

Une installation QBCore peut suivre cette organisation :

resources/
├── [cfx-default]/
├── [qb]/
│   ├── qb-core/
│   ├── qb-inventory/
│   ├── qb-multicharacter/
│   └── qb-spawn/
├── [standalone]/
│   └── oxmysql/
├── [voice]/
└── [local]/

Le contenu exact dépend de la version de la recipe. Vous pouvez créer un dossier [local] pour vos propres scripts :

resources/
└── [local]/
    ├── mon_job/
    ├── mon_mapping/
    └── mon_script/

Chaque ressource doit contenir un manifeste valide, généralement :

fxmanifest.lua

Évitez les dossiers imbriqués accidentellement :

resources/[local]/mon_script/mon_script/fxmanifest.lua

Le manifeste doit se trouver directement dans le dossier déclaré comme ressource :

resources/[local]/mon_script/fxmanifest.lua

Configurer l’ordre de démarrage dans server.cfg

Le fichier server.cfg contient les réglages généraux du serveur et la liste des ressources à démarrer.

La commande ensure démarre une ressource si elle est arrêtée et la redémarre si elle fonctionne déjà.

Exemple simplifié pour ESX :

ensure oxmysql
ensure [core]
ensure [standalone]
ensure [esx_addons]
ensure [local]

Exemple simplifié pour QBCore :

ensure oxmysql
ensure qb-core
ensure [qb]
ensure [standalone]
ensure [voice]
ensure [local]

L’ordre est important :

1. le connecteur de base de données démarre ;
2. le cœur ESX ou QBCore se charge ;
3. les dépendances communes démarrent ;
4. les scripts dépendants sont exécutés.

Un script QBCore utilisant qb-core ne doit pas être lancé avant le framework. De même, une ressource ESX nécessitant es_extended doit démarrer après celui-ci.

Pour ajouter une ressource isolée :

ensure mon_script

Pour la désactiver temporairement, commentez ou retirez la ligne :

# ensure mon_script

Vous pouvez aussi démarrer toutes les ressources d’une catégorie :

ensure [local]

Ne renommez pas arbitrairement une ressource. Certains scripts utilisent son nom exact pour effectuer des exports ou vérifier leurs dépendances.

Effectuer le premier lancement et les vérifications

Démarrez le serveur depuis txAdmin, puis ouvrez la console en direct. Le premier lancement peut être plus long, car les ressources initialisent leurs fichiers et vérifient la structure de la base.

Surveillez particulièrement les messages contenant :

SCRIPT ERROR

Couldn't start resource

Access denied for user

Unknown database

No such export

Couldn't find dependency

Une erreur Access denied for user indique généralement des identifiants MySQL incorrects. Unknown database signifie que le nom de la base n’existe pas ou ne correspond pas à la configuration. Une dépendance introuvable signale souvent un dossier absent ou un mauvais ordre dans server.cfg.

Connectez-vous ensuite au serveur et vérifiez :

• la création du personnage ;
• l’apparition correcte sur la carte ;
• l’affichage de l’argent ;
• l’ouverture de l’inventaire ;
• le fonctionnement des métiers de base ;
• la sauvegarde après une déconnexion.

Après avoir créé un personnage, quittez le serveur puis reconnectez-vous. Les données doivent être restaurées depuis MySQL. Si le personnage disparaît, contrôlez la console et la chaîne de connexion.

Ajouter vos premiers scripts ESX ou QBCore

Une fois la base stable, vous pouvez ajouter des scripts compatibles avec votre framework.

Avant tout téléchargement, vérifiez :

• le framework demandé ;
• sa version minimale ;
• les dépendances ;
• le connecteur SQL attendu ;
• le fichier .sql éventuel ;
• les modifications à apporter à server.cfg.

La procédure générale est la suivante :

1. arrêtez le serveur ;
2. décompressez la ressource ;
3. placez-la dans resources/[local]/ ;
4. importez son fichier SQL s’il existe ;
5. ajoutez sa ligne ensure ;
6. vérifiez sa configuration ;
7. redémarrez le serveur ;
8. lisez les erreurs éventuelles dans la console.

Exemple :

resources/
└── [local]/
    └── exemple_job/
        ├── client/
        ├── server/
        ├── config.lua
        └── fxmanifest.lua

Puis dans server.cfg :

ensure exemple_job

Installez les scripts un par un. Cette méthode permet d’identifier immédiatement la ressource responsable si une erreur apparaît.

En résumé

• Pour installer ESX ou QBCore, préparez txAdmin, une clé Cfx.re et une base MySQL ou MariaDB.
• Choisissez votre framework avant le déploiement : les scripts ESX et QBCore ne sont pas interchangeables.
• Utilisez la recipe officielle proposée par le Recipe Deployer de txAdmin.
• Renseignez correctement l’hôte, le port, l’utilisateur, le mot de passe et le nom de la base.
• Vérifiez que oxmysql démarre avant le cœur du framework.
• Rangez les ressources dans les catégories [core], [esx_addons], [qb], [standalone] ou [local].
• Utilisez ensure nom_de_la_ressource dans server.cfg pour démarrer un script.
• Respectez l’ordre des dépendances dans la configuration.
• Contrôlez la console, la création du personnage, l’inventaire et la sauvegarde MySQL au premier lancement.
• Ajoutez ensuite les scripts un par un pour faciliter le dépannage.
• Pour installer ESX ou QBCore sur une infrastructure hébergée en France avec stockage NVMe, panel de gestion, Anti-DDoS L3/L4/L7 inclus et support francophone, consultez l’offre serveur FiveM TalCloud.