ESX boş: ESX Legacy'de esx:getSharedObject düzeltilmesi

nil değerini (global 'ESX') dizine almayı deneyin? Eski esx:getSharedObject etkinliği ESX Legacy'den kaldırıldı. İşte tek satırlık düzeltme ve düzenleyemediğiniz scriptlerle ne yapacağınız.

ESX boş: ESX Legacy'de esx:getSharedObject düzeltilmesi

Sunucunuzu başlatıyorsunuz, F8 konsolunu açıyorsunuz ve burada:

text
SCRIPT ERROR: @my_script/client/main.lua:12: attempt to index a nil value (global 'ESX')

Ya da server tarafındaki kardeşi, attempt to index a nil value (upvalue 'ESX'). Script tamam, ESX çalışıyor, ama ESX hâlâ nil. Bu en yaygın ESX hatası ve neredeyse her zaman aynı nedeni vardır.

Neden ESX boş

Eski ESX scriptleri ESX nesnesini böyle alırdı:

lua
ESX = nil

TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)

Bu event, ESX 1.1 ve 1.2 zamanında shared object'i dağıtmanın yoluydu. ESX Legacy bunu kaldırdı ve mevcut sürümler artık buna yanıt vermiyor. Script event'i tetikler, kimse yanıt vermez, ESX null kalır ve onu kullanan ilk satır çöker.

Bunu çoğunlukla yıllar önce yazılmış ya da eski öğretici sayfalarından kopyalanmış scriptlerde görürsünüz.

Çözüm: es_extended'e doğrudan

Bu satırları ESX Legacy'nin sağladığı export ile değiştirin:

lua
ESX = exports['es_extended']:getSharedObject()

Client ve server'da aynı şekilde çalışır. Bunu ESX kullanan her dosyada yapın. Script'te böyle bir bekleme döngüsü varsa silin; export hemen yanıt verir:

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)

Daha da basit: imports.lua

es_extended sizin için ESX'i ayarlayan küçük bir dosya sağlar. Script'in fxmanifest.lua'ya ekleyin:

lua
fx_version 'cerulean'
game 'gta5'
lua54 'yes'

shared_script '@es_extended/imports.lua'

client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }

Artık her client ve server dosyasında global ESX var, ve client'de ESX.PlayerData oyuncunun job'u ve parası değiştikçe güncel kalır. getSharedObject satırlarını tamamen silebilirsiniz.

İpucu: script başına bir yöntem kullanın. Ya her dosyanın başında export, ya da manifest'te imports.lua; her ikisini karıştırmak işe yarar ama gereksiz olur.

Hâlâ boş mu? Başlangıç sırasını kontrol edin

Zaten export kullanıyorsanız ve ESX hâlâ nil ise, ya da No such export getSharedObject in resource es_extended alıyorsanız, script es_extended'den önce başlıyor demektir. server.cfg sırayı belirler:

cfg
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]

ensure my_script

Sunucu konsolunun en başında kontrol etmeniz gereken iki şey daha:

  • es_extended hatasız başladı. Başarısız olursa (kötü mysql_connection_string, eksik oxmysql), ona bağlı her script de başarısız olur.
  • Klasör adı es_extended. Yeniden adlandırılmış ya da kopyalanmış bir klasör export adını bozar, ve Linux'ta ad büyük/küçük harfe duyarlıdır.

Bu hatayı es_extended'de böyle bir export getSharedObject yok sayfasında detaylı inceledik.

Client'de oyuncu verileri

Eski scriptler oyuncu verisini böyle okurdu:

lua
-- old
ESX.GetPlayerData()
RegisterNetEvent('esx:playerLoaded')
AddEventHandler('esx:playerLoaded', function(xPlayer) PlayerData = xPlayer end)

Bu hâlâ ESX Legacy'de çalışıyor, bir detay var: başlangıçta job ya da para okumadan önce oyuncunun yüklenmesini bekleyin.

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)

imports.lua ile ESX.PlayerData.job sizin için güncel tutulur.

Düzenleyemediğiniz scriptler

Script şifreli (escrowed) ve hâlâ eski event'i kullanıyorsa, kodunu değiştiremezsiniz. Tercih sırasına göre:

  1. Yazardan güncelleme isteyin. ESX için hâlâ satılan her script export kullanmalıdır.
  2. Eski event'i ESX'den kendiniz yanıtlayın. es_extended'de, bir server dosyasına ve bir client dosyasına ekleyin:
lua
AddEventHandler('esx:getSharedObject', function(cb)
    cb(ESX)
end)

Dikkat: bu es_extended'nin kendisine bir patch'tir. ESX güncellendiğinde üzerine yazılır, o yüzden her update'ten sonra tekrar eklemeniz gerekir. Bunu geçici çözüm olarak tutun, kalıcı olmak üzere değil.

Hızlı kontrol listesi

Belirti Çözüm
attempt to index a nil value (global 'ESX') TriggerEvent('esx:getSharedObject'…)'yi exports['es_extended']:getSharedObject() ile değiştirin
Değişiklikten sonra hâlâ boş server.cfg'de es_extended'i scriptin üzerine koyun
No such export getSharedObject es_extended başlamamış, başarısız olmuş, ya da farklı isimde
ESX.PlayerData.job başlangıçta boş Önce ESX.IsPlayerLoaded()'i bekleyin
Eski event'li şifreli script Yazara sorun; bu arada es_extended'den event'i yanıtlayın

Kısa yanıtlar

Neden komut dosyamda ESX boş?

Script, ESX'i eski TriggerEvent('esx:getSharedObject') çağrısıyla istediğinde, mevcut ESX Legacy artık yanıt vermiyor. Bunu ESX = exports['es_extended']:getSharedObject() ile değiştirin ya da fxmanifest'e shared_script '@es_extended/imports.lua' ekleyin.

Hem client hem de server dosyalarını değiştirmem gerekiyor mu?

Evet. ESX kullanan her dosya client ve server'da nesneye ihtiyaç duyar. fxmanifest'teki imports.lua satırı bunların hepsini aynı anda kaplar.

Script şifreli ve düzenleyemiyorum ne yapmalı?

Önce yazardan güncelleme isteyin. Son çare olarak eski event'i es_extended'den yanıtlayabilirsiniz, ama ESX'i her güncellediğinizde bunu tekrar eklemeniz gerekir.

Bu sorunu yaşatmayan scriptler

Advanced BoostingTabletten araç boosting: D’den S+ sınıfına kontratlar, ekipler ve canlı sıra.Scripti gör →Item Creator V2Animasyonlar, proplar, efektler ve daha fazlasıyla kullanılabilir eşyalar oluşturun — kod yazmadan.Scripti gör →Shop CreatorBir dakikadan kısa sürede dükkân kurun — sahipler, çalışanlar, kasalar ve soygunlar dahil.Scripti gör →

Okumaya devam edin