attempt to index a nil value (global 'QBCore'): a correção GetCoreObject
QBCore é nil no seu script? O antigo evento QBCore:GetObject desapareceu. Como obter o objeto core com GetCoreObject, em QBCore e em QBox, e por que ele ainda pode ser nil.

Em algum lugar do seu console:
SCRIPT ERROR: @my_script/client/main.lua:8: attempt to index a nil value (global 'QBCore')QBCore está rodando, o script parece certo, e QBCore ainda é nil. Aqui está por quê, e como corrigir em QBCore e em QBox.
Por que QBCore é nil
Scripts QBCore mais antigos conseguiam o objeto core com um evento:
QBCore = nil
TriggerEvent('QBCore:GetObject', function(obj) QBCore = obj end)Esse evento foi removido de qb-core. Ninguém atende mais, então QBCore fica nil e a primeira linha QBCore.Functions… falha.
A correção: GetCoreObject
Peça qb-core seu objeto com a exportação, no topo do arquivo:
local QBCore = exports['qb-core']:GetCoreObject()É a mesma linha no cliente e no servidor. Coloque em todo arquivo que usa QBCore, ou uma vez em um arquivo compartilhado que o manifesto carrega primeiro:
-- fxmanifest.lua
shared_script 'shared/core.lua'
client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }-- shared/core.lua
QBCore = exports['qb-core']:GetCoreObject()Dica: se
QBCoreforlocalem um arquivo, os outros arquivos não conseguem ver. Um erro nil em só um arquivo do script geralmente significa exatamente isso.
Ainda nil? qb-core não está rodando ainda
A exportação só responde se qb-core iniciou primeiro. Em server.cfg:
ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]
ensure my_scriptAí:
- Verifique o próprio início de qb-core no topo do console do servidor. Um erro de banco de dados significa que suas exportações nunca existem, e você recebe
No such export GetCoreObject in resource qb-core. - Adicione a dependência ao
fxmanifest.luado script, para que FiveM inicie qb-core primeiro ou recuse iniciar o script sem ela:
dependency 'qb-core'Em QBox
O core de QBox é qbx_core, e mantém uma camada de compatibilidade para scripts qb-core: exports['qb-core']:GetCoreObject() ainda retorna um objeto, então a maioria dos scripts QBCore rodam como estão.
O que muda é a ordem e o nome em server.cfg:
ensure oxmysql
ensure ox_lib
ensure qbx_coreNão há uma pasta qb-core separada em QBox. Se você ainda tem uma, remova-a ou os dois cores vão brigar.
Para código novo, QBox prefere suas próprias exportações em vez da grande tabela QBCore, por exemplo no servidor:
local player = exports.qbx_core:GetPlayer(source)
if player then
print(player.PlayerData.citizenid)
endDados do jogador no cliente
Ler o jogador cedo demais é o outro clássico nil:
-- this runs before the player is loaded: job is nil
local job = QBCore.Functions.GetPlayerData().jobAguarde pelo jogador em vez:
local QBCore = exports['qb-core']:GetCoreObject()
local PlayerData = {}
RegisterNetEvent('QBCore:Client:OnPlayerLoaded', function()
PlayerData = QBCore.Functions.GetPlayerData()
end)
RegisterNetEvent('QBCore:Client:OnJobUpdate', function(job)
PlayerData.job = job
end)Se o script pode também ser reiniciado enquanto você está em game, leia os dados uma vez quando ele inicia, já que OnPlayerLoaded já foi acionado até então.
Lista de verificação
| Sintoma | Corrigir |
|---|---|
attempt to index a nil value (global 'QBCore') |
local QBCore = exports['qb-core']:GetCoreObject() no topo do arquivo |
| Nil em só um arquivo | QBCore é local em outro arquivo; defina lá também, ou em um arquivo compartilhado |
No such export GetCoreObject |
qb-core (ou qbx_core) não iniciou, ou falhou ao iniciar |
| Servidor QBox | Mantenha a exportação, inicie qbx_core, remova qualquer pasta qb-core antiga |
job é nil na inicialização |
Aguarde QBCore:Client:OnPlayerLoaded |
Rodando ESX em vez? O mesmo problema lá é ESX é nil: corrigindo esx:getSharedObject.
Respostas rápidas
Por que QBCore é nil no meu script?
O script nunca conseguiu o objeto core: usa o evento removido QBCore:GetObject, define QBCore em outro arquivo, ou inicia antes de qb-core. Use local QBCore = exports['qb-core']:GetCoreObject() no topo de cada arquivo.
GetCoreObject funciona em QBox?
Sim. qbx_core mantém uma camada de compatibilidade para scripts qb-core, então exports['qb-core']:GetCoreObject() ainda responde. Para código novo, QBox prefere suas próprias exportações, como exports.qbx_core:GetPlayer(source).
Preciso chamar GetCoreObject em todo arquivo?
Cada arquivo que usa QBCore precisa dele, a menos que o script o defina uma vez em um arquivo compartilhado carregado antes dos outros.
Scripts sem esse problema
Advanced BoostingBoosting de veículos pelo tablet: contratos da classe D à S+, crews e fila ao vivo.Ver script →
Clothing DesignerCrie roupas dentro do FiveM — pincel, camadas, importação de imagens e IA — e vista na hora.Ver script →
Quest CreatorUm editor visual de missões e diálogos com NPCs, montado nó por nó dentro do jogo.Ver script →

