ESX — это nil: исправление esx:getSharedObject в ESX Legacy
attempt to index a nil value (global 'ESX')? Старое событие esx:getSharedObject исчезло из ESX Legacy. Вот однострочное исправление и что делать со скриптами, которые вы не можете редактировать.

Вы запускаете сервер, открываете консоль F8 и видите:
SCRIPT ERROR: @my_script/client/main.lua:12: attempt to index a nil value (global 'ESX')Или на сервере attempt to index a nil value (upvalue 'ESX'). Скрипт в порядке, ESX работает, а ESX остаётся nil. Это самая распространённая ошибка ESX, почти всегда с одной и той же причиной.
Почему ESX — это nil
Старые скрипты ESX получают объект так:
ESX = nil
TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)Это событие использовали ESX 1.1 и 1.2. ESX Legacy его удалил, и текущие версии больше на него не отвечают. Скрипт триггер-событие, никто не ответит, и ESX остаётся nil до тех пор, пока первая строка, использующая его, не вызовет ошибку.
Обычно это встречается в старых скриптах или скопированных из устаревших туториалов.
Исправление: спросите es_extended напрямую
Замените эти строки на экспорт, который предоставляет ESX Legacy:
ESX = exports['es_extended']:getSharedObject()Это работает одинаково на клиенте и на сервере. Добавьте это в каждый файл, использующий ESX. Если в скрипте есть цикл ожидания, удалите его — экспорт отвечает сразу:
-- old code: remove it
Citizen.CreateThread(function()
while ESX == nil do
TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)
Citizen.Wait(0)
end
end)Даже проще: imports.lua
es_extended поставляется с маленьким файлом, который настраивает ESX. Добавьте его в fxmanifest.lua скрипта:
fx_version 'cerulean'
game 'gta5'
lua54 'yes'
shared_script '@es_extended/imports.lua'
client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }Теперь каждый клиентский и серверный файл имеет глобальный ESX, и на клиенте ESX.PlayerData автоматически обновляется при изменении работы или денег игрока. Вы можете полностью удалить строки getSharedObject.
Совет: используйте один подход для каждого скрипта. Либо экспорт в верхней части каждого файла, либо
imports.luaв манифесте; их смешивание работает, но это выглядит как шум.
Всё ещё nil? Проверьте порядок запуска
Если вы уже используете экспорт, но ESX по-прежнему nil, или вы получаете No such export getSharedObject in resource es_extended, скрипт запускается перед es_extended. Порядок определяет ваш server.cfg:
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]
ensure my_scriptПроверьте в консоли сервера (в самом начале):
- es_extended запустился без ошибок. Если он упал (неправильный
mysql_connection_string, отсутствует oxmysql), каждый скрипт, зависящий от него, тоже упадёт. - Папка действительно называется
es_extended. Переименованная или дублированная копия сломает имя экспорта, и на Linux название чувствительно к регистру.
Мы разобираем эту ошибку подробнее в No such export getSharedObject in resource es_extended.
Данные игрока на клиенте
Старые скрипты читали игрока так:
-- old
ESX.GetPlayerData()
RegisterNetEvent('esx:playerLoaded')
AddEventHandler('esx:playerLoaded', function(xPlayer) PlayerData = xPlayer end)В ESX Legacy это ещё работает, но с одной деталью: дождитесь загрузки игрока перед прочтением работы или денег при запуске.
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 ESX.PlayerData.job остаётся актуальным автоматически.
Скрипты, которые вы не можете редактировать
Если скрипт защищен (зашифрован) и всё ещё использует старое событие, вы не можете изменить его код. По приоритету:
- Попросите автора обновленную версию. Любой скрипт, ещё продаваемый для ESX, должен использовать экспорт.
- Ответьте на старое событие из ESX сами. В es_extended добавьте это в серверный и клиентский файл:
AddEventHandler('esx:getSharedObject', function(cb)
cb(ESX)
end)Внимание: это патч самого es_extended. При обновлении ESX он перезапишется, поэтому вам придётся добавлять его заново после каждого обновления. Используйте это как временное решение, не как окончательное.
Быстрый чек-лист
| Симптом | Исправление |
|---|---|
attempt to index a nil value (global 'ESX') |
Замените TriggerEvent('esx:getSharedObject'…) на exports['es_extended']:getSharedObject() |
| Всё ещё nil после изменения | Запустите es_extended перед скриптом в server.cfg |
No such export getSharedObject |
es_extended не запущен, упал или называется иначе |
ESX.PlayerData.job — nil при запуске |
Сначала дождитесь ESX.IsPlayerLoaded() |
| Защищённый скрипт со старым событием | Попросите автора; пока ответьте на событие из es_extended |
Короткие ответы
Почему ESX nil в моем скрипте?
Скрипт запрашивает ESX с помощью старого вызова TriggerEvent('esx:getSharedObject'), но текущий ESX Legacy больше на него не отвечает. Замените его на ESX = exports['es_extended']:getSharedObject() или добавьте shared_script '@es_extended/imports.lua' в fxmanifest.
Нужно ли мне изменять файлы как на клиенте, так и на сервере?
Да. Каждому файлу, который использует ESX, нужен объект — и на клиенте, и на сервере. Строка imports.lua в fxmanifest охватывает все файлы сразу.
Что делать, если скрипт защищен и я не могу его редактировать?
Сначала попросите у автора обновленную версию. В крайнем случае вы можете ответить на старое событие из es_extended, но вам придётся добавлять это после каждого обновления ESX.
Скрипты без этой проблемы
Advanced BoostingУгон машин на заказ через планшет: контракты от класса D до S+, команды и живая очередь.Смотреть скрипт →
Item Creator V2Создавайте используемые предметы с анимациями, пропами, эффектами и не только — без кода.Смотреть скрипт →
Shop CreatorМагазин меньше чем за минуту — владельцы, сотрудники, сейфы и ограбления в комплекте.Смотреть скрипт →

