esx_jobs

esx_jobs provides simple gather-process-sell jobs: put on work clothes, take a company truck for a deposit, stand in work zones to receive raw items, process them in the next zones, and sell the final product for cash. Use it for starter jobs, or as a data-driven framework for your own farming-style jobs.

OverviewCopy Anchor Link

Job chainsCopy Anchor Link

Money from deliveries is paid as cash (xPlayer.addMoney).

InstallationCopy Anchor Link

ensure esx_addonaccount
ensure esx_jobs

ConfigurationCopy Anchor Link

config.lua holds the global options. Each job lives in its own file under jobs/ and adds itself to Config.Jobs.

Job file formatCopy Anchor Link

Config.Jobs.miner = {
    BlipInfos = { Sprite = 68, Color = 5 },

    Vehicles = {
        Truck = { Spawner = 1, Hash = 'rubble', Trailer = 'none', HasCaution = true },
    },

    Zones = {
        Mine = {
            Pos = { x = 2962.40, y = 2746.20, z = 42.39 },
            Size = { x = 5.0, y = 5.0, z = 1.0 },
            Color = { r = 50, g = 200, b = 50 },
            Marker = 1,
            Blip = true,
            Name = TranslateCap('m_rock'),
            Type = 'work',
            Item = {
                {
                    name = TranslateCap('m_rock'),
                    db_name = 'stone',
                    time = 3,
                    max = 7,
                    add = 1,
                    remove = 0,
                    requires = 'nothing',
                    requires_name = 'Nothing',
                    drop = 100,
                },
            },
            Hint = TranslateCap('m_pickrocks'),
            GPS = { x = 289.24, y = 2862.90, z = 42.64 },
        },
        -- cloakroom, vehspawner, vehspawnpt, vehdelete and delivery zones follow
    },
}

Zone typesCopy Anchor Link

Zones, spawners and vehicles are linked through the same Spawner number. The fisherman uses Spawner = 2 for the boat and its delivery point.

Item entriesCopy Anchor Link

The first entry drives the timing and the required input. Extra entries in the same zone, like iron, gold and diamond in the miner foundry, are extra outputs from the same input.

VehiclesCopy Anchor Link

Vehicle deposit (caution)Copy Anchor Link

When a player uses a vehspawner zone, the server takes Caution from their bank account and stores it in their personal caution addon account, then spawns the vehicle. When they return it in the vehdelete zone, the refund is the deposit multiplied by the vehicle condition: (engine health + body health) / 2000. A destroyed vehicle refunds nothing.

Outstanding deposits are settled automatically when the player changes job, disconnects or the resource stops.

Server eventsCopy Anchor Link

The server looks up zones from its own config by job and key, never from client data, and stops the work loop as soon as the player is farther from the zone center than the zone's Size.x. Deposit amounts are read from the config and capped by Config.MaxCaution.

Client eventsCopy Anchor Link

Common issuesCopy Anchor Link

• Work zone does nothing. Put on the work clothes at the cloakroom first, and step out of your vehicle. Work zones only run on foot.
• "Not enough" right away. The zone requires an input item. Process the previous step first.
• Reporter job has no markers. reporter exists in the SQL and has a public teleport building, but no file under jobs/.
• Deposit not taken or vehicle not spawned. The player needs enough money in the bank, the spawn point must be free, and esx_addonaccount must be running so the caution account exists.
• Items show French names. Update the labels in the items table.

RelatedCopy Anchor Link

• esx_joblisting
• esx_addonaccount
• Create a job
• Add items

Frequently asked questions