# Exports/Events

This page lists the currently available public exports and the menu event exposed by `0r-heistpack`.

## Client Export

* `exports['0r-heistpack']:activeHeistScenario()` Returns the player's current active heist scenario on the client side.
* Purpose: Lets your own script check whether the player is already inside an active heist flow.
* Use this when: You want to block another activity, show custom UI, or read the active scenario before running your own logic.

```lua
local activeScenario = exports['0r-heistpack']:activeHeistScenario()

if activeScenario then
    print(("Active heist key: %s"):format(activeScenario.key))
end
```

## Client Event

* `TriggerEvent('0r-heistpack:client:openMenu', byPassDistance, openedWithTablet)` Opens the heist menu from another client script.
* Purpose: Lets you open the heist menu from a usable item, command, target option, or external tablet app.
* Parameters: `byPassDistance`: if `true`, skips the employer distance check `openedWithTablet`: if `true`, opens the menu with tablet prop and animation
* Important: Job restrictions and other menu permission checks still apply even if `byPassDistance` is `true`.

```lua
TriggerEvent('0r-heistpack:client:openMenu', true, false)
```

Tablet-style usage:

```lua
TriggerEvent('0r-heistpack:client:openMenu', true, true)
```