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

ESX to nil: naprawianie esx:getSharedObject w ESX Legacy

Uruchamiasz serwer, otwierasz konsolę F8 i widzisz:

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

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

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

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)

Jeszcze prościej: imports.lua

es_extended dostarcza mały plik, który ustawia ESX za Ciebie. Dodaj go do fxmanifest.lua:

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

cfg
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]

ensure my_script

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

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

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)

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:

  1. Poproś autora o aktualizację. Każdy skrypt sprzedawany dla ESX powinien używać eksportu.
  2. Odpowiedz na stare zdarzenie z ESX sam. W es_extended dodaj to do pliku serwera i pliku klienta:
lua
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 →

Czytaj dalej