Comment ajouter un emploi sur QBCore : shared/jobs.lua, grades et /setjob

Sur QBCore, un emploi est un bloc dans un fichier Lua, pas une ligne de base de données. Vous ajoutez le bloc, redémarrez le noyau, et définissez l'emploi sur un joueur. Ce guide montre la structure, la commande, et comment lire l'emploi dans le code, pour QBCore et QBox.

#La structure

Ouvrez qb-core/shared/jobs.lua. Les emplois sont des entrées dans la table QBShared.Jobs, clé par le nom de l'emploi. Ajoutez le vôtre :

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

Ce que chaque partie signifie :

Deux règles :

• Les clés de grade sont des chaînes sur QBCore : ['0'], ['1']. Commencez à '0' sans lacunes.
• Regardez les emplois déjà dans le fichier, comme police, et copiez leur forme. Certains emplois portent un champ type supplémentaire que d'autres scripts utilisent pour les grouper, et le fichier montre ce que votre version supporte.

Attention : une virgule manquante ou une accolade manquante dans jobs.lua empêche qb-core de charger, et tous les scripts qui en dépendent avec lui.

#Redémarrer et définir l'emploi

Le noyau lit le fichier au démarrage :

restart qb-core

Ensuite, en tant qu'administrateur, dans le jeu ou la console :

/setjob <player id> mechanic 1

Les valeurs sont l'ID du joueur, la clé de l'emploi et le numéro de grade. Si la commande est refusée, vous manquez de permissions d'administrateur : consultez permissions ACE pour les administrateurs.

#Lire l'emploi dans les scripts

Sur le serveur :

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 contient name, label, onduty, isboss, payment et une table grade avec le name et le level du rang. Pour le numéro de rang, utilisez job.grade.level.

Pour modifier l'emploi à partir du code :

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

Si QBCore est nil ici, consultez tentative d'indexer une valeur nil (global 'QBCore').

#Sur le client

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)

Lire GetPlayerData().job avant que le joueur ait chargé donne nil, alors attendez OnPlayerLoaded, et gardez l'emploi à jour avec OnJobUpdate.

#Sur QBox

Le noyau de QBox est qbx_core, et le fichier des emplois est qbx_core/shared/jobs.lua. La structure est la même : une étiquette, defaultDuty, offDutyPay et grades. Ouvrez le fichier et suivez les entrées déjà en place, car le fichier de QBox peut différer dans les détails comme la façon dont les clés de grade sont écrites, et les nouvelles versions peuvent ajouter des champs.

Redémarrez qbx_core après la modification. Pour le code, la couche de compatibilité répond toujours à exports['qb-core']:GetCoreObject(), et l'export propre de QBox est :

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

#Menu de patron et fonds

Un grade avec isboss = true n'est que le drapeau. Le menu qui permet au patron d'embaucher des gens et d'utiliser le compte de l'entreprise provient de votre ressource de gestion, qui a habituellement sa propre liste d'emplois à configurer. Si le menu du patron ne s'ouvre pas pour votre nouvel emploi, vérifiez le config de cette ressource pour le nom de l'emploi.

#Problèmes courants

• Emploi non trouvé par /setjob. Le noyau n'a pas été redémarré, ou la clé est mal orthographiée.
• Le noyau échoue après la modification. Une erreur de syntaxe dans jobs.lua. Lisez la première ligne rouge dans la console, et comment lire une erreur de script aide avec le fichier et la ligne.
• La paie n'est pas reçue. offDutyPay = false signifie que le joueur doit être en service, et l'intervalle de paie provient de la config du noyau.

#Liste de contrôle