attempt to index a nil value (global 'QBCore'): la correzione GetCoreObject

QBCore è nil nel tuo script? Il vecchio evento QBCore:GetObject è scomparso. Come ottenere l'oggetto core con GetCoreObject, su QBCore e su QBox, e perché può ancora essere nil.

attempt to index a nil value (global 'QBCore'): la correzione GetCoreObject

Da qualche parte nella tua console:

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

QBCore è in esecuzione, lo script sembra a posto, eppure QBCore è nil. Ecco perché e come risolverlo su QBCore e su QBox.

Perché QBCore è nil

Gli script QBCore più vecchi ottenevano l'oggetto core con un evento:

lua
QBCore = nil
TriggerEvent('QBCore:GetObject', function(obj) QBCore = obj end)

Quell'evento è stato rimosso da qb-core. Nessuno lo gestisce più, quindi QBCore rimane nil e la prima riga QBCore.Functions… crasha.

La soluzione: GetCoreObject

Chiedi a qb-core il suo oggetto con l'export, in cima al file:

lua
local QBCore = exports['qb-core']:GetCoreObject()

È la stessa riga su client e server. Mettila in ogni file che usa QBCore, oppure una volta in un file condiviso che il manifest carica per primo:

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()

Suggerimento: se QBCore è local in un file, gli altri non possono vederlo. Un errore nil in un solo file dello script di solito significa esattamente questo.

Ancora nil? qb-core non è ancora in esecuzione

L'export risponde solo se qb-core è partito per primo. In server.cfg:

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

ensure my_script

Poi:

  • Controlla l'avvio di qb-core all'inizio della console del server. Un errore database lì significa che i suoi export non esistono mai, e riceverai No such export GetCoreObject in resource qb-core.
  • Aggiungi la dipendenza al fxmanifest.lua dello script, così FiveM avvia qb-core prima o rifiuta di avviare lo script senza:
lua
dependency 'qb-core'

Su QBox

Il core di QBox è qbx_core, e mantiene un livello di compatibilità per script qb-core: exports['qb-core']:GetCoreObject() restituisce comunque un oggetto, quindi la maggior parte degli script QBCore funzionano come sono.

Quello che cambia è l'ordine e il nome in server.cfg:

cfg
ensure oxmysql
ensure ox_lib
ensure qbx_core

Non esiste una cartella qb-core separata su QBox. Se ne hai ancora una, rimuovila, altrimenti i due core si combattono.

Per nuovo codice, QBox preferisce i suoi export rispetto alla grande tabella QBCore, ad esempio sul server:

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

Dati del giocatore sul client

Leggere il giocatore troppo presto è l'altro nil classico:

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

Aspetta il giocatore invece:

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 lo script può essere riavviato anche mentre sei in game, leggi i dati una volta all'avvio pure, perché OnPlayerLoaded è già stato attivato a quel punto.

Lista di controllo

Sintomo Soluzione
attempt to index a nil value (global 'QBCore') local QBCore = exports['qb-core']:GetCoreObject() in cima al file
Nil in un solo file QBCore è local in un altro file; definiscilo anche lì, o in un file condiviso
No such export GetCoreObject qb-core (o qbx_core) non avviato, o l'avvio è fallito
Server QBox Mantieni l'export, avvia qbx_core, rimuovi qualsiasi vecchia cartella qb-core
job è nil all'avvio Aspetta QBCore:Client:OnPlayerLoaded

Usi ESX invece? Lo stesso problema lì è ESX è nil: correggere esx:getSharedObject.

Risposte rapide

Perché QBCore è nil nel mio script?

Lo script non ha mai avuto l'oggetto core: usa il vecchio evento QBCore:GetObject che è stato rimosso, lo definisce in un altro file, oppure si avvia prima di qb-core. Usa local QBCore = exports['qb-core']:GetCoreObject() in cima a ogni file.

GetCoreObject funziona su QBox?

Sì. qbx_core mantiene un livello di compatibilità per qb-core, quindi exports['qb-core']:GetCoreObject() risponde ancora. Per nuovo codice, QBox preferisce i suoi export, come exports.qbx_core:GetPlayer(source).

Devo chiamare GetCoreObject in ogni file?

Ogni file che usa QBCore ne ha bisogno, a meno che lo script lo definisca una volta in un file condiviso caricato prima degli altri.

Script senza questo problema

Advanced BoostingBoosting di veicoli dal tablet: contratti dalla classe D alla S+, crew e coda in tempo reale.Vedi script →Clothing DesignerDisegna vestiti dentro FiveM — pennello, livelli, import di immagini e IA — e poi indossali.Vedi script →Quest CreatorUn editor visuale di missioni e dialoghi con gli NPC, costruito nodo per nodo in gioco.Vedi script →

Continua a leggere