Open Source

Most of the core logic in this resource is handled by the bridge. The open source files are provided so you can customize minigames, add hooks for custom systems, and extend the script without touching escrow.

opensource/client/client.lua

Each robbery step triggers the projectx-bobcatheist-default:client:Minigames callback with the step name.

lib.callback.register('projectx-bobcatheist-default:client:Minigames', function(Step)
    local p = promise.new()
    if Step == "C4Entrance" then
        if not exports['projectx-bridge']:MinigameCheck("lightsout") then p:resolve(false) return Citizen.Await(p) end
        local success = exports['lightsout']:StartLightsOut(4, 20)
        p:resolve(success)
    elseif Step == "EntranceKeypad" then
        if not exports['projectx-bridge']:MinigameCheck("SN-Hacking") then p:resolve(false) return Citizen.Await(p) end
        local success = exports['SN-Hacking']:Thermite(7, 5, 10000, 2, 2, 3000)
        p:resolve(success)
    elseif Step == "MainKeypad" then
        if not exports['projectx-bridge']:MinigameCheck("SN-Hacking") then p:resolve(false) return Citizen.Await(p) end
        local success = exports['SN-Hacking']:MemoryCards('hard')
        p:resolve(success)
    end
    return Citizen.Await(p)
end)

You can return true unconditionally inside any step block to skip that minigame entirely.

The default minigames per step are:

Step	Minigame Resource	Function
`C4Entrance`	`lightsout`	`StartLightsOut`
`EntranceKeypad`	`SN-Hacking`	`Thermite`
`C4Security`	`lightsout`	`StartLightsOut`
`SecurityFingerprint`	`utk_fingerprint`	`Start` (event)
`SearchDesk`	`ox_lib`	`skillCheck`
`SearchBelongings`	`ox_lib`	`skillCheck`
`ComputerDesk`	`SN-Hacking`	`Thermite`
`SmokeHallway`	`lightsout`	`StartLightsOut`
`MainKeypad`	`SN-Hacking`	`MemoryCards`
`Fusebox`	`ox_lib`	`skillCheck`
`SurveillanceRoomKeypad`	`SN-Hacking`	`Thermite`
`Computer`	`SN-Hacking`	`MemoryCards`
`C4Vault`	`lightsout`	`StartLightsOut`
`VaultPanel`	`SN-Hacking`	`ColorPicker`
`Crate`	`ox_lib`	`skillCheck`

opensource/server/server.lua

Hooks

SuccessfulStep(source, step)

Called whenever a player successfully completes a robbery step. Step names are listed in Config.BobcatSteps inside config/config.lua.

FailedStep(source, step)

Called whenever a player fails a robbery step.

InitialCheck(Interaction)

Called before a player can start the robbery. Return false to block them.

RobberyResetHook()

Called whenever the heist resets.

See the K4MB1 Bobcat Open Source page for full hook examples.

Getting Started

Project X Bridge

Paid Resources

Free Resources

opensource/client/client.lua

opensource/server/server.lua

Hooks

​opensource/client/client.lua

​opensource/server/server.lua

​Hooks

opensource/client/client.lua

opensource/server/server.lua

Hooks