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.

Avvii il tuo server, apri la console F8 ed ecco l'errore:
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ì:
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:
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:
-- 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:
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.luanel 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:
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]
ensure my_scriptAltre due cose da controllare nella console del server, dall'inizio:
- es_extended si è avviato senza errori. Se fallisce (una
mysql_connection_stringsbagliata, 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ì:
-- 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.
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:
- Chiedi un aggiornamento all'autore. Qualsiasi script ancora venduto per ESX dovrebbe usare l'export.
- Rispondi tu al vecchio evento da ESX. In es_extended, aggiungi questo a un file server e a uno client:
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 →

