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.

attempt to index a nil value (global 'QBCore'): a correção GetCoreObject

Em algum lugar do seu console:

text
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:

lua
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:

lua
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:

lua
-- fxmanifest.lua
shared_script 'shared/core.lua'
client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }
lua
-- shared/core.lua
QBCore = exports['qb-core']:GetCoreObject()

Dica: se QBCore for local em 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:

cfg
ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]

ensure my_script

Aí:

  • 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.lua do script, para que FiveM inicie qb-core primeiro ou recuse iniciar o script sem ela:
lua
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:

cfg
ensure oxmysql
ensure ox_lib
ensure qbx_core

Nã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:

lua
local player = exports.qbx_core:GetPlayer(source)
if player then
    print(player.PlayerData.citizenid)
end

Dados do jogador no cliente

Ler o jogador cedo demais é o outro clássico nil:

lua
-- this runs before the player is loaded: job is nil
local job = QBCore.Functions.GetPlayerData().job

Aguarde pelo jogador em vez:

lua
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 →

Continue lendo