Konwertuj skrypt ESX na QBCore (i odwrotnie): mapa funkcji i most

Masz skrypt napisany dla ESX i twój serwer uruchamia QBCore, lub odwrotnie. Większość skryptu to zwykły Lua i natives, które się nie zmieniają. Tylko wołania struktury robią, i są mniej niż się spodziewasz. Ten artykuł daje ci mapę, potem pokazuje jak izolować je w jednym pliku mostu.

#Co zostaje i co się zmienia

Natives, NUI, twoje własne zdarzenia, pętle, cele i menu działają na każdej strukturze. Co się zmienia, to krótka lista:

• jak otrzymujesz obiekt struktury
• jak otrzymujesz gracza
• pieniądze, prace i przedmioty
• powiadomienia
• przedmioty użyteczne i callbacki
• tabele bazy danych dla graczy

Wyszukaj w skrypcie ESX. i xPlayer, i każde trafienie to coś do konwersji.

#Mapa funkcji

Dwa szczegóły tripują ludzi. Typy pieniędzy: ESX ma money dla gotówki i bank, QBCore używa 'cash' i 'bank' jako pierwszy argument. I stopień: ESX daje zwykłą liczbę, QBCore tabelę, więc job.grade.level.

Callbacki, które każdy drugi skrypt używa, są porównywane szczegółowo w server callbacks on ESX, QBCore and ox_lib.

#Baza danych

Tabele graczy się różnią, więc każde SELECT lub UPDATE na nich potrzebuje zmianę:

Skrypt, który przechowuje swoje własne dane, z własnymi tabelami, zwykle ciągle działa, dopóki kluczuje wiersze na wartości, którą możesz uzyskać z każdej struktury. Używanie identyfikatora licencji do tego działa na obu.

#QBox

QBox jest bliżej do QBCore niż do ESX. Jego rdzeń to qbx_core, przechowuje warstwę kompatybilności dla exports['qb-core']:GetCoreObject(), i jego inwentarz to ox_inventory. Skrypt konwertowany na QBCore zwykle działa na QBox z kilkoma zmianami, oprócz wołań inwentarza.

#Podejście pliku mostu

Jeśli skrypt musi działać na obu, nie zaśmiecaj go z if ESX then ... else ... end. Włóż każde wołanie struktury w jeden plik i miej resztę skryptu wołającą ten plik.

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

W manifeście, załaduj to przed plikami, które go używają:

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

Skrypt następnie czyta tak, i nigdy nie wspomina struktury:

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

Dodaj most klienta dla powiadomień i danych gracza w ten sam sposób. Gdy dodasz nową strukturę, taką jak QBox z qbx_core, dodajesz gałąź w moście, i skrypt zostaje takim, jaki jest.

Pamiętaj, że most działa tylko jeśli struktura się uruchamia pierwsza. Włóż ensure es_extended lub ensure qb-core ponad skrypt w server.cfg, i przeczytaj ESX is nil, jeśli obiekt wraca nil.

#Lista kontrolna