Comment installer et configurer ESX sur FiveM

Installer ESX sur FiveM représente la première étape cruciale pour créer un serveur roleplay réussi en 2025. Ce framework open-source structure l’économie, les métiers et les interactions de votre univers GTA V multijoueur. Ce guide détaillé vous accompagne pas à pas dans la configuration complète d’ESX, des prérequis système jusqu’à la mise en production de votre serveur.

Comprendre ESX et ses avantages pour votre serveur FiveM

ESX, abréviation d’ES Extended, constitue le framework le plus populaire pour les serveurs FiveM roleplay. Développé par la communauté depuis 2017, il offre une base solide comprenant système bancaire, inventaire, métiers légaux et illégaux, ainsi qu’une gestion complète des joueurs.

Les avantages d’installer ESX sur FiveM sont multiples. Le framework propose une architecture modulaire permettant d’ajouter ou retirer des fonctionnalités selon vos besoins. Plus de 3000 ressources compatibles ESX existent dans la communauté, couvrant métiers de police, mécanicien, services médicaux, gangs, commerces et bien d’autres activités essentielles au roleplay.

Version Legacy versus ESX 1.2

Deux versions principales coexistent en 2025. ESX Legacy représente la branche moderne, régulièrement mise à jour, compatible avec les dernières versions de FiveM et utilisant oxmysql pour les requêtes base de données. ESX 1.2, version historique, reste fonctionnelle mais reçoit moins de support communautaire. Pour un nouveau serveur, ESX Legacy s’impose comme le choix recommandé.

La transition vers ESX Legacy apporte des performances améliorées de 40% selon les benchmarks communautaires, une compatibilité accrue avec les scripts modernes et une sécurité renforcée contre les exploits. L’architecture actualisée facilite également l’intégration de systèmes tiers comme Discord, sites web externes ou systèmes de billetterie.

Prérequis techniques pour installer ESX sur FiveM

Avant d’installer ESX sur votre serveur FiveM, plusieurs éléments techniques doivent être préparés. La configuration minimale et les logiciels nécessaires garantissent une installation fluide sans interruption.

Configuration serveur recommandée

Pour héberger un serveur performant sans souci technique, Location FiveM propose des solutions adaptées avec installation automatisée d’ESX et support francophone disponible 24/7.

Logiciels et outils indispensables

Votre système doit disposer de plusieurs programmes essentiels. MariaDB ou MySQL 8.0+ gère la base de données stockant comptes joueurs, inventaires et données économiques. Téléchargez la version stable depuis le site officiel mysql.com.

Un éditeur de texte avancé comme Visual Studio Code ou Notepad++ facilite la modification des fichiers de configuration. Ces éditeurs reconnaissent la syntaxe Lua utilisée par FiveM et détectent automatiquement les erreurs de code.

Le gestionnaire de base de données HeidiSQL ou phpMyAdmin simplifie l’importation des tables SQL et la gestion des données. HeidiSQL, gratuit et portable, s’installe en quelques minutes et se connecte directement à votre instance MySQL.

Compétences de base requises

Installer ESX sur FiveM nécessite des connaissances fondamentales. La compréhension de la navigation dans l’arborescence de fichiers Windows ou Linux, la capacité à éditer des fichiers de configuration et des notions basiques SQL pour importer les tables database constituent le socle minimum.

La lecture de documentation anglophone aide énormément, la majorité des ressources communautaires étant publiées dans cette langue. Une familiarité avec les commandes de console FiveM facilite également le débogage lors de la phase de test.

Installation pas à pas d’ESX Legacy sur FiveM

Cette section détaille chaque étape pour installer ESX sur FiveM, de la création de votre base de données jusqu’au démarrage du serveur. Suivez rigoureusement l’ordre des opérations pour éviter les erreurs de configuration.

Étape 1 : Télécharger ESX Legacy

Rendez-vous sur le dépôt GitHub officiel github.com/esx-framework/esx-legacy. Cliquez sur le bouton vert “Code” puis “Download ZIP” pour obtenir la dernière version stable. Décompressez l’archive dans un dossier temporaire accessible.

Le package téléchargé contient plusieurs dossiers essentiels : [core] regroupe les ressources fondamentales, [default] inclut les scripts de démarrage, et sql contient les fichiers de structure de base de données. Ne modifiez aucun fichier avant l’installation complète.

Étape 2 : Créer et configurer la base de données

Ouvrez HeidiSQL et créez une nouvelle connexion vers votre serveur MySQL. Créez une base de données nommée es_extended avec encodage utf8mb4_unicode_ci pour supporter tous les caractères spéciaux.

Importez les fichiers SQL dans l’ordre suivant :

• legacy.sql – Structure principale des tables ESX
• es_extended.sql – Configuration des métiers et données de base
• Fichiers SQL additionnels présents dans les sous-dossiers de ressources

Chaque importation doit s’exécuter sans erreur. Un message de succès confirme la création des tables. Vérifiez la présence des tables users, jobs, items et accounts dans la structure de votre base.

Étape 3 : Copier les ressources dans votre serveur FiveM

