attempt to index a nil value (global 'QBCore') : le correctif GetCoreObject

QBCore est nil dans votre script ? L'ancien événement QBCore:GetObject a disparu. Comment obtenir l'objet principal avec GetCoreObject, sur QBCore et sur QBox, et pourquoi il peut toujours être nil.

attempt to index a nil value (global 'QBCore') : le correctif GetCoreObject

Quelque part dans votre console :

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

QBCore tourne, le script a l'air correct, et pourtant QBCore est nil. Voici pourquoi, et comment le corriger sur QBCore et sur QBox.

Pourquoi QBCore est nil

Les anciens scripts QBCore obtenaient l'objet principal avec un événement :

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

Cet événement a été supprimé de qb-core. Personne n'y répond plus, donc QBCore reste nil et la première ligne QBCore.Functions… plante.

Le correctif : GetCoreObject

Demandez à qb-core son objet via l'export, en haut du fichier :

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

C'est la même ligne sur le client et sur le serveur. Mettez-la dans chaque fichier qui utilise QBCore, ou une fois dans un fichier partagé que le manifeste charge en premier :

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

Astuce : si QBCore est local dans un fichier, les autres fichiers ne peuvent pas le voir. Une erreur nil dans un seul fichier du script signifie habituellement exactement cela.

Toujours nil ? qb-core n'est pas encore en cours d'exécution

L'export ne répond que si qb-core a démarré en premier. Dans server.cfg :

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

ensure my_script

Ensuite :

  • Vérifiez le démarrage propre de qb-core en haut de la console du serveur. Une erreur de base de données signifie que ses exports n'existent jamais, et vous obtenez No such export GetCoreObject in resource qb-core.
  • Ajoutez la dépendance au fxmanifest.lua du script, pour que FiveM démarre qb-core en premier ou refuse de démarrer le script sans elle :
lua
dependency 'qb-core'

Sur QBox

Le principal de QBox est qbx_core, et il garde une couche de compatibilité pour les scripts qb-core : exports['qb-core']:GetCoreObject() retourne toujours un objet, donc la plupart des scripts QBCore tournent tels quels.

Ce qui change, c'est l'ordre et le nom dans server.cfg :

cfg
ensure oxmysql
ensure ox_lib
ensure qbx_core

Il n'y a pas de dossier qb-core distinct sur QBox. Si vous en avez encore un, supprimez-le, ou les deux cœurs vont en conflit.

Pour du nouveau code, QBox préfère ses propres exports à la grosse table QBCore, par exemple côté serveur :

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

Données du joueur sur le client

Lire le joueur trop tôt est l'autre classique nil :

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

Attendez plutôt le joueur :

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)

Si le script peut aussi être redémarré pendant que vous êtes en jeu, lisez aussi les données une fois au démarrage, car OnPlayerLoaded a déjà été tiré à ce moment.

Liste de contrôle

Symptôme Correction
attempt to index a nil value (global 'QBCore') local QBCore = exports['qb-core']:GetCoreObject() en haut du fichier
Nil dans un seul fichier QBCore est local à un autre fichier ; définissez-le là aussi, ou dans un fichier partagé
No such export GetCoreObject qb-core (ou qbx_core) n'a pas démarré ou n'a pas pu démarrer
Serveur QBox Gardez l'export, démarrez qbx_core, supprimez tout ancien dossier qb-core
job est nil au démarrage Attendez QBCore:Client:OnPlayerLoaded

Vous exécutez ESX à la place ? Le même problème est ESX est nil : correction de esx:getSharedObject.

Réponses rapides

Pourquoi QBCore est nil dans mon script ?

Le script n'a jamais récupéré l'objet principal : il utilise l'événement QBCore:GetObject supprimé, il définit QBCore dans un autre fichier ou il démarre avant qb-core. Utilisez local QBCore = exports['qb-core']:GetCoreObject() en haut de chaque fichier.

Est-ce que GetCoreObject fonctionne sur QBox ?

Oui. qbx_core conserve une couche de compatibilité pour qb-core, donc exports['qb-core']:GetCoreObject() répond toujours. Pour du nouveau code, QBox préfère ses propres exports, comme exports.qbx_core:GetPlayer(source).

Dois-je appeler GetCoreObject dans chaque fichier ?

Chaque fichier qui utilise QBCore en a besoin, sauf si le script le définit une fois dans un fichier partagé chargé avant les autres.

Des scripts sans ce problème

Advanced BoostingDu boosting de véhicules piloté par tablette : contrats de classe D à S+, crews et file d’attente en direct.Voir le script →Clothing DesignerCréez des vêtements dans FiveM — pinceau, calques, import d’images et IA — puis portez-les.Voir le script →Quest CreatorUn éditeur visuel de quêtes et de dialogues PNJ, construit nœud par nœud en jeu.Voir le script →

À lire aussi