Comment installer ESX Legacy sur un serveur FiveM : recette et manuel

Vous voulez un serveur FiveM exécutant ESX Legacy, et vous voulez savoir quel moyen de l'installer. Il y a deux : une recette txAdmin, qui fait tout, et une installation manuelle, où vous placez chaque pièce vous-même. Ce guide couvre les deux, puis quoi vérifier lors de votre première connexion et les erreurs que vous êtes le plus susceptible de voir.

#Option 1 : la recette txAdmin

C'est l'itinéraire recommandé. Dans la configuration de txAdmin, choisissez le modèle ESX Legacy parmi les recettes populaires. Suivez les étapes dans configuration txAdmin et recettes : entrez votre clé de licence et vos identifiants de base de données, puis examinez le server.cfg généré et démarrez le serveur.

La recette télécharge es_extended et les core resources, oxmysql et ox_lib, crée la base de données et importe le fichier SQL ESX. Quand vous avez terminé, vous avez une base de travail. Allez à "Vérifications de première connexion".

#Option 2 : installation manuelle

Faites cela quand vous ajoutez ESX à un serveur que vous avez construit vous-même. Vous avez besoin d'un FXServer en cours d'exécution, d'une base de données MySQL ou MariaDB et d'une clé de licence.

#1. Téléchargez les resources

À partir des versions ESX Legacy, obtenez le pack central (es_extended et les core resources qu'il utilise, comme les resources d'identité, de menu et de notification). Mettez-les dans votre dossier resources, par exemple dans resources/[esx]. Vous avez également besoin de :

• oxmysql, la couche de base de données.
• ox_lib, une dépendance commune pour les resources ESX modernes.
• Un inventaire. De nombreux serveurs ESX Legacy utilisent ox_inventory. Suivez la documentation de la version que vous téléchargez, car la configuration par défaut peut changer entre les versions.

#2. Créez la base de données et importez le SQL

Créez une base de données vide, par exemple esx:

CREATE DATABASE esx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Ensuite, importez le fichier SQL qui est livré avec es_extended (cherchez un fichier .sql dans son dossier, nommé legacy.sql au moment de la rédaction). Utilisez HeidiSQL, phpMyAdmin ou la ligne de commande mysql. Sans cela, vous rencontrerez des erreurs table doesn't exist.

#3. Modifiez server.cfg

Définissez la chaîne de connexion et démarrez les resources dans un bon ordre :

set mysql_connection_string "mysql://user:password@localhost/esx?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_inventory
ensure [esx]
ensure [standalone]

L'ordre est expliqué dans ordre ensure server.cfg. Si vous utilisez les resources d'identité ou de multicaractère ESX, assurez-vous qu'une seule resource de sélection de personnage fonctionne.

#Vérifications de première connexion

Démarrez le serveur et lisez la console de haut en bas avant de rejoindre. Ensuite, vérifiez :

1. oxmysql se connecte. Il y a une ligne sur la connexion à la base de données et pas d'erreur rouge juste après.
2. es_extended démarre sans erreurs.
3. Vous pouvez rejoindre et atteindre la création de personnage ou le spawn.
4. Votre ligne de joueur existe. Après avoir rejoint, vous devriez voir une ligne pour vous dans la table users.
5. L'argent et l'emploi se chargent. Ouvrez votre inventaire ou exécutez une commande qui imprime votre compte et votre emploi.

Pour les droits d'administrateur, définissez votre group sur admin dans votre ligne users, puis rejoignez. Pour txAdmin et les commandes ACE, voir permissions ACE.

#Erreurs courantes de première connexion

ESX est nil dans un script. Une resource qui utilise toujours un ancien moyen d'obtenir ESX montre :

attempt to index a nil value (global 'ESX')

Le moyen moderne est ESX = exports['es_extended']:getSharedObject(). Voir ESX est nil : correction esx:getSharedObject et aucun export getSharedObject dans es_extended.

Impossible de se connecter à la base de données. La chaîne de connexion est mauvaise, la base de données ne fonctionne pas, ou l'utilisateur n'a pas de droits. Voir erreur de connexion oxmysql.

Une resource ne démarre pas. Souvent une dépendance manquante ou un mauvais nom de dossier. Voir could not find dependency et couldn't start resource.

Les joueurs bloqués sur le chargement. Regardez la console pour la resource qui a une erreur pendant la connexion. Voir joueurs bloqués sur l'écran de chargement.

Conseil : quand vous ajoutez un script, ajoutez-en un à la fois et redémarrez. Si une erreur apparaît, vous savez quel script l'a causée.

#Ajout d'emplois et d'articles

Une fois la base en place, les prochaines tâches sont les emplois et les articles. Ajouter un emploi sur ESX montre les lignes de base de données dont vous avez besoin. Pour les articles, la façon dépend de votre inventaire : voir ox_inventory ajouter des articles.

#Liste de contrôle