Localisez le dossier resources de votre installation FiveM serveur. Copiez l’intégralité des dossiers [core] et [default] d’ESX Legacy vers ce répertoire resources. La structure finale doit ressembler à :

server-data/
└── resources/
    ├── [core]/
    │   ├── es_extended/
    │   ├── oxmysql/
    │   └── spawnmanager/
    └── [default]/
        ├── esx_menu_default/
        ├── esx_context/
        └── skinchanger/

Étape 4 : Configurer server.cfg

Ouvrez le fichier server.cfg situé à la racine de votre serveur FiveM. Ajoutez les lignes suivantes dans l’ordre exact :

# Configuration MySQL
set mysql_connection_string "mysql://utilisateur:motdepasse@localhost/es_extended?charset=utf8mb4"

# Chargement des ressources ESX
ensure oxmysql
ensure es_extended

ensure esx_menu_default
ensure esx_context
ensure skinchanger
ensure esx_identity
ensure esx_datastore
ensure esx_addonaccount
ensure esx_addoninventory
ensure esx_society

# Métiers de base
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mecanojob

# Système économique
ensure esx_shops
ensure esx_vehicleshop
ensure esx_billing

Remplacez utilisateur, motdepasse et localhost par vos identifiants MySQL réels. La chaîne de connexion constitue l’élément le plus critique de la configuration. Une erreur ici empêche tout démarrage du framework.

Étape 5 : Premier démarrage et vérification

Lancez votre serveur FiveM via le fichier FXServer.exe ou la commande bash run.sh sous Linux. La console affiche le chargement progressif des ressources. Recherchez la ligne “ESX Legacy loaded successfully” confirmant l’initialisation correcte.

Connectez-vous à votre serveur avec votre client GTA V via FiveM. Au premier spawn, le système d’identité ESX vous demande de renseigner prénom, nom et date de naissance. Cette étape crée votre profil dans la base de données et valide le bon fonctionnement de la connexion MySQL.

Résolution des problèmes fréquents

Plusieurs erreurs classiques surviennent lors de l’installation d’ESX sur FiveM. Si la console affiche “Error loading ESX”, vérifiez la syntaxe de votre chaîne mysql_connection_string. Les espaces ou caractères spéciaux non échappés causent des échecs de connexion.

L’erreur “Table users doesn’t exist” indique une importation SQL incomplète. Reconnectez-vous à HeidiSQL et importez manuellement les fichiers manquants. Assurez-vous d’utiliser la base de données correcte lors de l’importation.

Des messages “Resource esx_xxx failed to start” signalent des dépendances manquantes. ESX Legacy requiert oxmysql, spawnmanager et sessionmanager démarrés avant es_extended. Respectez l’ordre défini dans le server.cfg.

Configuration avancée et optimisation d’ESX

Après avoir réussi l’installation de base, plusieurs réglages affinent les performances et la sécurité de votre serveur FiveM équipé d’ESX. Ces optimisations transforment une installation standard en environnement roleplay professionnel.

Personnalisation du fichier config.lua

Le fichier config.lua d’es_extended contient les paramètres fondamentaux du framework. Localisez-le dans resources/[core]/es_extended/config.lua et ajustez les valeurs suivantes :

Config.Locale = 'fr'  -- Interface en français
Config.Accounts = {'bank', 'black_money', 'money'}
Config.StartingAccountMoney = {bank = 5000, money = 1000}
Config.StartingSalary = 25
Config.EnableSocietyPayouts = true
Config.MaxWeight = 30  -- Poids maximum inventaire
Config.PaycheckInterval = 7 * 60000  -- Salaire toutes les 7 minutes

La valeur MaxWeight définit la capacité d’inventaire des joueurs. Un poids de 30 représente environ 15 items standards, équilibrant réalisme et jouabilité. Ajustez selon la densité d’items de votre économie.

L’intervalle PaycheckInterval contrôle la fréquence des salaires automatiques. Sept minutes temps réel simule une journée de travail, maintenant l’immersion sans surcharger l’économie. Surveillez l’inflation après quelques semaines d’activité.

Ajout de métiers personnalisés

ESX permet la création de métiers uniques via des insertions SQL directes. Connectez-vous à votre base de données et exécutez cette requête pour ajouter un métier de pêcheur :

INSERT INTO `jobs` (name, label, whitelisted) VALUES 
('fisherman', 'Pêcheur', 0);

INSERT INTO `job_grades` (job_name, grade, name, label, salary) VALUES 
('fisherman', 0, 'recruit', 'Recrue', 200),
('fisherman', 1, 'experienced', 'Expérimenté', 400),
('fisherman', 2, 'boss', 'Patron', 600);

Chaque métier nécessite ensuite un script spécifique gérant les interactions, points de vente et mécaniques de gameplay. La communauté FiveM partage des centaines de jobs gratuits sur les forums cfx.re et GitHub.

Sécurisation de votre installation ESX

La sécurité d’un serveur FiveM avec ESX repose sur plusieurs pratiques essentielles. Modifiez le fichier es_extended/server/main.lua pour ajouter des vérifications anti-triche sur les événements sensibles :

