Cómo añadir un trabajo en QBCore: shared/jobs.lua, grados y /setjob

En QBCore un trabajo es un bloque en un archivo Lua, no una fila de base de datos. Añades el bloque, reinicia el núcleo, y establece el trabajo en un jugador. Esta guía muestra la estructura, el comando, y cómo leer el trabajo en el código, para QBCore y QBox.

#La estructura

Abre qb-core/shared/jobs.lua. Los trabajos son entradas en la tabla QBShared.Jobs, con clave por nombre de trabajo. Añade el tuyo:

['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 },
    },
},

Lo que cada parte significa:

Dos reglas:

• Las claves de grado son cadenas en QBCore: ['0'], ['1']. Comienza en '0' sin brechas.
• Mira los trabajos ya en el archivo, como police, y copia su forma. Algunos trabajos llevan un campo type extra que otros scripts usan para agruparlos, y el archivo muestra lo que tu versión soporta.

Cuidado: una coma o llave faltante en jobs.lua detiene la carga de qb-core, y cada script que depende de él con él.

#Reinicia y establece el trabajo

El núcleo lee el archivo al inicio:

restart qb-core

Luego, como administrador, en el juego o la consola:

/setjob <player id> mechanic 1

Los valores son el id del jugador, la clave de trabajo y el número de grado. Si el comando es rechazado, te falta permisos de administrador: consulta permisos ACE para administradores.

#Lee el trabajo en scripts

En el servidor:

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 contiene name, label, onduty, isboss, payment y una tabla grade con el name y level del rango. Para el número de rango usa job.grade.level.

Para cambiar el trabajo desde el código:

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

Si QBCore es nil aquí, consulta intento de indexar un valor nil (global 'QBCore').

#En el 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)

Leer GetPlayerData().job antes de que el jugador haya cargado da nil, así que espera a OnPlayerLoaded, y mantén el trabajo fresco con OnJobUpdate.

#En QBox

El núcleo de QBox es qbx_core, y el archivo de trabajos es qbx_core/shared/jobs.lua. La estructura es la misma: una etiqueta, defaultDuty, offDutyPay y grades. Abre el archivo y sigue las entradas ya en él, ya que el archivo de QBox puede diferir en detalles como cómo se escriben las claves de grado, y las nuevas versiones pueden añadir campos.

Reinicia qbx_core después de la edición. Para el código, la capa de compatibilidad aún responde a exports['qb-core']:GetCoreObject(), y la propia exportación de QBox es:

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

#Menú de jefe y fondos

Un grado con isboss = true es solo la bandera. El menú que permite al jefe contratar personas y usar la cuenta de la empresa viene de tu recurso de gestión, que generalmente tiene su propia lista de trabajos para configurar. Si el menú de jefe no se abre para tu nuevo trabajo, comprueba ese recurso para el nombre del trabajo.

#Problemas comunes

• Trabajo no encontrado por /setjob. El núcleo no fue reiniciado, o la clave está mal escrita.
• El núcleo falla después de la edición. Un error de sintaxis en jobs.lua. Lee la primera línea roja en la consola, y cómo leer un error de script ayuda con el archivo y la línea.
• La paga no se recibe. offDutyPay = false significa que el jugador debe estar en servicio, y el intervalo de nómina viene de la configuración del núcleo.

#Lista de verificación