For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configuration

General Configuration

Config.general = {
    -- Contact NPC that hands out the job --
    startHeist = {
        model = "u_m_y_mani",
        coords = vector4(986.869, -2583.983, 10.418, 200.004),
        cooldown = 60, -- Minutes before the heist can be started again (server wide)
    },

    -- Boats rented at the dock to reach the island --
    rentVehicle = {
        vehicles = {
            { model = "dinghy", price = 100 },
        },
        spawnCoords = {
            vector4(974.634, -2684.911, 0.615, 210.642)
        }
    },

    -- Cayo Perico itself --
    island = {
        center = vector3(5015.721, -5104.542, 4.888),
        blip = { sprite = 836, color = 5, scale = 1.0, name = "Cayo Perico" }, -- Marked with a route once the heist starts
        spawnDistance = 1600.0, -- Guards spawn once a player gets this close
        objectDistance = 100.0, -- Loot spawns once a player gets this close to a location
        enableAlarm = true, -- Island alarm siren while the guards are alerted
        enableGuardBlips = true, -- Show guards on the map (needs the patrol intel)
        enableLootBlips = true, -- Show loot on the map
        lootBlip = { sprite = 1, color = 5, scale = 0.5, name = "Loot" },
    },
}

Config.heist = {
    -- Laptop that downloads the intel, each file unlocks map blips --
    securityRoom = {
        laptopCoords = vector4(4427.746, -4451.851, 7.236, 198.604),
        requiredItem = "hack_usb",
        removeItemOnUse = false,
        duration = 60, -- Seconds the download takes
        blip = { sprite = 521, color = 3, scale = 1.0, name = "Security Room" },
    },

    -- Mansion break-in, the doors and the loot inside are in shared/mansion.lua --
    mansion = {
        name = "Mansion",
        coords = vector3(5010.026, -5749.191, 32.852),
        blip = { sprite = 181, color = 5, scale = 1.0, name = "Mansion" },
        entryBlip = { sprite = 66, color = 4, scale = 0.6, name = "Entry Point" },

        -- Items needed to open each entry point --
        entryTypes = {
            wall = { requiredItem = "hook", removeItemOnUse = false },
            underwater = { requiredItem = "blowtorch", removeItemOnUse = false },
        },

        -- Lockpicking the inner doors --
        doorItem = { requiredItem = "lockpick", removeItemOnUse = true },
        doorLockpick = {
            strength = 0.5, -- Attempts are strength * pins
            difficulty = 2, -- 1 to 5
            pins = 5, -- 3 to 9
        },

        -- Only used on the uj_cayoPerico map, the tunnel is blown open instead of a cutscene --
        poolDoor = { requiredItem = "c4", removeItemOnUse = true },
    },

    -- Air for the underwater entry, given by a usable item --
    rebreather = {
        item = "rebreather",
        duration = 120, -- Seconds of air per use
    },

    -- Keys are hidden in one random safe every heist --
    helicopter = {
        model = "maverick",
        coords = vector4(4890.902, -5735.670, 26.464, 160.973),
        blip = { sprite = 574, color = 5, scale = 0.6, name = "Helicopter" },
    },

    safeCrackDifficulty = 1, -- How many pins the safe minigame asks for

    -- Buyer that pays out the stolen goods, only the player who started the heist sees it --
    finish = {
        enabled = true,
        coords = vector4(2478.250, 1588.430, 32.642, 317.509),
        cutscene = "HS4F_DRP_OFF",
        blip = { sprite = 108, color = 2, scale = 1.0, name = "Buyer" },
        sellableItems = {
            { name = "pogo_statue", price = 45000 },
            { name = "panther_statue", price = 60000 },
            { name = "big_diamond", price = 55000 },
            { name = "painting", price = 35000 },
            { name = "gold_bar", price = 12000 },
            { name = "rum_bottle", price = 8000 },
        },
    },
}

Heist Configuration

Last updated