ESX et QBCore sur FiveM

ESX et QBCore sont les frameworks les plus utilisés sur FiveM pour les serveurs type roleplay (inventaire, jobs, comptes, véhicules, etc.). Ce guide décrit le choix du framework, l’installation (es_extended ou qb-core + bases), la configuration MySQL (oxmysql), le server.cfg et les dépendances. Pour la BDD : fivem-sql ; pour le serveur : fivem-windows-vps.

Prérequis

• Serveur FiveM opérationnel (fivem-windows-vps)
• MySQL ou MariaDB avec une base dédiée (fivem-sql)
• oxmysql installé et configuré (chaîne de connexion dans server.cfg)

ESX vs QBCore

• ESX : ancien, très répandu, beaucoup de jobs et scripts compatibles (esx_policejob, esx_ambulancejob, etc.). Structure es_extended + bases (esx_identity, esx_skin, etc.) + jobs.
• QBCore : plus récent, QB- (qb-core, qb-apartments, qb-policejob, etc.), structure différente (inventaire, métadonnées). Communauté et scripts en croissance.

Choisir selon vos scripts et mappings (certains sont ESX-only ou QBCore-only).

ESX : installation

1. es_extended

• Télécharger es_extended depuis GitHub esx-framework (ou fxserver-esx) : version legacy ou 1.9+ selon les scripts.
• Placer dans resources/[esx]/es_extended (ou resources/es_extended).
• Config : éditer config.lua (locale, langues, etc.) si besoin.

2. Bases ESX

Les bases fournissent : identité (nom, date de naissance), skin, license, etc. Exemples :

• esx_identity : création de personnage (nom, prénom, date de naissance).
• esx_skin : apparence (visage, vêtements).
• esx_license : gestion des permis (optionnel).
• esx_multicharacter : plusieurs personnages par compte.

Télécharger depuis le dépôt esx-framework ou les forks maintenus. Placer dans resources/[esx]/ et ensure dans l’ordre.

3. Import des tables MySQL

• es_extended fournit des .sql (dans le dossier sql/ ou à la racine). Les exécuter sur votre base :

mysql -u fivem_user -p fivem_db < sql/install.sql

(Adapter le chemin et la commande selon votre OS et l’emplacement des .sql.)

• Les bases (esx_identity, esx_skin, etc.) peuvent avoir leurs propres .sql ; les exécuter dans l’ordre recommandé par la doc.

4. server.cfg (ESX)

set mysql_connection_string "mysql://user:pass@localhost/fivem_db?charset=utf8mb4"
ensure oxmysql

ensure es_extended
ensure esx_identity
ensure esx_skin
# ensure esx_license
# ensure esx_multicharacter

# Jobs
ensure esx_policejob
ensure esx_ambulancejob
# ...

QBCore : installation

1. qb-core

• Télécharger qb-core depuis GitHub qbcore-framework.
• Placer dans resources/[qb]/qb-core (ou resources/qb-core).

2. Fichier de config et BDD

• qb-core/shared.lua (ou config.lua) : paramètres globaux, items, jobs. Adapter si besoin.
• qb-core utilise des tables MySQL. Exécuter les .sql fournis dans le dépôt (souvent qb-core.sql ou dans un dossier sql/).

3. Bases QBCore

• qb-apartments, qb-spawn, qb-multicharacter (ou qb-core intégré selon la version), qb-inventory, etc.
• Suivre la doc QBCore ou les README des dépôts pour l’ordre et les .sql.

4. server.cfg (QBCore)

set mysql_connection_string "mysql://user:pass@localhost/fivem_db?charset=utf8mb4"
ensure oxmysql

ensure qb-core
ensure qb-multicharacter
ensure qb-spawn
# ensure qb-apartments
# ensure qb-inventory  # selon la stack

# Jobs
# ensure qb-policejob
# ...

Dépendances

• oxmysql : obligatoire pour ESX et QBCore. fivem-sql.
• OneSync : recommandé (infinie ou on) pour les scripts avancés. enable-onesync : set onesync on.
• Mappings : fivem-mapping — s’assurer que les jobs (ex. esx_policejob) sont compatibles avec vos MLO.

Dépannage

Bonnes pratiques

• Sauvegarder la BDD avant des changements de structure (migrations, mises à jour de framework).
• OneSync : enable-onesync. Sécurité : ace-fivem. Mapping : fivem-mapping.

Ressources

• ESX – GitHub
• QBCore – Documentation
• QBCore – GitHub

Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.