📥Deliveries

• Adding more delivery locations to the resource is easily achieved by adding an addition to Config.Jobdeliveries in the deliveries.lua file

• The vehicle plate MUST be a MAXIMUM OF 4 CHARACTERS e.g. ATOM or BURG

---

Location Name

• The key is the location name and must match throughout

--delivery settings per job delivery location
Config.JobDeliveries = {
    ['Example Job Delivery Location'] = { -- the key is the location name and must match throughout
        ---
    },
}

---

General Settings

• Define various core settings for each delivery location

• minRank is the minimum job rank required to start deliveries

• maxDeliveries is the minimum and maximum amount of deliveries that will populate the list each time

• refreshTimer is the time in minutes before the delivery list is refreshed once all deliveries are completed

• uniqueDeliveries determines whether a players delivery list is unique to them or shared between employees

• coords is the delivery vehicle spawn coords and must be vector4

• name is the spawn name of the vehicle you wish to use for deliveries

• The vehicle plate MUST be a MAXIMUM OF 4 CHARACTERS e.g. ATOM or BURG

--delivery settings per job delivery location
Config.JobDeliveries = {
    ['Example Job Delivery Location'] = { -- the key is the location name and must match throughout
        settings = {
            minRank = 1, -- minimum job rank required to do deliveries
            maxDeliveries = {min = 3, max = 6}, -- maximum amount of deliveries available in the menu before having to wait for refresh
            refreshTimer = 5, -- time in minutes before the delivery menu refreshes and allows new deliveries if all deliveries are completed
            uniqueDeliveries = true, -- should each job member have their own delivery list or should it be grouped up and synced between players? i.e if one player does a delivery another player will also see that removed from the list, if set to unique each player will have their own list
            vehicle = { -- delivery vehicle settings
                coords = vector4(88.0, 309.3, 110.02, 161.02), -- spawn coords for vehicle
                name = 'panto', -- vehicle spawn name
                plate = 'ATOM', -- number plate for vehicle (the rest of the plate will be randomised make sure there are ALWAYS 4 slots available to create the rest of the 8 character plate)
            },
        },
        ---
    },
}

---

Ped Models

• Define ped models that can be spawned as the delivery ped for players to interact with

• Please note customer names are generated at random and as a result may not match the gender of the ped spawned

• Ped models can be found here: https://docs.fivem.net/docs/game-references/ped-models/

--delivery settings per job delivery location
Config.JobDeliveries = {
    ['Example Job Delivery Location'] = { -- the key is the location name and must match throughout
        ---
        peds = { -- ped models - one is selected at random for each delivery
            `a_m_m_hillbilly_01`,
            `a_m_m_fatlatin_01`,
            `a_m_m_soucent_02`,
            `a_f_m_tramp_01`,
            `a_f_m_bevhills_01`,
            --add more ped models as required
        },
        ---
    },
}

---

Ped Coords

• Define delivery ped spawn coords

• These coords must be vector4 and are selected at random for each delivery generated

--delivery settings per job delivery location
Config.JobDeliveries = {
    ['Example Job Delivery Location'] = { -- the key is the location name and must match throughout
        ---
        coords = { -- ped spawn locations - one is selected at random for each delivery (must be vector4)
            vector4(-509.73, -22.38, 45.61, 34.49),
            vector4(-243.21, 169.38, 75.97, 274.06),
            vector4(-448.6, -132.49, 39.08, 122.59),
            vector4(-258.62, -842.02, 31.42, 151.18),
            vector4(166.79, -1553.64, 29.26, 217.02),
            vector4(386.15, -1882.59, 25.6, 228.37),
            vector4(1193.54, -1622.47, 45.22, 156.03),
            vector4(1450.97, -1720.61, 68.7, 129.2),
            vector4(182.82, -2027.62, 18.27, 175.65),
            vector4(-521.05, -2196.46, 6.39, 320.29),
            --add more spawn coords as required
        },
        ---
    },
}

---

Rewards & Payments

• Define the payment type for the delivery location either cash or bank

• Enabled tips if required and define the tip chance and min and max amount receieved from each delivery

--delivery settings per job delivery location
Config.JobDeliveries = {
    ['Example Job Delivery Location'] = { -- the key is the location name and must match throughout
        ---
        rewards = { -- rewards settings
            payment = 'cash', -- payment type for deliveries
            tip = { -- tip settings
                enabled = true, -- set to true to enable tips
                chance = 25, -- chance to get a tip for delivering an order
                amount = {min = 10, max = 25}, -- min and max tip amounts
            },
        },
        ---
    },
}

