Преобразование ESX скрипта в QBCore (и обратно): карта функций и мост

У вас есть скрипт, написанный для ESX, и ваш сервер запускает QBCore, или наоборот. Большинство скрипта — это простой Lua и natives, которые не меняются. Только вызовы фреймворка, и их меньше, чем вы ожидаете. Эта статья даёт вам карту их, а затем показывает, как изолировать их в один файл моста.

#Что остаётся и что меняется

Natives, NUI, ваши собственные события, циклы, targets и меню работают на любом фреймворке. Что меняется, так это короткий список:

• как вы получаете объект фреймворка
• как вы получаете игрока
• деньги, работы и предметы
• уведомления
• используемые предметы и обратные вызовы
• таблицы базы данных для игроков

Ищите в скрипте ESX. и xPlayer, и каждое попадание — это что-то для преобразования.

#Карта функций

Два деталя сбивают людей с толку. Типы денег: ESX имеет money для наличных и bank, QBCore использует 'cash' и 'bank' как первый аргумент. И уровень: ESX даёт простое число, QBCore таблицу, поэтому job.grade.level.

Обратные вызовы, которые использует каждый второй скрипт, сравниваются в деталях в server callbacks on ESX, QBCore and ox_lib.

#База данных

Таблицы игроков отличаются, поэтому любой SELECT или UPDATE на них требует изменения:

Скрипт, который хранит свои собственные данные, с его собственными таблицами, обычно продолжает работать, пока он ключирует строки на значение, которое вы можете получить от любого фреймворка. Использование license идентификатора для этого работает на обоих.

#QBox

QBox ближе к QBCore, чем к ESX. Его ядро — qbx_core, оно содержит слой совместимости для exports['qb-core']:GetCoreObject(), и его инвентарь — ox_inventory. Скрипт, преобразованный в QBCore, обычно запускается на QBox с небольшими изменениями, кроме вызовов инвентаря.

#Подход файла моста

Если скрипт должен работать на обоих, не размещайте его if ESX then ... else ... end. Поместите каждый вызов фреймворка в один файл, и пусть остальной скрипт вызывает этот файл.

-- bridge.lua (server)
Bridge = {}

local framework
if GetResourceState('es_extended') == 'started' then
    framework = 'esx'
    ESX = exports['es_extended']:getSharedObject()
elseif GetResourceState('qb-core') == 'started' then
    framework = 'qb'
    QBCore = exports['qb-core']:GetCoreObject()
end

function Bridge.GetPlayer(src)
    if framework == 'esx' then return ESX.GetPlayerFromId(src) end
    return QBCore.Functions.GetPlayer(src)
end

function Bridge.AddCash(src, amount)
    local player = Bridge.GetPlayer(src)
    if not player then return false end

    if framework == 'esx' then
        player.addMoney(amount)
    else
        player.Functions.AddMoney('cash', amount)
    end
    return true
end

function Bridge.GetJob(src)
    local player = Bridge.GetPlayer(src)
    if not player then return nil end

    if framework == 'esx' then
        return player.job.name, player.job.grade
    end
    return player.PlayerData.job.name, player.PlayerData.job.grade.level
end

В манифесте, загрузите его перед файлами, которые его используют:

server_scripts {
    'bridge.lua',
    'server.lua',
}

Затем скрипт читается так и никогда не упоминает фреймворк:

RegisterNetEvent('my_script:pay', function()
    local src = source
    local job = Bridge.GetJob(src)
    if job == 'mechanic' then
        Bridge.AddCash(src, 100)
    end
end)

Добавьте клиентский мост для уведомлений и данных игрока так же. Когда вы добавляете новый фреймворк, такой как QBox с qbx_core, вы добавляете ветвь в мост, и скрипт остаётся так же.

Помните, что мост работает только если фреймворк запускается первым. Поместите ensure es_extended или ensure qb-core выше скрипта в server.cfg, и читайте ESX is nil, если объект приходит обратно nil.

#Контрольный список