Koja Scripts
Heists

General Settings

This section covers the core behavior of the script, including police requirements, cooldowns, and interaction methods.

General Settings

Target System Integration: If you are using ox_target, ensure you enable it in the config. Set enabled = true to switch from 3D Text/TextUI to target-based interactions.

Config.Target = {
    enabled = true, -- Set to true to use ox_target
    resource = 'ox_target',
    icon = 'fas fa-sign-in-alt'
}
  • TextUI: The label displayed when ox_target is disabled.
  • Police Requirement: Config.MinPoliceRequired sets the minimum number of officers needed to initiate the heist.
  • Cooldowns:
    • GeneralCooldown: Time (in seconds) the entire heist is locked after a successful completion.
    • CooldownToLockDoors: Time before the bank doors automatically relock.
  • Fail Cooldowns: Penalties for failing minigames (Lockpicking, Decoding, Hacking, etc.), preventing immediate retries for a specified duration.
  • Changing Language — Explanation of the locale configuration in the script
  • Required Police To Start Heist — Required number of police officers to start a robbery
  • Rewards System — The loot is distributed via trolleys located inside the vault. The script distinguishes between two types of rewards.
  • Gabz Mapdata Compatibility — To ensure the heist functions correctly and to prevent "double-spawning" or glitched objects, you must modify the Gabz map resource.
  • Configuration — back to the section overview