Usage

Usage

  1. Starting the Heist:

    • An NPC is spawned at a predetermined location.

    • Players interact with the NPC via an ox_target sphere zone.

    • Upon interaction, the script checks:

      • Whether a heist is already active.

      • Whether global or personal cooldowns are in effect.

      • Whether the player has a firearm in their inventory (using ox_inventory).

    • Based on these checks, players receive corresponding notifications and the heist is initiated.

  2. Heist Event:

    • 11 boxes are spawned at random locations defined in the configuration.

    • Each box is interactable via ox_target.

    • When a box is activated, a progress bar (with a pickup animation) is displayed.

    • Once the progress completes, a random reward (with a quantity defined between a minimum and maximum) is granted to the player.

    • If the player is armed (has a firearm in their inventory), additional aggressive NPCs are spawned near the box to add extra challenge.

  3. Cooldown System:

    • After initiating a heist, a personal cooldown is applied to the player, and once the heist is completed, a global cooldown prevents a new heist from starting immediately.

Last updated