# Dashboard

## 📊 Player Dashboard

A lightweight HUD showing active events without taking control focus.

***

### Access

| Method  | Details             |
| ------- | ------------------- |
| Command | /events             |
| Keybind | F7 (configurable)   |
| Close   | F7 again or /events |

The dashboard does NOT capture mouse or keyboard input. Players can continue playing normally while viewing it.

***

### Layout

#### Header

* EL EVENTS logo with animated pulse dot
* Active event count badge (green when events exist)

#### Event List

Each active event displays as a mini card:

| Element        | Description                                |
| -------------- | ------------------------------------------ |
| Left color bar | Color-coded by event type                  |
| Type icon      | Small icon matching event type             |
| Event name     | AIRDROP, HOTZONE, CONVOY, or TREASURE HUNT |
| Location       | Event location label                       |
| Timer          | Live countdown in MM:SS format             |

#### Color Coding

| Event    | Color  | Hex     |
| -------- | ------ | ------- |
| Airdrop  | Orange | #FF8844 |
| Hotzone  | Red    | #FF5555 |
| Convoy   | Blue   | #5599FF |
| Treasure | Purple | #BB77FF |

#### Empty State

When no events are running, shows a radar icon with "No active events" message.

***

### Features

* **Auto-show:** Automatically appears when new events start
* **Auto-update:** Refreshes every 5 seconds
* **GPS navigation:** Click an event to set a waypoint
* **Live timers:** Count down every second client-side
* **No focus:** Does not interfere with gameplay
* **Scrollable:** Supports multiple active events

***

### Configuration

```lua
Config.Commands = {
    dashboard = {
        enabled = true,
        command = 'events',
        key = 'F7',
        description = 'Event Dashboard',
    },
}
```

### Technical Details

| Property       | Value                               |
| -------------- | ----------------------------------- |
| Position       | Fixed, top-right corner             |
| Width          | 300px                               |
| Max height     | 400px (scrollable)                  |
| Background     | Semi-transparent with backdrop blur |
| Animation      | Slides in from right                |
| Pointer events | None (pass-through)                 |


---

# 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://elena-scripts.gitbook.io/elenascripts/core-systems/el-events/dashboard.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.