attempt to index a nil value (global 'QBCore'): исправление GetCoreObject

QBCore — это nil в вашем скрипте? Старое событие QBCore:GetObject исчезло. Как получить объект ядра с помощью GetCoreObject на QBCore и QBox, и почему он может остаться nil.

attempt to index a nil value (global 'QBCore'): исправление GetCoreObject

Где-то в вашей консоли:

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

QBCore работает, скрипт выглядит нормально, а QBCore остаётся nil. Вот почему, и как это исправить на QBCore и QBox.

Почему QBCore — это nil

Старые QBCore скрипты получали объект ядра через событие:

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

Это событие было удалено из qb-core. Никто больше на него не отвечает, поэтому QBCore остаётся nil и первая строка QBCore.Functions… упаёт.

Исправление: GetCoreObject

Запросите у qb-core его объект через экспорт в верхней части файла:

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

Это одна и та же строка на клиенте и на сервере. Добавьте это в каждый файл, использующий QBCore, или один раз в общий файл, который манифест загружает первым:

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

Совет: если QBCore — local в одном файле, другие файлы его не видят. Ошибка nil только в одном файле скрипта обычно означает именно это.

Всё ещё nil? qb-core не запущен

Экспорт отвечает, только если qb-core стартовал первым. В server.cfg:

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

ensure my_script

Потом:

  • Проверьте запуск qb-core в верхней части консоли сервера. Ошибка базы данных там означает, что экспорты никогда не существуют, и вы получите No such export GetCoreObject in resource qb-core.
  • Добавьте зависимость в fxmanifest.lua скрипта, чтобы FiveM запустил qb-core первым или отказал запуску без него:
lua
dependency 'qb-core'

На QBox

Ядро QBox — это qbx_core, и оно поддерживает слой совместимости для qb-core скриптов: exports['qb-core']:GetCoreObject() всё ещё возвращает объект, поэтому большинство QBCore скриптов работают как есть.

Меняется порядок и имя в server.cfg:

cfg
ensure oxmysql
ensure ox_lib
ensure qbx_core

На QBox нет отдельной папки qb-core. Если она ещё есть — удалите её, иначе два ядра будут конфликтовать.

Для нового кода QBox предпочитает собственные экспорты вместо большой таблицы QBCore, например на сервере:

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

Данные игрока на клиенте

Чтение игрока слишком рано — это ещё один классический nil:

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

Вместо этого дождитесь игрока:

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)

Если скрипт можно перезапустить во время игры, прочитайте данные один раз при старте, потому что OnPlayerLoaded к тому времени уже сработает.

Чек-лист

Симптом Исправление
attempt to index a nil value (global 'QBCore') local QBCore = exports['qb-core']:GetCoreObject() в верхней части файла
Nil только в одном файле QBCore — local в другом файле; определите там же или в общем файле
No such export GetCoreObject qb-core (или qbx_core) не запущен или упал
QBox сервер Сохраните экспорт, запустите qbx_core, удалите старую папку qb-core
job — nil при запуске Дождитесь QBCore:Client:OnPlayerLoaded

Запускаете ESX? Та же проблема описана в ESX — это nil: исправление esx:getSharedObject.

Короткие ответы

Почему QBCore nil в моем скрипте?

Скрипт никогда не получил объект ядра: он использует удалённое событие QBCore:GetObject, определяет QBCore в другом файле или стартует перед qb-core. Используйте local QBCore = exports['qb-core']:GetCoreObject() в верхней части каждого файла.

Работает ли GetCoreObject на QBox?

Да. qbx_core поддерживает слой совместимости для qb-core, поэтому exports['qb-core']:GetCoreObject() всё ещё работает. Для нового кода QBox предпочитает свои экспорты, например exports.qbx_core:GetPlayer(source).

Мне нужно вызывать GetCoreObject в каждом файле?

Каждому файлу, использующему QBCore, нужно, если скрипт не определяет его один раз в общем файле, загруженном перед остальными.

Скрипты без этой проблемы

Advanced BoostingУгон машин на заказ через планшет: контракты от класса D до S+, команды и живая очередь.Смотреть скрипт →Clothing DesignerСоздавайте одежду прямо в FiveM — кисть, слои, импорт изображений и ИИ — и носите её.Смотреть скрипт →Quest CreatorВизуальный редактор квестов и диалогов с NPC — узел за узлом прямо в игре.Смотреть скрипт →

Читайте также