# 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)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.0resmon.org/0resmon/0resmon-1/0r-resources/0r-heistpack/exports-events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
