ESX è nil: correggere esx:getSharedObject in ESX Legacy

attempt to index a nil value (global 'ESX')? Il vecchio evento esx:getSharedObject è scomparso da ESX Legacy. Ecco la soluzione in una riga e cosa fare con gli script che non puoi modificare.

ESX è nil: correggere esx:getSharedObject in ESX Legacy

Avvii il tuo server, apri la console F8 ed ecco l'errore:

text
SCRIPT ERROR: @my_script/client/main.lua:12: attempt to index a nil value (global 'ESX')

O il corrispettivo lato server: attempt to index a nil value (upvalue 'ESX'). Lo script è perfetto, ESX è in esecuzione, eppure ESX è nil. È l'errore ESX più comune in assoluto, e ha quasi sempre la stessa causa.

Perché ESX è nil

Gli script ESX più vecchi ottengono l'oggetto ESX così:

lua
ESX = nil

TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)

Quell'evento era il modo in cui ESX 1.1 e 1.2 distribuivano il loro oggetto condiviso. ESX Legacy lo ha deprecato e le versioni attuali non rispondono più. Lo script attiva l'evento, nessuno lo gestisce, e ESX rimane nil fino a quando la prima riga che lo usa non causa un crash.

Lo vedrai soprattutto con script scritti anni fa o copiati da tutorial vecchi.

La soluzione: chiedi direttamente a es_extended

Sostituisci quelle righe con l'export che ESX Legacy fornisce:

lua
ESX = exports['es_extended']:getSharedObject()

Funziona allo stesso modo sul client e sul server. Fallo in ogni file che usa ESX. Se lo script ha anche un ciclo di attesa come questo, eliminalo; l'export risponde subito:

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)

Ancora più semplice: imports.lua

es_extended spedisce un piccolo file che configura ESX per te. Aggiungilo al fxmanifest.lua dello script:

lua
fx_version 'cerulean'
game 'gta5'
lua54 'yes'

shared_script '@es_extended/imports.lua'

client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }

Adesso ogni file client e server avrà un ESX globale, e sul client ESX.PlayerData si aggiornerà automaticamente quando il lavoro e i soldi del giocatore cambiano. Puoi eliminare completamente le righe getSharedObject.

Suggerimento: usa un approccio per script. O l'export in cima a ogni file, oppure imports.lua nel manifest; mescolare i due funziona, ma è ridondante.

Ancora nil? Controlla l'ordine di partenza

Se usi già l'export e ESX è ancora nil, oppure ricevi No such export getSharedObject in resource es_extended, lo script si avvia prima di es_extended. Il tuo server.cfg decide l'ordine:

cfg
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]

ensure my_script

Altre due cose da controllare nella console del server, dall'inizio:

  • es_extended si è avviato senza errori. Se fallisce (una mysql_connection_string sbagliata, oxmysql mancante), anche ogni script che dipende da esso fallisce.
  • La cartella si chiama veramente es_extended. Se rinominata o duplicata, il nome dell'export si rompe, e su Linux il nome distingue maiuscole da minuscole.

Esaminiamo questo errore in dettaglio in No such export getSharedObject in resource es_extended.

Dati del giocatore sul client

I vecchi script leggono il giocatore anche così:

lua
-- old
ESX.GetPlayerData()
RegisterNetEvent('esx:playerLoaded')
AddEventHandler('esx:playerLoaded', function(xPlayer) PlayerData = xPlayer end)

Continua a funzionare in ESX Legacy, con un dettaglio: aspetta che il giocatore sia caricato prima di leggere job o soldi all'avvio.

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)

Con imports.lua, ESX.PlayerData.job rimane sempre aggiornato.

Script che non puoi modificare

Se lo script è criptato e usa ancora il vecchio evento, non puoi cambiargli il codice. In ordine di preferenza:

  1. Chiedi un aggiornamento all'autore. Qualsiasi script ancora venduto per ESX dovrebbe usare l'export.
  2. Rispondi tu al vecchio evento da ESX. In es_extended, aggiungi questo a un file server e a uno client:
lua
AddEventHandler('esx:getSharedObject', function(cb)
    cb(ESX)
end)

Attenzione: è una patch a es_extended stesso. Aggiornare ESX la sovrascriverà, quindi dovrai aggiungerla di nuovo dopo ogni aggiornamento. Usalo come ripiego, non come soluzione.

Elenco di controllo rapido

Sintomo Soluzione
attempt to index a nil value (global 'ESX') Sostituisci TriggerEvent('esx:getSharedObject'…) con exports['es_extended']:getSharedObject()
Ancora nil dopo la modifica Avvia es_extended prima dello script in server.cfg
No such export getSharedObject es_extended non è avviato, ha fallito, o ha un nome diverso
ESX.PlayerData.job è nil all'avvio Aspetta ESX.IsPlayerLoaded() prima
Script criptato con il vecchio evento Chiedi all'autore; nel frattempo rispondi tu all'evento da es_extended

Risposte rapide

Perché ESX è nil nel mio script?

Lo script richiede ESX con la vecchia chiamata TriggerEvent('esx:getSharedObject'), alla quale l'attuale ESX Legacy non risponde più. Sostituiscila con ESX = exports['es_extended']:getSharedObject() oppure aggiungi shared_script '@es_extended/imports.lua' al fxmanifest.

Devo modificare sia i file client che quelli server?

Sì. Ogni file che usa ESX ha bisogno dell'oggetto, sul client e sul server. La riga imports.lua nel fxmanifest li copre tutti contemporaneamente.

Cosa fare se lo script è protetto e non posso modificarlo?

Chiedi prima un aggiornamento all'autore. Come ultima risorsa puoi rispondere al vecchio evento da es_extended, ma dovrai aggiungerlo di nuovo ogni volta che aggiorni ESX.

Script senza questo problema

Advanced BoostingBoosting di veicoli dal tablet: contratti dalla classe D alla S+, crew e coda in tempo reale.Vedi script →Item Creator V2Crea oggetti utilizzabili con animazioni, props, effetti e altro — senza scrivere codice.Vedi script →Shop CreatorCrea un negozio in meno di un minuto — proprietari, dipendenti, casseforti e rapine inclusi.Vedi script →

Continua a leggere