> ## 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 Idle Cam

> Cinematic AFK camera for on-foot and vehicle.

Cinematic idle camera system for FiveM. Automatically switches to dynamic camera angles when the player stays still — 8 on-foot shots, 8 in-vehicle shots — with smooth fade transitions. For AFK cinematics, screenshot moments, or just letting the server breathe.

## Features

* 16 total shot presets — 8 for on-foot, 8 for in-vehicle, all configurable
* Smooth from → to interpolation per shot with smoothstep easing and fade transitions
* Aborts on any input — mouse, aim, camera rotation, driving keys, walking
* 0.00ms idle cost — check thread at 6s when NOT idle, 200ms when idle
* Suppression hooks — character creator / noclip / HUD setting aware
* Zero server footprint (100% client-side)

## Requirements

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

## Configuration

```lua config.lua theme={null}
Config.IdleTimeMs            = 20000     -- wait before idle starts
Config.CamSwitchMs           = 10000     -- duration per shot
Config.ScreenFadeMs          = 400
Config.CheckIntervalIdleMs   = 6000
Config.CheckIntervalActiveMs = 200
Config.CamRotThreshold       = 1.0
Config.MouseInputThreshold   = 0.05
```

Each shot is `{ from = vec3, to = vec3, fov = 35.0 }` relative to the entity. Shows a hint notification on first activation (configurable).

## Hooks

See [Hooks reference / Idle Cam](/hooks/apex-idle-cam). Key hooks: `Hooks.IsIdleCamEnabled`, `Hooks.IsCharIdleCamEnabled`, `Hooks.IsInCharCreator`, `Hooks.IsInNoclip`, `Hooks.OnIdleStateChanged`.

## Resource info

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