Como adicionar um job em QBCore: shared/jobs.lua, grades e /setjob

Em QBCore um job é um bloco em um arquivo Lua, não uma linha de banco de dados. Você adiciona o bloco, reinicia o core, e define o job em um jogador. Este guia mostra a estrutura, o comando, e como ler o job em código, para QBCore e QBox.

#A estrutura

Abra qb-core/shared/jobs.lua. Jobs são entradas na tabela QBShared.Jobs, com chave pelo nome do job. Adicione o seu:

['mechanic'] = {
    label = 'Mechanic',
    defaultDuty = true,
    offDutyPay = false,
    grades = {
        ['0'] = { name = 'Recruit', payment = 50 },
        ['1'] = { name = 'Mechanic', payment = 75 },
        ['2'] = { name = 'Boss', payment = 120, isboss = true },
    },
},

O que cada parte significa:

Duas regras:

• Chaves de grade são strings em QBCore: ['0'], ['1']. Comece em '0' sem gaps.
• Olhe os jobs já no arquivo, como police, e copie sua forma. Alguns jobs carregam um campo extra type que outros scripts usam para agrupá-los, e o arquivo mostra o que sua versão suporta.

Atenção: uma vírgula faltando ou brace em jobs.lua impede qb-core de carregar, e cada script que depende com ele.

#Reinicie e defina o job

O core lê o arquivo ao iniciar:

restart qb-core

Depois, como um admin, no jogo ou no console:

/setjob <player id> mechanic 1

Os valores são o id do jogador, a chave do job e o número de grade. Se o comando é recusado, você não tem permissões de admin: veja ACE permissions for admins.

#Leia o job em scripts

No server:

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

RegisterNetEvent('my_script:doWork', function()
    local src = source
    local Player = QBCore.Functions.GetPlayer(src)
    if not Player then return end

    local job = Player.PlayerData.job
    if job.name ~= 'mechanic' then
        return TriggerClientEvent('QBCore:Notify', src, 'You are not a mechanic', 'error')
    end

    if not job.onduty then
        return TriggerClientEvent('QBCore:Notify', src, 'Go on duty first', 'error')
    end

    -- allowed
end)

Player.PlayerData.job contém name, label, onduty, isboss, payment e uma tabela grade com o name do rank e level. Para o número de rank use job.grade.level.

Para mudar o job de código:

Player.Functions.SetJob('mechanic', 1)

Se QBCore é nil aqui, veja attempt to index a nil value (global 'QBCore').

#No cliente

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)

Ler GetPlayerData().job antes do jogador ter carregado dá nil, então espere por OnPlayerLoaded, e mantenha o job fresco com OnJobUpdate.

#Em QBox

O core de QBox é qbx_core, e o arquivo de jobs é qbx_core/shared/jobs.lua. A estrutura é a mesma: um label, defaultDuty, offDutyPay e grades. Abra o arquivo e siga as entradas já nele, já que o arquivo de QBox pode diferir em detalhes como como as chaves de grade são escritas, e novas versões podem adicionar campos.

Reinicie qbx_core após o edit. Para código, a compatibility layer ainda responde exports['qb-core']:GetCoreObject(), e o export próprio de QBox é:

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

#Menu de boss e fundos

Uma grade com isboss = true é apenas a flag. O menu que deixa o boss contratar pessoas e usar a conta da empresa vem do seu resource de management, que usualmente tem sua própria lista de jobs para configurar. Se o menu de boss não abre para seu novo job, verifique aquele resource's config para o nome do job.

#Problemas comuns

• Job não encontrado por /setjob. O core não foi reiniciado, ou a chave está errada.
• Core falha após o edit. Um erro de sintaxe em jobs.lua. Leia a primeira linha vermelha no console, e how to read a script error ajuda com o arquivo e linha.
• Pay não é recebido. offDutyPay = false significa que o jogador deve estar on duty, e o intervalo de paycheck vem da config do core.

#Checklist