Open Source

Most core logic runs through the bridge and encrypted scripts. Open source files let you customize minigames, hooks, and integrations without editing escrow.

opensource/client/client.lua

Handles zones, drawtext, evidence, stress, and the minigame callback. Edit minigames in the projectx-casinoheist-k4mb1:client:Minigames callback.

Minigame Callback

Each step name is passed as Step. Replace the export inside the matching elseif, or return true to skip a step.

lib.callback.register('projectx-casinoheist-k4mb1:client:Minigames', function(Step)
    local p = promise.new()
    if Step == "Cashier" then
        p:resolve(true)
    elseif Step == "KeypadStairsAccess" then
        if not exports['projectx-bridge']:MinigameCheck("utk_fingerprint") then p:resolve(false) return Citizen.Await(p) end
        TriggerEvent("utk_fingerprint:Start", 4, 6, 2, function(success) p:resolve(success) end)
    elseif Step == "KeypadCashier" then
        if not exports['projectx-bridge']:MinigameCheck("pure-minigames") then p:resolve(false) return Citizen.Await(p) end
        local gameData = {totalNumbers = 20, seconds = 20, timesToChangeNumbers = 4, amountOfGames = 1, incrementByAmount = 5}
        p:resolve(exports['pure-minigames']:numberCounter(gameData))
    elseif Step == "FuseboxVault" then
        if not exports['projectx-bridge']:MinigameCheck("boii_minigames") then p:resolve(false) return Citizen.Await(p) end
        exports['boii_minigames']:wire_cut({style = 'default', timer = 60000}, function(success) p:resolve(success) end)
    else
        p:resolve(false)
    end
    return Citizen.Await(p)
end)

Return true from any branch to skip that minigame (for testing or custom automation).

Default minigame assignments

Step	Resource	Function
`Cashier`	—	skipped (`true`)
`KeypadStairsAccess`	`utk_fingerprint`	`Start` (event)
`KeypadCashier`	`pure-minigames`	`numberCounter`
`StaircaseCashier`	`bl_ui`	`CircleProgress`
`Receptionist`	—	skipped (`true`)
`ComputerSideOffice`	`bl_ui`	`PathFind`
`KeypadMainOffice`	`bl_ui`	`DigitDazzle`
`SafeMainOfficeFingerprint`	`bl_ui`	`PrintLock`
`SafeMainOffice`	`pd-safe`	`createSafe`
`LaptopMainOffice`	`bl_ui`	`KeySpam`
`SmokeSecurity`	`lightsout`	`StartLightsOut`
`ButtonSecurity`	—	skipped (`true`)
`FuseboxGarage`	`SN-Hacking`	`MemoryCards`
`DrawerSecurity`	`ox_lib`	`skillCheck`
`TopElevator`	`SN-Hacking`	`SkillBar`
`BottomElevator`	`SN-Hacking`	`SkillBar`
`LaptopVaultPutDown`	`bl_ui`	`KeySpam`
`LaptopVault`	`bl_ui`	`WordWiz`
`PlantJammer`	`bl_ui`	`WaveMatch`
`FuseboxVault`	`boii_minigames`	`wire_cut`
`ComputerVault`	`boii_minigames`	`chip_hack`
`ComputerPuzzle`	`SN-Hacking`	`ColorPicker`
`Drilling`	`bl_ui`	`CircleShake`
`C4`	`bl_ui`	`MineSweeper`
`Penthouse`	`boii_minigames`	`pincode`
`Prop`	`bl_ui`	`CircleProgress`
`Fusebox1`	`SN-Hacking`	`SkillBar`
`Fusebox2`	`bl_ui`	`KeySpam`
`Fusebox3`	`bl_ui`	`Progress`
`Fusebox4`	`SN-Hacking`	`Thermite`
`Fusebox5`	`bl_ui`	`RapidLines`
`Fusebox6`	`bl_ui`	`WaveMatch`
`Fusebox7`	`boii_minigames`	`wire_cut`
`Fusebox8`	`boii_minigames`	`wire_cut`

Step names match entries in config/config.lua (for example Config.CasinoSteps).

opensource/server/server.lua

Dispatch, items, money, logging, admin reset command, and hooks.

Hooks

SuccessfulStep(source, step)

Called when a player completes a robbery step. Use for XP, logging, or custom rewards.

function SuccessfulStep(source, step)
    if step == "KeypadMainOffice" then
        -- exports['projectx-bridge']:AddExperience(source, 'criminal', 10)
    end
end

FailedStep(source, step)

Called when a player fails a step. Use for penalties or item removal.

function FailedStep(source, step)
    -- Custom logic per step
end

InitialCheck(source, Interaction)

Called before the heist can start. Return false to block the player.

function InitialCheck(source, Interaction)
    return true
end

RobberyResetHook()

Called when the heist resets (timer, admin command, or export).

function RobberyResetHook()
    -- Update scoreboards or external state
end

Admin command permissions use CheckPerms from the bridge:

function CheckPerms(source)
    return exports['projectx-bridge']:CheckPerms(source, GetCurrentResourceName())
end

Getting Started

Project X Bridge

Paid Resources

Free Resources

opensource/client/client.lua

Minigame Callback

Default minigame assignments

opensource/server/server.lua

Hooks

​opensource/client/client.lua

​Minigame Callback

​Default minigame assignments

​opensource/server/server.lua

​Hooks

opensource/client/client.lua

Minigame Callback

Default minigame assignments

opensource/server/server.lua

Hooks