ESX to nil: naprawianie esx:getSharedObject w ESX Legacy
attempt to index a nil value (global 'ESX')? Stare zdarzenie esx:getSharedObject zniknęło z ESX Legacy. Oto jednowierszowa poprawka i co zrobić ze skryptami, których nie można edytować.

Uruchamiasz serwer, otwierasz konsolę F8 i widzisz:
SCRIPT ERROR: @my_script/client/main.lua:12: attempt to index a nil value (global 'ESX')Lub jego bliźniaczkę po stronie serwera, attempt to index a nil value (upvalue 'ESX'). Skrypt jest w porządku, ESX działa, a ESX nadal wynosi nil. To najczęstszy błąd ESX, który prawie zawsze ma tę samą przyczynę.
Dlaczego ESX to nil
Starsze skrypty ESX pobierały obiekt ESX w taki sposób:
ESX = nil
TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)To zdarzenie było sposobem, w jaki ESX 1.1 i 1.2 przekazywały swój wspólny obiekt. ESX Legacy to przestarzałe, a obecne wersje na to nie odpowiadają. Skrypt wyzwala zdarzenie, nikt nie odpowiada, a ESX pozostaje nil aż do pierwszej linii, która go wykorzystuje i się wysypie.
Widzisz to głównie w starych skryptach lub skopiowanych ze starych tutoriali.
Poprawka: zapytaj es_extended bezpośrednio
Zamień te linie na eksport, który zapewnia ESX Legacy:
ESX = exports['es_extended']:getSharedObject()Działa tak samo na kliencie i na serwerze. Dodaj to w każdym pliku, który używa ESX. Jeśli skrypt miał też pętlę oczekiwania jak ta poniżej, usuń ją – eksport odpowiada od razu:
-- old code: remove it
Citizen.CreateThread(function()
while ESX == nil do
TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)
Citizen.Wait(0)
end
end)Jeszcze prościej: imports.lua
es_extended dostarcza mały plik, który ustawia ESX za Ciebie. Dodaj go do fxmanifest.lua:
fx_version 'cerulean'
game 'gta5'
lua54 'yes'
shared_script '@es_extended/imports.lua'
client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }Teraz każdy plik klienta i serwera ma globalny ESX, a na kliencie ESX.PlayerData aktualizuje się automatycznie, kiedy zmienia się zawód i pieniądze gracza. Możesz całkowicie usunąć linie getSharedObject.
Wskazówka: używaj jednego podejścia na skrypt. Albo eksport na górze każdego pliku, albo
imports.luaw manifeście – mieszanie obu działa, ale jest zbędne.
Nadal nil? Sprawdź kolejność uruchomienia
Jeśli już używasz eksportu i ESX jest nadal nil, albo dostajesz No such export getSharedObject in resource es_extended, skrypt uruchamia się przed es_extended. Twoje server.cfg decyduje o kolejności:
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]
ensure my_scriptJeszcze dwie rzeczy do sprawdzenia w konsoli serwera, od samej góry:
- es_extended uruchomił się bez błędów. Jeśli się nie powiedzie (zły
mysql_connection_string, brakujący oxmysql), każdy skrypt od niego zależny też się wysypie. - Folder ma dokładnie nazwę
es_extended. Zmieniona nazwa lub zduplikowana kopia łamie nazwę eksportu, a na Linuxie nazwa jest wrażliwa na wielkość liter.
Szczegółowo omawiamy ten błąd w Brak takiego eksportu getSharedObject w zasobie es_extended.
Dane gracza na kliencie
Starsze skrypty też pobierały gracza w ten sposób:
-- old
ESX.GetPlayerData()
RegisterNetEvent('esx:playerLoaded')
AddEventHandler('esx:playerLoaded', function(xPlayer) PlayerData = xPlayer end)To nadal działa w ESX Legacy, z jedną rzeczą: poczekaj aż gracz się załaduje, zanim zaczniesz czytać zawód lub pieniądze przy starcie.
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)Dzięki imports.lua wartość ESX.PlayerData.job aktualizuje się dla Ciebie automatycznie.
Skrypty, których nie możesz edytować
Jeśli skrypt jest szyfrowany i nadal używa starego zdarzenia, nie możesz zmienić jego kodu. W kolejności preferencji:
- Poproś autora o aktualizację. Każdy skrypt sprzedawany dla ESX powinien używać eksportu.
- Odpowiedz na stare zdarzenie z ESX sam. W es_extended dodaj to do pliku serwera i pliku klienta:
AddEventHandler('esx:getSharedObject', function(cb)
cb(ESX)
end)Ostrzeżenie: to jest poprawka do samego es_extended. Aktualizacja ESX to nadpisze, więc będziesz musiał dodać to ponownie po każdej aktualizacji. Traktuj to jako rozwiązanie tymczasowe, nie jako ostateczną poprawkę.
Szybka lista kontrolna
| Objaw | Rozwiązanie |
|---|---|
attempt to index a nil value (global 'ESX') |
Zamień TriggerEvent('esx:getSharedObject'…) na exports['es_extended']:getSharedObject() |
| Nadal nil po zmianie | Uruchom es_extended przed skryptem w server.cfg |
No such export getSharedObject |
es_extended nie jest uruchomiony, się wysypał, albo ma inną nazwę |
ESX.PlayerData.job to nil przy starcie |
Poczekaj na ESX.IsPlayerLoaded() najpierw |
| Szyfrowany skrypt ze starym zdarzeniem | Poproś autora; tymczasem odpowiadaj na zdarzenie z es_extended |
Szybkie odpowiedzi
Dlaczego w moim skrypcie ESX wynosi nil?
Skrypt pyta o ESX starym wywołaniem TriggerEvent('esx:getSharedObject'), które obecne ESX Legacy już nie obsługuje. Zastąp to ESX = exports['es_extended']:getSharedObject() lub dodaj shared_script '@es_extended/imports.lua' do fxmanifest.
Czy muszę zmieniać zarówno pliki klienta jak i serwera?
Tak. Każdy plik, który używa ESX, potrzebuje tego obiektu, zarówno na kliencie jak i na serwerze. Linia imports.lua w fxmanifest obejmuje je wszystkie na raz.
Co zrobić, jeśli skrypt jest szyfrowany i nie mogę go edytować?
Najpierw poproś autora o aktualizację. W ostateczności możesz odpowiedzieć na stare zdarzenie z es_extended, ale będziesz musiał dodać to ponownie przy każdej aktualizacji ESX.
Skrypty bez tego problemu
Advanced BoostingBoosting pojazdów z tabletu: kontrakty od klasy D do S+, ekipy i kolejka na żywo.Zobacz skrypt →
Item Creator V2Twórz używalne przedmioty z animacjami, propami, efektami i nie tylko — bez pisania kodu.Zobacz skrypt →
Shop CreatorZbuduj sklep w niecałą minutę — właściciele, pracownicy, sejfy i napady w zestawie.Zobacz skrypt →

