No such export getSharedObject in resource es_extended: a correção

Recebendo 'No such export getSharedObject in resource es_extended'? Significa que es_extended não está rodando quando seu script pede por ela. As causas, desde ordem de início até falha de conexão com banco de dados.

No such export getSharedObject in resource es_extended: a correção

O erro completo geralmente fica assim, no console do servidor ou em F8:

text
SCRIPT ERROR: @my_script/server/main.lua:1: No such export getSharedObject in resource es_extended

O código está certo. exports['es_extended']:getSharedObject() é exatamente como ESX Legacy distribui seu objeto. O problema é quando ele roda: naquele momento, es_extended não está lá para responder.

1. es_extended inicia depois do seu script

Esta é a causa nove entre dez vezes. FiveM inicia recursos na ordem de server.cfg, e um script que pede ESX na primeira linha precisa que es_extended já esteja rodando.

Uma ordem segura para um servidor ESX:

cfg
# database and libraries first
ensure oxmysql
ensure ox_lib

# the framework
ensure es_extended
ensure [esx]

# everything else after
ensure [scripts]
ensure my_script

Cuidado com categorias de pasta como [scripts]: ensure [scripts] inicia tudo dentro dela, então se essa linha vier antes de ensure es_extended, todo script dentro dela inicia cedo demais.

Você também pode fazer o script esperar por ESX, declarando a dependência em seu fxmanifest.lua:

lua
dependency 'es_extended'

FiveM vai iniciar es_extended primeiro, ou recusar iniciar o script se ela estiver faltando.

2. es_extended falhou ao iniciar

Se es_extended travar ao iniciar, suas exportações nunca existem. Role o console do servidor até o topo e procure linhas vermelhas de es_extended antes do erro do seu script. Os culpados comuns:

  • O banco de dados. oxmysql não consegue conectar (senha errada, banco de dados que não existe, MySQL não rodando). Verifique mysql_connection_string em seu server.cfg:
cfg
set mysql_connection_string "mysql://user:password@localhost/es_extended?charset=utf8mb4"
  • Dependência faltando. Builds ESX Legacy recentes precisam oxmysql e ox_lib iniciados antes delas.
  • Tabelas faltando. Uma instalação nova sem o SQL de ESX importado falha na primeira query.

Corrija esse primeiro erro e o erro de exportação desaparece com ele.

3. A pasta não se chama es_extended

A exportação vive em um recurso chamado exatamente es_extended. Essas coisas quebram:

  • a pasta foi renomeada (es_extended-legacy, es_extended_main...);
  • tem duas cópias de es_extended em pastas diferentes, e a errada inicia;
  • em um host Linux, o nome tem maiúsculas diferentes (ES_Extended): Linux é case-sensitive, Windows não é.

Procure sua pasta resources por fxmanifest.lua dentro de pastas chamadas es_extended e mantenha exatamente uma.

4. Você reiniciou es_extended enquanto o servidor estava rodando

restart es_extended do console parece inofensivo, mas todo script que já pegou o objeto ESX mantém o antigo, e qualquer coisa que chame a exportação durante a reinicialização recebe esse erro. Depois de mexer em es_extended, reinicie o servidor inteiro, ou pelo menos reinicie os scripts ESX depois dela.

5. O servidor não é ESX

Se seu servidor roda QBCore ou QBox, não há es_extended, e um script só ESX falha exatamente assim. Procure na config do script uma opção de framework, ou use uma versão feita para seu framework. O equivalente QBCore desse erro é coberto em attempt to index a nil value (global 'QBCore').

Verificando em dez segundos

No console do servidor:

text
ensure es_extended

Se es_extended inicia limpo e o erro persiste, é a ordem de início. Se imprimir erros, corrija-os primeiro. Aí:

text
restart my_script

Se o script agora inicia sem o erro, mova seu ensure abaixo de es_extended em server.cfg para que funcione também depois de um reboot.

Resumo

Causa Como você nota Corrigir
Ordem de início Funciona depois de restart my_script ensure es_extended acima do script, ou dependency 'es_extended'
es_extended travou Linhas vermelhas de es_extended acima do erro Corrija o banco de dados ou a dependência faltando
Nome de pasta errado ensure es_extended diz que não consegue achar Exatamente uma pasta chamada es_extended
Reinicialização ao vivo Erros logo após restart es_extended Reinicie o servidor
Não é um servidor ESX Sem es_extended Use a versão QBCore / QBox do script

Respostas rápidas

O que significa 'No such export getSharedObject in resource es_extended'?

Seu script chamou exports['es_extended']:getSharedObject() enquanto es_extended não estava rodando: ainda não havia iniciado, falhou na inicialização, ou tem um nome de pasta diferente.

Como faço es_extended iniciar antes do meu script?

Coloque ensure es_extended acima do script em server.cfg, depois de oxmysql e ox_lib. Adicionar dependency 'es_extended' ao fxmanifest do script também faz FiveM iniciar es_extended primeiro.

Posso reiniciar es_extended enquanto o servidor está rodando?

Não é uma boa ideia: todo recurso que tem o objeto ESX mantém o antigo. Reinicie o servidor inteiro, ou reinicie os scripts que usam ESX depois de es_extended.

Scripts sem esse problema

Advanced BoostingBoosting de veículos pelo tablet: contratos da classe D à S+, crews e fila ao vivo.Ver script →CCTV Security CamerasCâmeras posicionáveis, um tablet com várias telas ao vivo e fotos impressas como prova.Ver script →Crypto MiningCompre um galpão, monte rigs peça por peça e minere moedas num mercado que se mexe.Ver script →

Continue lendo