esx_joblisting

esx_joblisting is the job center: a map marker that opens a NUI where players browse non-whitelisted jobs, read a description, set a waypoint, apply, or quit to unemployed. It also exposes a small task and progress API that other job scripts can use to show goals in the UI.

OverviewCopy Anchor Link

Which jobs appear is controlled by the database, not by the config: every job with whitelisted = false that has a grade 0 is listed. Config.JobDetails only adds text, images and tasks to those cards.

InstallationCopy Anchor Link

ALTER TABLE jobs add whitelisted BOOLEAN NOT NULL DEFAULT FALSE;

ensure es_extended
ensure esx_lib
ensure esx_joblisting

UPDATE jobs SET whitelisted = 1 WHERE name IN ('police', 'ambulance', 'mechanic');

ConfigurationCopy Anchor Link

Config.JobDetailsCopy Anchor Link

Keyed by job name. Every field is optional.

Config.JobDetails.taxi = {
    subtitle = 'Drive the city',
    rating = 2,
    requirement = 'Driver license',
    location = { x = 903.3, y = -170.5 },
    description = 'Pick up passengers at the depot and drive them anywhere in Los Santos.',
}

ExportsCopy Anchor Link

UpdateJobProgress (server)Copy Anchor Link

Stores stats and tasks for a job in the player's metadata (joblisting key) and pushes the updated profile to the client.

exports.esx_joblisting:UpdateJobProgress(playerId, jobName, data)

Returns true on success, false when the player is not loaded or the arguments have the wrong type. Invalid entries are dropped silently.

local function rewardRock(playerId, mined)
    exports.esx_joblisting:UpdateJobProgress(playerId, 'miner', {
        stats = { rocks = mined },
        tasks = {
            { title = 'Extract mineral rock', description = 'Break rocks from active quarry veins.', current = mined, target = 40 },
        },
    })
end

ShowTasks (client)Copy Anchor Link

exports.esx_joblisting:ShowTasks(tasks, grade)

HideTasks (client)Copy Anchor Link

exports.esx_joblisting:HideTasks()

ShowTaskProgress (client)Copy Anchor Link

Shows a toast with a progress bar for 5 seconds.

exports.esx_joblisting:ShowTaskProgress({ title = 'Deliver processed sacks', current = 3, target = 10 })

Server callbacksCopy Anchor Link

EventsCopy Anchor Link

Common issuesCopy Anchor Link

• Police or EMS show up in the list. Their whitelisted value is 0. See the installation steps.
• A job is missing. It needs whitelisted = 0 and a grade 0 row in job_grades.
• Menu opens and closes immediately with an error. The server did not confirm you are near a zone. Make sure Config.Zones matches the marker you are standing on, and do not move Config.DrawDistance below the marker size.
• Card has no picture. Add image in Config.JobDetails and put the file in web/assets/. It is covered by the web/assets/* files entry.

RelatedCopy Anchor Link

• esx_jobs
• esx_whitelist
• Create a job
• Database schema

Frequently asked questions