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.

Sunucunuzu başlatıyorsunuz, F8 konsolunu açıyorsunuz ve burada:
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ı:
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:
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:
-- 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:
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:
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]
ensure my_scriptSunucu 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:
-- 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.
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:
- Yazardan güncelleme isteyin. ESX için hâlâ satılan her script export kullanmalıdır.
- Eski event'i ESX'den kendiniz yanıtlayın. es_extended'de, bir server dosyasına ve bir client dosyasına ekleyin:
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 →

