ESX est nil : correction de esx:getSharedObject dans ESX Legacy
attempt to index a nil value (global 'ESX') ? L'ancien événement esx:getSharedObject a disparu de ESX Legacy. Voici le correctif en une ligne et que faire avec les scripts que vous ne pouvez pas modifier.

Vous démarrez votre serveur, ouvrez la console F8 et voilà :
SCRIPT ERROR: @my_script/client/main.lua:12: attempt to index a nil value (global 'ESX')Ou son équivalent côté serveur, attempt to index a nil value (upvalue 'ESX'). Le script fonctionne correctement, ESX tourne, et pourtant ESX est nil. C'est l'erreur ESX la plus courante, et elle a presque toujours la même cause.
Pourquoi ESX est nil
Les anciens scripts ESX récupéraient l'objet ESX comme ceci :
ESX = nil
TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)Cet événement permettait à ESX 1.1 et 1.2 de distribuer leur objet partagé. ESX Legacy l'a déprécié et les versions actuelles n'y répondent plus. Le script déclenche l'événement, personne ne répond, et ESX reste nil jusqu'à ce que la première ligne qui l'utilise plante.
Vous verrez cela principalement avec des scripts écrits il y a des années ou copiés depuis des tutoriels anciens.
La solution : demandez es_extended directement
Remplacez ces lignes par l'export que fournit ESX Legacy :
ESX = exports['es_extended']:getSharedObject()Cela fonctionne de la même manière sur le client et sur le serveur. Faites-le dans chaque fichier qui utilise ESX. Si le script avait aussi une boucle d'attente comme celle-ci, supprimez-la ; l'export répond immédiatement :
-- old code: remove it
Citizen.CreateThread(function()
while ESX == nil do
TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)
Citizen.Wait(0)
end
end)Encore plus simple : imports.lua
es_extended fournit un petit fichier qui configure ESX pour vous. Ajoutez-le au fxmanifest.lua de votre script :
fx_version 'cerulean'
game 'gta5'
lua54 'yes'
shared_script '@es_extended/imports.lua'
client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }Maintenant chaque fichier client et serveur a un global ESX, et sur le client, ESX.PlayerData reste à jour au fur et à mesure que le métier et l'argent du joueur changent. Vous pouvez supprimer entièrement les lignes getSharedObject.
Astuce : utilisez une approche par script. Soit l'export en haut de chaque fichier, soit
imports.luadans le manifeste ; mélanger les deux fonctionne, mais c'est du bruit.
Toujours nil ? Vérifiez l'ordre de démarrage
Si vous utilisez déjà l'export et que ESX est toujours nil, ou que vous obtenez No such export getSharedObject in resource es_extended, le script démarre avant es_extended. Votre server.cfg décide l'ordre :
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]
ensure my_scriptVérifiez deux autres choses dans la console du serveur, tout en haut :
- es_extended a démarré sans erreur. S'il échoue (une mauvaise
mysql_connection_string, un oxmysql manquant), tous les scripts qui en dépendent échouent aussi. - Le dossier s'appelle vraiment
es_extended. Une copie renommée ou dupliquée casse le nom d'export, et sous Linux le nom est sensible à la casse.
Nous passons cette erreur en détail dans No such export getSharedObject in resource es_extended.
Données du joueur sur le client
Les anciens scripts lisaient aussi le joueur comme ceci :
-- old
ESX.GetPlayerData()
RegisterNetEvent('esx:playerLoaded')
AddEventHandler('esx:playerLoaded', function(xPlayer) PlayerData = xPlayer end)Cela fonctionne toujours dans ESX Legacy, avec un détail : attendez que le joueur soit chargé avant de lire le métier ou l'argent au démarrage.
CreateThread(function()
while not ESX.IsPlayerLoaded() do Wait(250) end
local job = ESX.GetPlayerData().job
print(('job: %s (%s)'):format(job.name, job.grade))
end)
RegisterNetEvent('esx:setJob', function(job)
-- the job changed: refresh whatever shows it
end)Avec imports.lua, ESX.PlayerData.job est tenu à jour pour vous.
Scripts que vous ne pouvez pas modifier
Si le script est escrowed (chiffré) et utilise toujours l'ancien événement, vous ne pouvez pas changer son code. Par ordre de préférence :
- Demandez une mise à jour à son auteur. Tout script encore vendu pour ESX devrait utiliser l'export.
- Répondez vous-même à l'ancien événement de ESX. Dans es_extended, ajoutez ceci à un fichier serveur et à un fichier client :
AddEventHandler('esx:getSharedObject', function(cb)
cb(ESX)
end)Attention : c'est un patch d'es_extended lui-même. Mettre à jour ESX l'écrase, donc vous devez le rajouter après chaque mise à jour. Gardez-le comme un correctif provisoire, pas comme la solution définitive.
Liste de contrôle rapide
| Symptôme | Correction |
|---|---|
attempt to index a nil value (global 'ESX') |
Remplacez TriggerEvent('esx:getSharedObject'…) par exports['es_extended']:getSharedObject() |
| Toujours nil après le changement | Démarrez es_extended avant le script dans server.cfg |
No such export getSharedObject |
es_extended n'a pas démarré, a échoué ou porte un nom différent |
ESX.PlayerData.job est nil au démarrage |
Attendez ESX.IsPlayerLoaded() en premier |
| Script escrowed avec l'ancien événement | Demandez à l'auteur ; en attendant, répondez l'événement depuis es_extended |
Réponses rapides
Pourquoi ESX est nil dans mon script ?
Le script demande ESX avec l'ancien appel TriggerEvent('esx:getSharedObject'), auquel le ESX Legacy actuel ne répond plus. Remplacez-le par ESX = exports['es_extended']:getSharedObject() ou ajoutez shared_script '@es_extended/imports.lua' au fxmanifest.
Dois-je modifier les fichiers client et serveur ?
Oui. Chaque fichier qui utilise ESX a besoin de l'objet, sur le client et sur le serveur. La ligne imports.lua du fxmanifest les couvre tous à la fois.
Que faire si le script est escrowed et que je ne peux pas le modifier ?
Demandez d'abord une mise à jour à son auteur. En dernier recours, vous pouvez répondre à l'ancien événement à partir de es_extended, mais vous devez le rajouter à chaque fois que vous mettez à jour ESX.
Des scripts sans ce problème
Advanced BoostingDu boosting de véhicules piloté par tablette : contrats de classe D à S+, crews et file d’attente en direct.Voir le script →
Item Creator V2Créez des items utilisables avec animations, props, effets et plus — sans écrire une ligne de code.Voir le script →
Shop CreatorCréez un magasin en moins d’une minute — propriétaires, employés, coffres et braquages inclus.Voir le script →

