Configuration

Fivemanage​

1. Create an account at Fivemanage

2. After you have created an account or logged in, navigate to the Token page and create a new token.

3. Copy the API token and add setr external_blackmarket:key insert_token to your server.cfg

Webhook​

1. Create an discord webhook

2. Add setr external_blackmarket:webhook insert_link to your server.cfg

Config Setup

Configure the script based on your framework!

Config.Framework = 'esx'            --esx or qbcore
Config.Target = 'ox'                -- ox or qbcore
Config.Inventory = 'ox'             -- ox or qbcore

Add New Points

1. Duplicate an existing entry and modify the number enclosed in square brackets, e.g., [1], to designate the new point.

[2] = {
        coords = vector4(-1914.988, 2084.914, 140.38404, 171.63714),
        backupstartpos = {
            [1] = {
                startpoint = vector4(-1781.962, 1875.5399, 149.94836, 41.428062), --car start point
                endpoint = vector4(-1920.139, 2066.5681, 140.56163, 27.925649),   --car end point
                vehicle = "rs3s20",
                npcmodels = {
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                },
                weapons = { --weapons that the npc will have
                    'weapon_pistol',
                    'weapon_smg',
                }
            },
            [2] = {
                startpoint = vector4(-1764.945, 2076.9064, 120.36781, 132.18052), --car start point
                endpoint = vector4(-1902.415, 2059.8725, 140.82592, 355.20169),   --car end point
                vehicle = "rs3s20",
                npcmodels = {
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                },
                weapons = { --weapons that the npc will have
                    'weapon_pistol',
                    'weapon_smg',
                }
            },

            [3] = {
                startpoint = vector4(-1838.969, 1829.1687, 159.81881, 278.02224), --car start point
                endpoint = vector4(-1916.619, 2061.7031, 140.73641, 43.538276),   --car end point
                vehicle = "rs3s20",
                npcmodels = {
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                    "g_m_y_ballaeast_01",
                },
                weapons = { --weapons that the npc will have
                    'weapon_pistol',
                    'weapon_smg',
                }
            },


        }
    },

1. Adjust the "coords" field to specify the location of the new pickup point.

2. Populate the "backupstartpos" section with relevant data for the new pickup point, including start and end points, vehicle type, NPC models, and assigned weapons. (add as many you want)

Shop Location

The shop location is random and can be expanded by adding more positions. Modify the "Config.Shop" parameter as follows:

Config.Shop = {
    {
        coords = { -- Random shop positions, new position generated on each resource/server restart.
            vector4(-1829.304, 786.85736, 142.86944, 29.52165),
            vector4(1083.752, -1283.728, 20.175382, 339.98135),
            vector4(87.992141, -726.8884, 33.133186, 300.94558),
            vector4(-13.99115, -212.6436, 46.176467, 130.2525),
            vector4(-131.6128, -1463.16, 33.822624, 232.19593)
        },
    }
}

To specify the item that reveals the shop's location, set:

Config.LocalizationItem = 'finder'  -- Item required to reveal the shop's location.

Shop Categories

Create custom categories by inserting them into the "categories" section of "Config.Shop":

categories = {
    {
        id = "category_id",
        label = "Category Name"
    },
}

Shop Items

Add items for sale in the shop by inserting them into the "items" section of "Config.Shop":

items = {
    {
        item = "item_spawncode",
        label = "Item Label",
        category = "category_id",
        price = 27000,
    },
}

Translation

To change the language, define the language flag and phrases in "Config.Phrases":

Config.Language = 'custom_language'

Config.Phrases = {
    custom_language = {
        warnings = {
            "You've already collected your item, jerk",
            "There's nothing else to collect, move on",
            "If you continue like this, you'll end up with a bullet in your head, jerk",
        },
        general = {
            [1] = 'You got scammed, get out!',
            [2] = 'I marked the spot on the map, go there to retrieve your stuff!',
            [3] = 'Cooldown: Come back in %d:%d minutes.',
            [4] = 'The area is visible for the next 60 seconds!',
            [5] = 'Purchase failed, you don\'t have enough money',
            [6] = 'Purchase failed, you don\'t have enough space',
        },
        -- Other language-specific phrases...
    },
}

Feel free to adjust these configurations to suit your needs!