> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megaworks.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# HelpRequests.lua

> Configure medical alert pings and response menus

Located in `shared/config/helprequests.lua`, this file handles how downed or injured players request help from active medics, and how doctors view and respond to those pings.

## Core Properties

* `enableAlert`: Toggles the ability for players to request help.
* `enableAlertResponse`: Toggles the ability for doctors to actively respond to an alert.
* `allowDeadPlayers`: Whether players can request help *after* they have died.
* `openAlertMenuCommand`: Command string to open the Doctor's active alerts menu (e.g. `alertmenu`).
* `alertCommand`: Command string for a player to request assistance (e.g. `alertdoctor`).
* `respondCommand`: Command string for doctors to start moving towards an alert (e.g. `respond`).
* `clearAlertCommand`: Command string to purge the list of current alerts.
* `alertCooldown`: Global cooldown (in milliseconds) restricting how frequently a player can spam requests.

## Map & Audio Indicators

* `alertBlipSprite`: The visual blip shown on the doctor's map (use `0` to disable).
* `showRadiusAroundBlip`: Enables a stylized radius ring around the pinged area.
* `blipRadius`: Radius dimension in map units.
* `radiusStyle`: Identifier for the visual style of the radius marker.
* `alertTimeout`: Grace period (in seconds) before a neglected ping is automatically removed.
* `alertNotificationDuration`: The duration (in ms) the initial popup UI stays on screen.
* `enableAlertSound`: Triggers an audible ping when a new request arrives.
* `alertSound`: Table defining the `name` and `set` of the audio hash.

## Menu Configuration (`Config.alertsMenu`)

Defines the text and structure shown in the `openAlertMenuCommand` UI.

```lua theme={null}
Config.alertsMenu = {
    title = "Help Requests",
    subtitle = "Manage Help Requests",
    position = "bottom-right",
    helpRequestTitle = "Help Requested at %s (%dm)",
    helpRequestDescription = "Help is needed at %s.<br>Distance: %d meters<br>Requested at: %s",
    noRequests = "No Help Requests."
}
```