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

# APEX Caller Item

> Faction-wide backup signal with two-phase countdown.

A lightweight backup signal inventory item for FiveM / ESX. When a player uses it, every online member of their job sees a two-phase on-screen countdown — first contact, then backup timer. For gang/family backup mechanics, deal-gone-wrong signals, or faction-wide alert loops.

## Features

* Two-phase countdown — configurable First Contact (short) → Backup (long)
* On-screen rendered timer — no NUI, zero resmon cost
* Per-player hotkey cooldown (spam protection) + per-job cooldown
* Auto-excluded law-enforcement — pattern matching on job names (ambulance, police, doj, lssd)
* Stops on death via `esx:onPlayerDeath` — no ghost timers
* Hotkey + usable item + command — all three input paths supported
* en/de localization with real umlauts

## Requirements

<Card title="Required" icon="circle-check">
  `es_extended`, `ox_lib`
</Card>

## Configuration

```lua config.lua theme={null}
Config.ItemName               = 'caller_item'
Config.FirstContactSeconds    = 10
Config.BackupSeconds          = 300
Config.PlayerHotkeyCooldownMs = 60000
Config.JobCooldownSeconds     = 360
Config.ExcludedJobPatterns    = { 'ambulance', 'police', 'doj', 'lssd' }
Config.AllowUnemployed        = false
```

Text rendering parameters (font, scale, color, position) are exposed in `Config.Text`. Fans out with batched `Wait(100)` every 50 players for 800-player scale.

## Hooks

See [Hooks reference / Caller Item](/hooks/apex-caller-item). Key hooks: `Hooks.CanUseItem(source, xPlayer)`, `Hooks.OnServerNotify`, `Hooks.OnClientNotify`.

## Resource info

<Note>
  Code accessible: `config.lua`, `hooks.lua`, `locales/*`. Approximately 350 lines of Lua. English + German.
</Note>