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.

ESX ist nil: Behebung von esx:getSharedObject in ESX Legacy

Du startest deinen Server, öffnest die F8-Konsole und da ist es:

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

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

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

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)

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:

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

cfg
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]

ensure my_script

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

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

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)

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:

  1. Bitte den Autor um ein Update. Jedes Skript, das noch für ESX verkauft wird, sollte den Export verwenden.
  2. Beantworte das alte Ereignis selbst von ESX. Füge dies in es_extended zu einer Serverdatei und einer Clientdatei hinzu:
lua
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 →

Weiterlesen