> ## 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 Aduty

> Staff admin duty suite with noclip, outfits, and a command toolkit.

A complete staff duty system for ESX. One command toggles a full admin outfit, invisibility, nametag flag, noclip with 7 speed tiers and sprint boost, teleport / goto / bring, coord display, skin reset, and optional Discord webhook logging. Built for serious team workflows where admins need to jump in, fix a scene, and jump back out.

## Features

* One-command duty mode (`/aduty`) — outfit swap + nametag flag + optional invincibility
* 7-level noclip with sprint multiplier, vehicle-detection auto-ban, group exemptions
* Sprint boost while on duty (default 1.3x)
* Admin toolkit — `/tpm`, `/goto`, `/bring`, `/coords`, `/resetskin`, `/invisible`
* Group-based permissions (Team / Non-Team / Gear-Exempt matrices)
* Discord webhooks for aduty + noclip toggles (leave empty to disable)
* Pre-configured aduty outfit in `outfits.lua`
* Zero database footprint — purely runtime state

## Requirements

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

## Installation

1. Drop `apex-aduty` into `resources/`
2. `ensure apex-aduty` after `es_extended` + `ox_lib`
3. Edit `config.lua` to set your admin groups and webhook URLs
4. Edit `outfits.lua` for the duty uniform

## Configuration

```lua config.lua theme={null}
Config.AdminGroups           = { 'founder', 'projektleitung', 'admin', 'moderator', 'supporter' }
Config.UseNoclipWithoutAduty = true
Config.SprintBoostEnabled    = true
Config.SprintBoostMultiplier = 1.3
Config.Noclip.SpeedLevels    = { 0.1, 0.3, 0.5, 1.0, 2.0, 4.0, 8.0 }
Config.Noclip.VehicleBanThresholdMs = 3000
Config.Webhooks.AdutyToggle  = ''
```

Commands and hotkey bindings are fully configurable, as is gear exemption, the vehicle-in-noclip ban threshold, and the per-group non-team list.

## Hooks

See [Hooks reference / Aduty](/hooks/apex-aduty). Key hooks: `Hooks.OnAdutyStateChanged`, `Hooks.BanPlayer`, `Hooks.OnAuditLog`.

## Resource info

<Note>
  Code accessible: `config.lua`, `outfits.lua`, `hooks.lua`, `locales/*` — rest in escrow. Approximately 900 lines of Lua. English + German.
</Note>
