> ## 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 Mechanic Impound

> Hook-based mechanic drop-off with damage persistence.

A mechanic drop-off zone for ESX. Authorized mechanics drive a vehicle to the drop-off, confirm with a clipboard animation, and the vehicle is forwarded to your garage / impound system via a single hook. Damage data (engine, body, fuel) is persisted back to `owned_vehicles` so the car shows up damaged when the owner retrieves it.

## Features

* Drop-off marker + blip — visible only to authorized jobs
* Clipboard handover animation, configurable duration
* Damage persistence — engine / body / fuel level written to `owned_vehicles`
* Hook-based garage integration — ata-garage / qbx\_vehiclegarages / custom via one function
* AdvancedParking-friendly via `BeforeEntityDelete`
* Zweitjob / duty support via `Hooks.IsAuthorized`
* en/de localization

## Requirements

<Card title="Required" icon="circle-check">
  `es_extended`, `ox_lib`, `oxmysql`, plus a garage / impound resource (wired via `Hooks.ImpoundVehicle`).
</Card>

## Installation

1. Drop `apex-mechanic-impound` into `resources/`
2. Wire `Hooks.ImpoundVehicle` to your garage in `hooks.lua`
3. `ensure apex-mechanic-impound`

## Configuration

```lua config.lua theme={null}
Config.JobName               = 'mechanic'
Config.DropoffCoords         = vector3(...)
Config.InteractionDistance   = 8.0
Config.LeaveVehicleTimeoutMs = 8000
Config.ClipboardDurationMs   = 4000
Config.PersistDamageData     = true
Config.VehicleTableName      = 'owned_vehicles'
```

Vehicle table name is validated at startup.

## Hooks

See [Hooks reference / Mechanic Impound](/hooks/apex-mechanic-impound). Key hooks: `Hooks.ImpoundVehicle`, `Hooks.BeforeEntityDelete`, `Hooks.IsAuthorized`, `Hooks.IsAuthorizedClient`.

## Resource info

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