Script de Jobs FiveM — Sistema de Empregos Roleplay

Configure empregos no seu servidor FiveM com hierarquia de cargos, salários automáticos, turnos e ações exclusivas por função para roleplay.

O módulo de Jobs adiciona um sistema completo de empregos ao seu servidor FiveM. Cada emprego tem hierarquia de cargos, salário configurável, ações exclusivas para membros e integração com outros módulos como Economia e Inventário.

Funcionalidades

• Criação ilimitada de empregos via configuração
• Hierarquia de cargos (grades) com permissões individuais
• Salários automáticos por período configurável
• Ponto de trabalho (check-in/check-out) com blip no mapa
• Ações exclusivas para membros do emprego
• Integração com Economia para pagamento de salário
• Compatível com ESX e QBCore

Configuração de Empregos

Defina seus empregos no config.lua. Cada emprego recebe uma chave única, um nome de exibição e um conjunto de cargos (grades) com salários individuais. O cargo com isboss = true tem acesso ao menu de gerenciamento do emprego.

config.lua

Config.Jobs = {
    ['police'] = {
        label = 'Polícia Militar',
        defaultDuty = false,       -- Inicia fora de serviço
        grades = {
            [0] = { label = 'Recruta',   salary = 200 },
            [1] = { label = 'Cabo',      salary = 300 },
            [2] = { label = 'Sargento',  salary = 450 },
            [3] = { label = 'Tenente',   salary = 600 },
            [4] = { label = 'Capitão',   salary = 800, isboss = true },
        },
    },
    ['mechanic'] = {
        label = 'Mecânico',
        defaultDuty = true,        -- Inicia em serviço automaticamente
        grades = {
            [0] = { label = 'Aprendiz', salary = 150 },
            [1] = { label = 'Mecânico', salary = 250 },
            [2] = { label = 'Chefe',    salary = 400, isboss = true },
        },
    },
}

Configuração de Salários

Controle quando e como os salários são pagos. O campo requireDuty garante que somente membros que entraram em serviço com /duty recebam o pagamento.

config.lua

Config.SalaryConfig = {
    interval    = 30,       -- Intervalo de pagamento em minutos
    requireDuty = true,     -- Exige estar em serviço para receber
    paymentType = 'bank',   -- 'bank' para conta bancária ou 'cash' para dinheiro em mãos
    minOnDuty   = 1,        -- Mínimo de jogadores em serviço para o pagamento ocorrer
}

Configuração do Ponto de Trabalho

Configure o local de check-in no mapa para cada emprego. O ponto duty é onde o jogador usa /duty; o ponto boss abre o menu de gerenciamento disponível apenas para o cargo chefe.

config.lua

Config.JobLocations = {
    ['police'] = {
        duty = vector3(441.1, -982.1, 30.7),   -- Local para /duty
        boss = vector3(440.0, -975.6, 30.7),    -- Acesso ao menu de chefe
        blip = { sprite = 60, color = 29, label = 'Polícia' },
    },
}

Comandos do Módulo Jobs

Comando	Permissão	Descrição
/duty	Membro do job	Entra ou sai de serviço
/setjob [id] [job] [grade]	jobs.admin	Define o emprego de um jogador
/jobmenu	Membro do job	Abre o menu do emprego
/payday	jobs.admin	Força pagamento de salários imediato

O comando /duty só está disponível quando Config.EnableDuty = true no config.lua. Se essa opção estiver desativada, todos os membros são considerados em serviço o tempo todo.

API — Integrações via Exports e Eventos

Use os exports abaixo em outros recursos para interagir com o módulo de Jobs.

Obter o Emprego de um Jogador (servidor)

local jobData = exports['jobs']:GetPlayerJob(source)
-- Retorna: { name = 'police', label = 'Polícia Militar', grade = 2, gradeLabel = 'Sargento', salary = 450 }

Definir o Emprego de um Jogador (servidor)

exports['jobs']:SetPlayerJob(source, 'mechanic', 1)
-- Parâmetros: source (ID do jogador), jobName (string), grade (número)

Evento disparado ao trocar de emprego (cliente)

AddEventHandler('jobs:onJobChanged', function(newJob, oldJob)
    -- newJob e oldJob são tabelas com name, label, grade e gradeLabel
    print('Novo emprego: ' .. newJob.label)
end)

Evento disparado ao entrar/sair de serviço (cliente)

AddEventHandler('jobs:onDutyChanged', function(onDuty)
    -- onDuty: true (entrou em serviço) ou false (saiu de serviço)
    if onDuty then
        print('Você entrou em serviço.')
    end
end)

Resolução de Problemas

Problema	Causa provável	Solução
Salário não é pago	requireDuty = true e jogador não está em serviço	Use /duty para entrar em serviço antes do intervalo de pagamento
/duty não aparece	Config.EnableDuty = false	Ative Config.EnableDuty = true no config.lua
Menu de chefe indisponível	Cargo sem isboss = true ou localização não configurada	Adicione isboss = true ao cargo e configure boss em Config.JobLocations
Emprego não aparece para o jogador	Emprego não cadastrado em Config.Jobs	Verifique a chave do emprego e reinicie o recurso após salvar