ESX — это nil: исправление esx:getSharedObject в ESX Legacy

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

ESX — это nil: исправление esx:getSharedObject в ESX Legacy

Вы запускаете сервер, открываете консоль F8 и видите:

text
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 получают объект так:

lua
ESX = nil

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

Это событие использовали ESX 1.1 и 1.2. ESX Legacy его удалил, и текущие версии больше на него не отвечают. Скрипт триггер-событие, никто не ответит, и ESX остаётся nil до тех пор, пока первая строка, использующая его, не вызовет ошибку.

Обычно это встречается в старых скриптах или скопированных из устаревших туториалов.

Исправление: спросите es_extended напрямую

Замените эти строки на экспорт, который предоставляет ESX Legacy:

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

Это работает одинаково на клиенте и на сервере. Добавьте это в каждый файл, использующий ESX. Если в скрипте есть цикл ожидания, удалите его — экспорт отвечает сразу:

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)

Даже проще: imports.lua

es_extended поставляется с маленьким файлом, который настраивает ESX. Добавьте его в fxmanifest.lua скрипта:

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:

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.

Данные игрока на клиенте

Старые скрипты читали игрока так:

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

В ESX Legacy это ещё работает, но с одной деталью: дождитесь загрузки игрока перед прочтением работы или денег при запуске.

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 ESX.PlayerData.job остаётся актуальным автоматически.

Скрипты, которые вы не можете редактировать

Если скрипт защищен (зашифрован) и всё ещё использует старое событие, вы не можете изменить его код. По приоритету:

  1. Попросите автора обновленную версию. Любой скрипт, ещё продаваемый для ESX, должен использовать экспорт.
  2. Ответьте на старое событие из ESX сами. В es_extended добавьте это в серверный и клиентский файл:
lua
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Магазин меньше чем за минуту — владельцы, сотрудники, сейфы и ограбления в комплекте.Смотреть скрипт →

Читайте также