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.

ESX est nil : correction de esx:getSharedObject dans ESX Legacy

Vous démarrez votre serveur, ouvrez la console F8 et voilà :

text
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 :

lua
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 :

lua
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 :

lua
-- 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 :

lua
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.lua dans 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 :

cfg
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]

ensure my_script

Vé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 :

lua
-- 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.

lua
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 :

  1. Demandez une mise à jour à son auteur. Tout script encore vendu pour ESX devrait utiliser l'export.
  2. Répondez vous-même à l'ancien événement de ESX. Dans es_extended, ajoutez ceci à un fichier serveur et à un fichier client :
lua
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 →

À lire aussi