> ## 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 NOS System

> Per-car flames, purge placement, and exhaust-flaps sync.

A car-specific NOS / nitro system for FiveM / ESX. Per-vehicle flame configs, purge spray placement, 7 colors with an in-game picker, exhaust-flap toggle (Klappenauspuff) server-synced via state bags, plus built-in dev tooling that prints config-ready code for new vehicles.

## Features

* Per-vehicle flame configs — exhaust-by-exhaust rotation offsets
* Purge spray from any bone with configurable offsets + mirror duplication
* 7 NOS colors with an in-game color picker NUI
* Boost on activation — `SetVehicleForwardSpeed + 25 km/h` kick
* exhaust flaps — synced via `StateBag` + `ForceUseAudioGameObject`
* Tight cooldowns — purge 30s, NOS 10s, klappe 5s
* Parking / tuning spot suppression via hooks (auto-detects common resources)
* Dev tooling — `/placeflame`, `/placepurge`, `/drawbones`, `/DebugPurge` print configs
* Custom YPT particles shipped in `stream/`
* en/de localization

## Requirements

<CardGroup cols={2}>
  <Card title="Required" icon="circle-check">
    `es_extended`, `ox_lib`
  </Card>

  <Card title="Optional" icon="puzzle-piece">
    `lls-mechanic` (suppresses NOS at tuning bays), `ata-garage` / `apex-mechanic-impound` (suppresses NOS at parking/drop-off)
  </Card>
</CardGroup>

## Configuration

```lua config.lua theme={null}
Config_NOS.Limiteds[GetHashKey('your_vehicle')] = {
    ['2step']   = false,
    ['flames']  = { exhaust = { x = 180.0, y = 0.0, z = 0.0 } },
    ['purge']   = {
        [1] = { bone = 'headlight_l', offsetX = 0.3, offsetY = -0.2, offsetZ = 0.0, x = 40.0, y = -40.0, z = 0.0 },
    },
    ['exhaust'] = { default = 'your_default_sound', klappe = 'your_klappe_sound' },
}
```

7 color presets ship out of the box. Keybindings expose `/startPurge`, `/startNos`, `/_klappe`, `/_setnoscolor`.

## Hooks

See [Hooks reference / NOS](/hooks/apex-nos-system). Key hooks: `Hooks.IsAtTuningSpot`, `Hooks.IsAtParkingSpot`, `Hooks.ShowClientNotify`.

## Resource info

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