ESX é nil: corrigindo esx:getSharedObject em ESX Legacy

attempt to index a nil value (global 'ESX')? O antigo evento esx:getSharedObject desapareceu de ESX Legacy. Aqui está a correção de uma linha e o que fazer com scripts que você não pode editar.

ESX é nil: corrigindo esx:getSharedObject em ESX Legacy

Você inicia seu servidor, abre o console F8 e aí está:

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

Ou o equivalente no servidor, attempt to index a nil value (upvalue 'ESX'). O script está correto, ESX está rodando, e mesmo assim ESX é nil. Este é o erro ESX mais comum que existe, e quase sempre tem a mesma causa.

Por que ESX é nil

Scripts ESX mais antigos obtêm o objeto ESX assim:

lua
ESX = nil

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

Esse evento era como ESX 1.1 e 1.2 distribuíam seu objeto compartilhado. ESX Legacy o descontinuou, e as versões atuais não respondem mais. O script aciona o evento, ninguém responde, e ESX fica nil até que a primeira linha que o usa travacar.

Você vai ver isso principalmente em scripts escritos anos atrás, ou copiados de tutoriais antigos.

A solução: pergunte es_extended diretamente

Substitua essas linhas pela exportação que ESX Legacy fornece:

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

Funciona igual no cliente e no servidor. Faça isso em todos os arquivos que usam ESX. Se o script também tinha um loop de espera como este, delete-o; a exportação responde na hora:

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)

Ainda mais simples: imports.lua

es_extended traz um pequeno arquivo que configura ESX para você. Adicione-o ao fxmanifest.lua do script:

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

shared_script '@es_extended/imports.lua'

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

Agora todo arquivo de cliente e servidor tem um global ESX, e no cliente ESX.PlayerData fica atualizado conforme o trabalho e dinheiro do jogador mudam. Você pode deletar as linhas de getSharedObject inteiramente.

Dica: use uma abordagem por script. Ou a exportação no topo de cada arquivo, ou imports.lua no manifesto; misturar os dois funciona, mas é bagunça.

Ainda nil? Verifique a ordem de início

Se você já usa a exportação e ESX ainda é nil, ou recebe No such export getSharedObject in resource es_extended, o script está iniciando antes de es_extended. Seu server.cfg decide a ordem:

cfg
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [esx]

ensure my_script

Mais duas coisas para verificar no console do servidor, desde o topo:

  • es_extended iniciou sem erros. Se falhar (uma mysql_connection_string ruim, um oxmysql faltando), todo script que depende dele também falha.
  • A pasta se chama es_extended. Uma cópia renomeada ou duplicada quebra o nome de exportação, e no Linux o nome é case-sensitive.

Cobrimos esse erro em detalhe em No such export getSharedObject in resource es_extended.

Dados do jogador no cliente

Scripts antigos também leem o jogador assim:

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

Isso ainda funciona em ESX Legacy, com um detalhe: espere até que o jogador seja carregado antes de ler trabalho ou dinheiro na inicialização.

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)

Com imports.lua, ESX.PlayerData.job é mantido atualizado para você.

Scripts que você não pode editar

Se o script está escrowed (encriptado) e ainda usa o evento antigo, você não pode mudar seu código. Em ordem de preferência:

  1. Peça ao autor uma atualização. Qualquer script ainda vendido para ESX deveria usar a exportação.
  2. Responda você mesmo ao evento antigo de ESX. Em es_extended, adicione isto a um arquivo do servidor e a um arquivo do cliente:
lua
AddEventHandler('esx:getSharedObject', function(cb)
    cb(ESX)
end)

Atenção: isto é um patch para o próprio es_extended. Atualizar ESX o sobrescreve, então você terá que adicioná-lo de novo após cada atualização. Mantenha como um paliativo, não como a solução.

Lista de verificação rápida

Sintoma Corrigir
attempt to index a nil value (global 'ESX') Substitua TriggerEvent('esx:getSharedObject'…) por exports['es_extended']:getSharedObject()
Ainda nil após a mudança Inicie es_extended antes do script em server.cfg
No such export getSharedObject es_extended não foi iniciado, falhou, ou tem nome diferente
ESX.PlayerData.job é nil na inicialização Aguarde ESX.IsPlayerLoaded() primeiro
Script escrowed com o evento antigo Peça ao autor; enquanto isso, responda o evento de es_extended

Respostas rápidas

Por que ESX é nil no meu script?

O script solicita ESX usando a antiga chamada TriggerEvent('esx:getSharedObject'), que o ESX Legacy atual não atende mais. Substitua-a por ESX = exports['es_extended']:getSharedObject(), ou adicione shared_script '@es_extended/imports.lua' ao fxmanifest.

Preciso alterar tanto os arquivos do cliente quanto do servidor?

Sim. Todo arquivo que usa ESX precisa do objeto, tanto no cliente quanto no servidor. A linha imports.lua no fxmanifest cobre todos eles de uma vez.

E se o script estiver escrowed e eu não puder editá-lo?

Peça primeiro ao autor uma atualização. Como último recurso, você pode responder ao evento antigo de es_extended, mas terá que adicioná-lo novamente sempre que atualizar ESX.

Scripts sem esse problema

Advanced BoostingBoosting de veículos pelo tablet: contratos da classe D à S+, crews e fila ao vivo.Ver script →Item Creator V2Crie itens usáveis com animações, props, efeitos e muito mais — sem escrever código.Ver script →Shop CreatorMonte uma loja em menos de um minuto — donos, funcionários, cofres e assaltos inclusos.Ver script →

Continue lendo