Jobs

A job gives a survivor a role: scavenger, medic, craftsman or trader. Each character has one active job and remembers the grade they reached in every job they have held. Other resources read the job to unlock shops, crafting benches, doors and more.

#How jobs work

• PlayerData.job is the active job: { name, label, grade, payment, isboss, onduty, type }.
• PlayerData.jobs maps every job the character has held to its grade, for example { survivor = 0, medic = 2 }. SetJob records the entry each time.
• Changing job resets onduty to that job's defaultDuty. A saved onduty = false is kept across logins.
• If a character's saved job no longer exists in shared/jobs.lua, they fall back to survivor grade 0 on login.

#Default jobs

#Adding a job

Jobs live in shared/jobs.lua, which is loaded on both server and client. Each entry is:

-- shared/jobs.lua
mechanic = {
    label = 'Mechanic',
    defaultDuty = true,
    offDutyPay = false,
    type = 'crafting',
    grades = {
        [0] = { name = 'Grease Monkey', payment = 40 },
        [1] = { name = 'Mechanic', payment = 80 },
        [2] = { name = 'Workshop Boss', payment = 120, isboss = true },
    },
},

Restart the server after editing jobs. Keep survivor in the table, because it is the fallback job.

#Changing a job

• In code: player.Functions.SetJob(jobName, grade). It returns false if the job or grade does not exist.
• As an admin: /setjob <player> <job> [grade].

Toggle duty with player.Functions.SetDuty(onduty), or with no argument to flip it. A client can toggle its own duty by sending the net event encore:server:toggleDuty.

#Exports and functions

#Events

#Examples

Hire a player as a medic and check their grade later:

local player = exports['en-core']:GetPlayer(source)
if player and player.Functions.SetJob('medic', 1) then
    encore.notify(source, { description = 'You joined the medics.', type = 'success' })
end

-- elsewhere
local data = exports['en-core']:GetPlayer(source).PlayerData
if data.job.name == 'medic' and data.job.onduty and data.job.grade >= 2 then
    -- allow surgery
end

A duty toggle key on the client:

RegisterCommand('duty', function()
    TriggerServerEvent('encore:server:toggleDuty')
end, false)

RegisterNetEvent('encore:client:onDutyUpdate', function(onduty)
    print(onduty and 'On duty' or 'Off duty')
end)

React to job changes on the server:

AddEventHandler('encore:server:onJobUpdate', function(source, job)
    print(('%s is now %s (%s)'):format(GetPlayerName(source), job.label, job.grade))
end)

#Related

• Player data
• Groups
• Compatibility bridges