ESX ist nil: Behebung von esx:getSharedObject in ESX Legacy
attempt to index a nil value (global 'ESX')? Das alte esx:getSharedObject-Ereignis ist in ESX Legacy nicht mehr vorhanden. Hier ist die einzeilige Lösung und was du mit Skripten tun kannst, die du nicht bearbeiten kannst.

Du startest deinen Server, öffnest die F8-Konsole und da ist es:
SCRIPT ERROR: @my_script/client/main.lua:12: attempt to index a nil value (global 'ESX')Oder das serverseitige Pendant, attempt to index a nil value (upvalue 'ESX'). Das Skript ist in Ordnung, ESX läuft, und dennoch ist ESX nil. Dies ist der häufigste ESX-Fehler überhaupt und hat fast immer die gleiche Ursache.
Warum ESX nil
Ältere ESX-Skripte erhalten das ESX-Objekt so:
ESX = nil
TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)Dieses Ereignis war wie ESX 1.1 und 1.2 sein gemeinsames Objekt verteilten. ESX Legacy hat es als veraltet markiert, und aktuelle Versionen antworten nicht mehr darauf. Das Skript löst das Ereignis aus, niemand antwortet, und ESX bleibt nil, bis die erste Zeile, die es verwendet, abstürzt.
Du wirst dies meist bei Skripten sehen, die vor Jahren geschrieben oder aus alten Tutorials kopiert wurden.
Die Lösung: Frag es_extended direkt
Ersetze diese Zeilen durch den Export, den ESX Legacy bereitstellt:
ESX = exports['es_extended']:getSharedObject()Es funktioniert auf dem Client und auf dem Server gleich. Mache es in jeder Datei, die ESX verwendet. Wenn das Skript auch eine Warteschleife wie diese hatte, lösche sie; der Export antwortet sofort:
-- old code: remove it
Citizen.CreateThread(function()
while ESX == nil do
TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)
Citizen.Wait(0)
end
end)Noch einfacher: imports.lua
es_extended liefert eine kleine Datei mit, die ESX für dich einrichtet. Füge sie zu fxmanifest.lua des Skripts hinzu:
fx_version 'cerulean'
game 'gta5'
lua54 'yes'
shared_script '@es_extended/imports.lua'
client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }Jetzt hat jede Client- und Server-Datei ein globales ESX, und auf dem Client bleibt ESX.PlayerData aktuell, wenn sich der Job und das Geld des Spielers ändern. Du kannst die getSharedObject-Zeilen komplett löschen.
Tipp: Verwende einen Ansatz pro Skript. Entweder den Export oben in jeder Datei oder
imports.luaim Manifest; beide zu mischen funktioniert, aber es ist störend.
Immer noch nil? Überprüfe die Startreihenfolge
Wenn du bereits den Export nutzt und ESX ist immer noch nil, oder du bekommst No such export getSharedObject in resource es_extended, startet das Skript vor es_extended. Deine server.cfg entscheidet über die Reihenfolge:
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]
ensure my_scriptZwei weitere Dinge, die du in der Serverkonsole überprüfen kannst, von ganz oben:
- es_extended hat ohne Fehler gestartet. Wenn es fehlschlägt (eine fehlerhafte
mysql_connection_string, ein fehlendes oxmysql), schlägt auch jedes davon abhängige Skript fehl. - Der Ordner heißt wirklich
es_extended. Ein umbenannter oder duplizierter Kopie bricht den Exportnamen, und auf Linux ist der Name case-sensitiv.
Wir gehen auf diesen Fehler ausführlich unter No such export getSharedObject in resource es_extended ein.
Spielerdaten auf dem Client
Alte Skripte lesen den Spieler auch so:
-- old
ESX.GetPlayerData()
RegisterNetEvent('esx:playerLoaded')
AddEventHandler('esx:playerLoaded', function(xPlayer) PlayerData = xPlayer end)Das funktioniert immer noch in ESX Legacy, mit einem Detail: Warte, bis der Spieler geladen ist, bevor du beim Start Job oder Geld liest.
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)Mit imports.lua wird ESX.PlayerData.job für dich aktuell gehalten.
Skripte, die du nicht bearbeiten kannst
Wenn das Skript treuhänderisch (verschlüsselt) ist und immer noch das alte Ereignis verwendet, kannst du seinen Code nicht ändern. Der Reihenfolge nach:
- Bitte den Autor um ein Update. Jedes Skript, das noch für ESX verkauft wird, sollte den Export verwenden.
- Beantworte das alte Ereignis selbst von ESX. Füge dies in es_extended zu einer Serverdatei und einer Clientdatei hinzu:
AddEventHandler('esx:getSharedObject', function(cb)
cb(ESX)
end)Achtung: Dies ist ein Patch für es_extended selbst. Das Aktualisieren von ESX überschreibt es, also musst du es nach jedem Update erneut hinzufügen. Behalte es als Übergangslösung, nicht als Lösung.
Schnelle Checkliste
| Symptom | Behebung |
|---|---|
attempt to index a nil value (global 'ESX') |
Ersetze TriggerEvent('esx:getSharedObject'…) durch exports['es_extended']:getSharedObject() |
| Immer noch nil nach der Änderung | Starte es_extended vor dem Skript in server.cfg |
No such export getSharedObject |
es_extended wurde nicht gestartet, ist fehlgeschlagen oder hat einen anderen Namen |
ESX.PlayerData.job ist beim Start nil |
Warte zuerst auf ESX.IsPlayerLoaded() |
| Treuhänderisches Skript mit dem alten Ereignis | Bitte den Autor; beantworte in der Zwischenzeit das Ereignis von es_extended |
Kurze Antworten
Warum ist ESX nil in meinem Skript?
Das Skript fordert ESX mit dem alten TriggerEvent('esx:getSharedObject')-Aufruf an, auf den das aktuelle ESX Legacy nicht mehr antwortet. Ersetze es mit ESX = exports['es_extended']:getSharedObject() oder füge shared_script '@es_extended/imports.lua' zur fxmanifest hinzu.
Muss ich sowohl Client- als auch Server-Dateien ändern?
Ja. Jede Datei, die ESX verwendet, benötigt das Objekt, sowohl auf Client als auch auf dem Server. Die imports.lua-Zeile in der fxmanifest deckt alle auf einmal ab.
Was ist, wenn das Skript verschlüsselt ist und ich es nicht bearbeiten kann?
Bitte den Autor zuerst um ein Update. Notfalls kannst du das alte Ereignis aus es_extended beantworten, musst es aber jedes Mal hinzufügen, wenn du ESX aktualisierst.
Scripts ohne dieses Problem
Advanced BoostingFahrzeug-Boosting per Tablet: Aufträge von Klasse D bis S+, Crews und eine Live-Warteschlange.Script ansehen →
Item Creator V2Erstelle nutzbare Items mit Animationen, Props, Effekten und mehr — ganz ohne Code.Script ansehen →
Shop CreatorBau einen Shop in unter einer Minute — Besitzer, Angestellte, Tresore und Überfälle inklusive.Script ansehen →

