Jobs framework: clock-in, grades, paychecks

A job is a tiny state machine: off-duty or on-duty, plus a grade that decides what the player may do, plus a paycheck that lands on a clock while they are on duty. This lesson builds that spine as a server-side resource that detects whichever framework you run, reads the player's job and grade, toggles duty, gates a high-grade action, and pays on a timer. It does not depend on any one framework's UI.

You will learn: Duty state machine, framework detection, reading job and grade, a payroll loop, and an audit print.
Time: ~35 min
Project: qu_jobs_framework

Cruze: building a job center script from zero.

BEFORE YOU START

Build it

Make the resource folder

The server has one folder for this lesson.

Inside your server's resources folder, create this folder:

code

resources/qu_jobs_framework

-- qu_jobs_framework: a framework-agnostic job spine. -- Reads job + grade from whichever framework is running, toggles duty, -- gates one grade-locked action, and pays players on a clock. local duty = {} -- duty[src] = true|false, keyed by server id local PAY_INTERVAL_MS = 60000 -- pay every 60 seconds while on duty local BOSS_GRADE = 2 -- minimum grade.level allowed to run /jobaudit -- Return a normalised { name, grade, label } for the player on src, -- regardless of which framework is installed. nil if no player is found. local function getJob(src) if GetResourceState('qbx_core') == 'started' then local player = exports.qbx_core:GetPlayer(src) if not player then return nil end local job = player.PlayerData.job return { name = job.name, grade = job.grade.level, label = job.grade.name } elseif GetResourceState('qb-core') == 'started' then local QBCore = exports['qb-core']:GetCoreObject() local player = QBCore.Functions.GetPlayer(src) if not player then return nil end local job = player.PlayerData.job return { name = job.name, grade = job.grade.level, label = job.grade.name } elseif GetResourceState('es_extended') == 'started' then local ESX = exports.es_extended:getSharedObject() local player = ESX.GetPlayerFromId(src) if not player then return nil end local job = player.getJob() return { name = job.name, grade = job.grade, label = job.grade_label } end return nil end RegisterCommand('clockin', function(src) local job = getJob(src) if not job then print(('[qu_jobs_framework] %s has no framework player (are you a loaded character?)'):format(GetPlayerName(src))) return end duty[src] = not duty[src] print(('[qu_jobs_framework] %s job %s grade %d (%s) duty %s'):format( GetPlayerName(src), job.name, job.grade, job.label, tostring(duty[src]) )) end, false) -- Grade-gated action: only a player at BOSS_GRADE or higher may run it. RegisterCommand('jobaudit', function(src) local job = getJob(src) if not job then return end if job.grade < BOSS_GRADE then print(('[qu_jobs_framework] %s denied /jobaudit (grade %d < %d)'):format(GetPlayerName(src), job.grade, BOSS_GRADE)) return end print(('[qu_jobs_framework] %s ran /jobaudit as %s grade %d'):format(GetPlayerName(src), job.name, job.grade)) end, false) -- Payroll loop: every interval, pay everyone currently on duty. CreateThread(function() while true do Wait(PAY_INTERVAL_MS) for src, onDuty in pairs(duty) do if onDuty then local job = getJob(src) if job then local pay = 50 + (job.grade * 25) -- base + grade bonus print(('[qu_jobs_framework] payroll: %s (%s grade %d) earned $%d'):format( GetPlayerName(src), job.name, job.grade, pay )) end end end end end) -- Clear duty state when a player leaves, or the table leaks server ids forever. AddEventHandler('playerDropped', function() duty[source] = nil end)

Jobs framework: clock-in, grades, paychecks

Build it

Make the resource folder

Create the files

Write fxmanifest.lua

Write the lesson code

Start and test it

Keep reading the full lesson