• Validez côté serveur toutes les transactions financières
• Limitez les appels aux événements esx:giveInventoryItem
• Journalisez les actions administrateurs dans un fichier séparé
• Installez un anticheat comme EasyAdmin ou txAdmin

L’interface txAdmin simplifie la gestion quotidienne avec panneau web, sauvegarde automatique et détection d’exploits intégrée. Compatible nativement avec ESX Legacy, cet outil gratuit devient indispensable dès 10 joueurs simultanés.

Optimisation des performances serveur

Un serveur FiveM avec ESX bien configuré maintient 50ms de latency avec 64 joueurs connectés. Plusieurs ajustements techniques atteignent ces performances. Dans le server.cfg, définissez :

sv_maxclients 64
sv_enforceGameBuild 2699  # Build GTA V optimisé
set mysql_slow_query_warning 100  # Alerte requêtes lentes
onesync on  # Synchronisation améliorée

Activez OneSync pour supporter plus de 32 joueurs avec synchronisation entités améliorée. Cette fonctionnalité native FiveM élimine les bugs de disparition de véhicules ou PNJ observés en mode legacy.

Utilisez un monitoring via resmon pour identifier les ressources gourmandes. Les scripts mal codés consomment parfois 0.5ms par tick, multipliant les ralentissements. Remplacez systématiquement les ressources dépassant 0.2ms par des alternatives optimisées disponibles sur GitHub.

Intégration Discord et systèmes externes

La connexion Discord enrichit l’expérience roleplay avec whitelist automatique, logs d’actions et rôles synchronisés. Le script discord-screenshot capture automatiquement les situations litigieuses, facilitant la modération.

Pour lier votre serveur ESX à Discord, installez la ressource discordrp et configurez le fichier config avec votre webhook URL. Les événements ESX déclenchent des notifications : mort de joueur, transaction importante, prise de service métier, etc.

L’API es_extended expose des endpoints REST permettant l’affichage de statistiques sur site web externe. Nombre de joueurs connectés, classement richesse, galerie photos personnages s’intègrent facilement via requêtes HTTP sécurisées.

Ressources complémentaires et écosystème ESX

Après avoir installé ESX sur FiveM, l’enrichissement de votre serveur passe par l’ajout de ressources communautaires. L’écosystème ESX compte des milliers de scripts gratuits et payants couvrant tous les aspects du roleplay.

Ressources indispensables pour débuter

Plusieurs scripts fondamentaux complètent l’installation de base. esx_clotheshop gère les magasins de vêtements avec inventaire personnalisé par boutique. esx_property active l’achat de maisons et appartements avec système de stockage et invitations.

Le garage esx_advancedgarage remplace le système basique par interface moderne, catégorisation véhicules et garages répartis géographiquement. Les joueurs récupèrent leurs véhicules uniquement dans le garage de dépôt, ajoutant réalisme logistique.

Pour l’interaction criminelle, esx_drugs implémente culture, transformation et vente de stupéfiants avec système de plants, laboratoires et points de deal. Le script s’intègre nativement avec le métier police ESX pour missions d’intervention.

Où trouver des ressources ESX de qualité

Le forum officiel forum.cfx.re section “Releases” publie quotidiennement nouveaux scripts. Filtrez par tag “ESX” et vérifiez la dernière mise à jour. Les ressources abandonnées depuis plus d’un an posent souvent des problèmes de compatibilité.

GitHub héberge les projets open-source majeurs. Recherchez “esx legacy resources” pour découvrir collections maintenues. Les dépôts avec plus de 100 étoiles et commits récents garantissent généralement qualité et support communautaire actif.

Les marketplaces comme Tebex proposent ressources premium développées professionnellement. Budget entre 5€ et 50€ par script selon complexité. Les ressources payantes incluent support, mises à jour et fonctionnalités avancées introuvables gratuitement.

Bonnes pratiques d’ajout de ressources

Testez toujours sur serveur de développement séparé avant production. Créez une copie de votre base de données et serveur FiveM, ajoutez la nouvelle ressource, vérifiez l’absence d’erreurs console et conflits avec scripts existants.

Lisez intégralement le README.md de chaque ressource. Les dépendances obligatoires, instructions SQL spécifiques et paramètres de configuration varient significativement. Une étape manquée compromet le fonctionnement entier.

Documentez vos ajouts dans un fichier MODIFICATIONS.txt. Notez date installation, version, URL source et modifications effectuées. Cette documentation facilite diagnostic lors de bugs futurs et simplification mises à jour framework.

Après avoir correctement installé ESX sur FiveM et enrichi votre serveur de ressources essentielles, votre univers roleplay prend vie. L’engagement communautaire et la qualité d’administration déterminent désormais le succès de votre projet.

En conclusion, installer ESX sur FiveM représente un processus structuré accessible aux débutants méthodiques. De la préparation base de données à la configuration avancée, chaque étape construit les fondations d’un serveur roleplay performant. ESX Legacy en 2025 offre stabilité, compatibilité et écosystème riche permettant de concrétiser toutes vos ambitions de gameplay. Le support communautaire actif et les ressources abondantes garantissent l’évolution continue de votre serveur selon les retours joueurs et tendances roleplay émergentes.

FAQ