API Reference

Reference for developers integrating another resource with oxide-postaljob. Everything here is a server-side export; there are no client exports. If you just run the resource as a server owner, you don't need anything on this page.

Server Exports

All exports are called on the server.

IsOnShift

Tells you whether a player is currently on a GoPostal shift. Use it to stop a player from starting another job while they're already working this one.

local onShift = exports['oxide-postaljob']:IsOnShift(source)

Parameters:

Returns: boolean — true from the moment the player clocks in until the shift ends, whether they clock out, log out or disconnect. false otherwise, including for an id that isn't a player.

A player who joined someone else's shift through a crew invite counts as on shift too.

GetSetting

Reads one of the resource's database-backed settings, keyed by the setting name without the Config. prefix.

local maxSlots = exports['oxide-postaljob']:GetSetting('MaxSlotsPerLocation')

Parameters: key (string) — the setting name.

Returns: any — the current value.

SetSetting

Changes one of the resource's settings.

local ok = exports['oxide-postaljob']:SetSetting('uniformsEnabled', true)

Parameters: key (string), value (any) — the setting name and its new value.

Returns: boolean — true when the change was applied. The change is live: the server uses it right away, it saves to the database, and it syncs to clients. It persists across restarts.

Returns false if the resource hasn't finished loading its settings yet, or if the value can't be stored (for example, a number that isn't finite).

See How Settings Work for how database-backed settings behave.

GetInfo

The depots, whether each one has room for another worker, and the base pay. Read-only.

local info = exports['oxide-postaljob']:GetInfo()

Returns: table — with these fields:

GetShift

A player's shift as the job holds it right now. Read-only.

local shift = exports['oxide-postaljob']:GetShift(source)

Parameters: source (number) — the player's server id.

Returns: table|false — false when the player is not on a shift; otherwise a table with these fields:

GetProgression

A player's level with this job. Read-only: a character who has never worked the job reads as level 1, and no record is created.

local progression = exports['oxide-postaljob']:GetProgression(source)

Parameters: source (number) — the player's server id.

Returns: table|false — false when the player has no character; otherwise a table with these fields:

SetUpdateHandler

Lets another resource, such as a phone app, show this job's shift updates itself. The updates are the messages the job sends to the player's phone when usePhone is on.

While a handler is set and its resource is running, each update goes to the handler first. When the handler returns true, the job sends nothing else; when it returns anything else or fails, the job sends the update as usual. There is one handler at a time: setting one replaces the last.

exports['oxide-postaljob']:SetUpdateHandler(function(source, update)
    -- update.title: the sender, for example "GoPostal - GoPostal Depot"
    -- update.message: the message
    -- update.summary: { jobs, net } on the pay summary at the end of a shift
    return true -- shown; the job sends nothing else
end)

Parameters: handler (function or nil) — called as handler(source, update). Passing nil removes the handler your resource set; it is also removed when your resource stops.

Returns: boolean — true, or false when nil would remove another resource's handler (that handler stays).

Integration Examples

Stop a player from working two jobs at once

Check before your own job lets the player clock in:

RegisterNetEvent('my-job:server:clockIn', function()
    local src = source
    if GetResourceState('oxide-postaljob') == 'started'
        and exports['oxide-postaljob']:IsOnShift(src) then
        -- tell the player to finish their GoPostal shift first
        return
    end
    -- start your job
end)

Check every gig job at once

The same IsOnShift(source) export exists on oxide-postaljob, oxide-pizzajob (Pizza Job), oxide-landscapingjob (Landscaping), oxide-roadsideassistancejob (Roadside Assistance), oxide-animalcontroljob (Animal Control) and oxide-newspaperjob (Newspaper). Skip any you don't run:

local GIG_JOBS = {
    'oxide-postaljob',
    'oxide-pizzajob',
    'oxide-landscapingjob',
    'oxide-roadsideassistancejob',
    'oxide-animalcontroljob',
    'oxide-newspaperjob',
}

local function isOnGigShift(src)
    for _, resource in ipairs(GIG_JOBS) do
        if GetResourceState(resource) == 'started' and exports[resource]:IsOnShift(src) then
            return true
        end
    end
    return false
end

Next Steps