Script de Jobs FiveM — Sistema de Empregos 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

Introdução

Guias

Scripts

Referência

Suporte

Script de Jobs FiveM — Sistema de Empregos Roleplay

Funcionalidades

Configuração de Empregos

Configuração de Salários

Configuração do Ponto de Trabalho

Comandos do Módulo Jobs

API — Integrações via Exports e Eventos

Obter o Emprego de um Jogador (servidor)

Definir o Emprego de um Jogador (servidor)

Evento disparado ao trocar de emprego (cliente)

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

Resolução de Problemas

​Funcionalidades

​Configuração de Empregos

​Configuração de Salários

​Configuração do Ponto de Trabalho

​Comandos do Módulo Jobs

​API — Integrações via Exports e Eventos

​Obter o Emprego de um Jogador (servidor)

​Definir o Emprego de um Jogador (servidor)

​Evento disparado ao trocar de emprego (cliente)

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

​Resolução de Problemas

Funcionalidades

Configuração de Empregos

Configuração de Salários

Configuração do Ponto de Trabalho

Comandos do Módulo Jobs

API — Integrações via Exports e Eventos

Obter o Emprego de um Jogador (servidor)

Definir o Emprego de um Jogador (servidor)

Evento disparado ao trocar de emprego (cliente)

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

Resolução de Problemas