---

Delivery Order Items

• Define items for each order. Orders can be multiple items or just a single one

• The name is the item name

• Define the min & max amount for each item in the order

• Define the min & max payment amount for each item in the order

--delivery settings per job delivery location
Config.JobDeliveries = {
    ['Example Job Delivery Location'] = { -- the key is the location name and must match throughout
        ---
        items = { -- list of orders available to deliver, orders are picked at random and could be dupliated with different customer and payment amounts
            {
                {name = 'cookedfries', amount = {min = 1, max = 1,}, payment = {min = 10, max = 25,}},
                {name = 'doublecheeseburger', amount = {min = 1, max = 2,}, payment = {min = 10, max = 25,}, },
                {name = 'creampie', amount = {min = 1, max = 1,}, payment = {min = 10, max = 25,}, },
                {name = 'orangesoda', amount = {min = 1, max = 1,}, payment = {min = 10, max = 25,}, },
            },
            {
                {name = 'hamburger', amount = {min = 1, max = 3,}, payment = {min = 25, max = 35,}, },
            },
            --add more random delivery items as required
        },
    },
}

---

Finished Config

• Below is an example of a finished configuration file for deliveries.lua

--delivery settings per job delivery location
Config.JobDeliveries = {
    ['Example Job Delivery Location'] = { -- the key is the location name and must match throughout
        settings = {
            minRank = 1, -- minimum job rank required to do deliveries
            maxDeliveries = {min = 3, max = 6}, -- maximum amount of deliveries available in the menu before having to wait for refresh
            refreshTimer = 5, -- time in minutes before the delivery menu refreshes and allows new deliveries if all deliveries are completed
            uniqueDeliveries = true, -- should each job member have their own delivery list or should it be grouped up and synced between players? i.e if one player does a delivery another player will also see that removed from the list, if set to unique each player will have their own list
            vehicle = { -- delivery vehicle settings
                coords = vector4(88.0, 309.3, 110.02, 161.02), -- spawn coords for vehicle
                name = 'panto', -- vehicle spawn name
                plate = 'ATOM', -- number plate for vehicle (the rest of the plate will be randomised make sure there are ALWAYS 4 slots available to create the rest of the 8 character plate)
            },
        },
        peds = { -- ped models - one is selected at random for each delivery
            `a_m_m_hillbilly_01`,
            `a_m_m_fatlatin_01`,
            `a_m_m_soucent_02`,
            `a_f_m_tramp_01`,
            `a_f_m_bevhills_01`,
            --add more ped models as required
        },
        coords = { -- ped spawn locations - one is selected at random for each delivery (must be vector4)
            vector4(-509.73, -22.38, 45.61, 34.49),
            vector4(-243.21, 169.38, 75.97, 274.06),
            vector4(-448.6, -132.49, 39.08, 122.59),
            vector4(-258.62, -842.02, 31.42, 151.18),
            vector4(166.79, -1553.64, 29.26, 217.02),
            vector4(386.15, -1882.59, 25.6, 228.37),
            vector4(1193.54, -1622.47, 45.22, 156.03),
            vector4(1450.97, -1720.61, 68.7, 129.2),
            vector4(182.82, -2027.62, 18.27, 175.65),
            vector4(-521.05, -2196.46, 6.39, 320.29),
            --add more spawn coords as required
        },
        rewards = { -- rewards settings
            payment = 'cash', -- payment type for deliveries
            tip = { -- tip settings
                enabled = true, -- set to true to enable tips
                chance = 25, -- chance to get a tip for delivering an order
                amount = {min = 10, max = 25}, -- min and max tip amounts
            },
        },
        items = { -- list of orders available to deliver, orders are picked at random and could be dupliated with different customer and payment amounts
            {
                {name = 'cookedfries', amount = {min = 1, max = 1,}, payment = {min = 10, max = 25,}},
                {name = 'doublecheeseburger', amount = {min = 1, max = 2,}, payment = {min = 10, max = 25,}, },
                {name = 'creampie', amount = {min = 1, max = 1,}, payment = {min = 10, max = 25,}, },
                {name = 'orangesoda', amount = {min = 1, max = 1,}, payment = {min = 10, max = 25,}, },
            },
            {
                {name = 'hamburger', amount = {min = 1, max = 3,}, payment = {min = 25, max = 35,}, },
            },
            --add more random delivery items as required
        },
    },
}