mri_Qjobcenter — Manual

Central de empregos com NPC e interface NUI: o jogador escolhe um trabalho da lista, é contratado na hora e pode marcar no GPS o local onde o trabalho começa.

Sumário

1. Dependências
2. Instalação
3. Configuração
4. Vagas
5. Integrações
6. Entrypoints para outros recursos
7. Estrutura de arquivos

Dependências

Escolha um dos três modos de interação em Config.Main.useTarget. Com 'lib', nenhum recurso de target é necessário.

Instalação

1. Copie a pasta mri_Qjobcenter para resources/.
2. Adicione ao server.cfg:

   ensure mri_Qjobcenter
3. Ajuste Config.Main.useTarget no config.lua para o target que o seu servidor usa ('qb', 'ox' ou 'lib').
4. Garanta que todos os rank listados em Config.Jobs existem como jobs no qb-core — o servidor chama Player.Functions.SetJob(rank, 0) sem validar contra a lista de jobs do core.

Configuração

O config.lua roda apenas no servidor (está em server_scripts). O cliente recebe uma cópia do Config por evento, então mudanças exigem restart do recurso.

Config.Main

Config.Main.Locations[<chave>]

Config.Jobs[]

Uma entrada por vaga exibida na interface.

Config.tagColors

Lista de classes Tailwind aplicadas às tags dos cards, na ordem em que aparecem. Padrão: bg-emerald-400, bg-cyan-400, bg-orange-400.

Config.Licenses

Está inteiramente comentado no config.lua. O sv_main.lua ainda tem o ramo que vende licenças (data.type == 'license'), mas ele depende de Config.Licenses existir. Enquanto o bloco estiver comentado, o fluxo de licenças não funciona.

Vagas

As vagas que vêm configuradas por padrão:

Existe uma nona vaga (trucker, Motorista de Caminhão) comentada no config.lua.

O ponto de atendimento padrão fica em -269.19, -956.09, 31.22 (heading 206.34), com blip desativado.

Integrações

qb-target / ox_target / ox_lib

O modo é escolhido em Config.Main.useTarget:

• 'qb' — exports['qb-target']:AddTargetEntity no ped, distância 1.5.
• 'ox' — exports.ox_target:addLocalEntity no ped, distância 3.0.
• 'lib' — lib.zones.box de 3x3x1 na posição do ped, com lib.showTextUI('[E] City Hall') e abertura no E.

pickle_waypoints

Quando o jogador clica para marcar o local do trabalho, o servidor dispara pickle_waypoints:addWaypoint no cliente com o nome da vaga e o location configurado. Sem o pickle_waypoints, o jogador ainda recebe a notificação de sucesso, mas nenhum waypoint aparece.

Entrypoints para outros recursos

Evento ss-jobcenter:server:openJobCenter (servidor)

Abre a interface para o jogador que disparou o evento. É o evento usado pelos três modos de target.

TriggerServerEvent('ss-jobcenter:server:openJobCenter')

Evento ss-jobcenter:server:setup (servidor)

Reenvia a configuração ao cliente, que recria os peds e as zonas. Disparado automaticamente no QBCore:Client:OnPlayerLoaded e no start do recurso.

TriggerServerEvent('ss-jobcenter:server:setup')

Evento ss-jobcenter:server:select (servidor)

Processa a escolha feita na interface. O servidor exige que o jogador esteja a menos de 3,5m de um Locations.

-- contratar
TriggerServerEvent('ss-jobcenter:server:select', { type = 'job', job = 'taxi' })
 
-- marcar o local do trabalho no mapa
TriggerServerEvent('ss-jobcenter:server:select', { type = 'loc', job = 'taxi' })

Há ainda type = 'license', que depende de Config.Licenses (comentado por padrão).

Estrutura de arquivos

mri_Qjobcenter/
├── client/
│   └── cl_main.lua       — cria o ped e o target/zona, abre a NUI, encaminha as callbacks de seleção
├── server/
│   └── sv_main.lua       — envia o Config ao cliente, valida a distância, contrata (SetJob) e marca o waypoint
├── config.lua            — Config.Main (localização e modo de target), Config.Jobs (vagas), Config.tagColors
├── html/
│   ├── index.html        — interface da central de empregos
│   ├── script.js         — lógica da interface e callbacks NUI
│   ├── style.css         — estilos
│   └── img/              — imagens dos cards das vagas e das licenças
└── fxmanifest.lua