# HZ-CarControl

## Overview

**HZ-CarControl** is a feature-rich vehicle control panel for FiveM. It gives players full control over their vehicle through a beautiful NUI menu — windows, doors, seats, engine, lights, indicators, cruise control, speed limiter, neon lights, radio, and more.

### Key Features

* **Windows** — Open/close each window individually (left/right icons)
* **Doors** — Open/close all doors, trunk, and hood (driver only)
* **Seats** — Switch seats with a 2x2 grid layout
* **Engine** — Start/stop with forced state management
* **Headlights** — 3-state cycle: off → low beams → high beams (dynamic icons)
* **Interior Light** — Toggle interior light
* **Indicators** — Left/right turn signals with direct keybinds
* **Hazard Lights** — Emergency flashers with blinking animation
* **Convertible Roof** — Open/close for convertible vehicles
* **Neon Lights** — Toggle with RGB color picker and preset swatches
* **Cruise Control** — Set speed with +/- adjustment, auto-disengage on brake/collision
* **Speed Limiter** — Cycle through preset speed limits
* **Door Lock** — Lock/unlock with vehicle keys integration
* **Radio** — Full GTA V radio control with station list and display

### Ghost Protocol UI

The menu uses the **NoTrace "Ghost Protocol"** design system:

* Cyberpunk aesthetic with cyan electric accents
* GPU-only animations (zero blur, 60 FPS guaranteed)
* Ghost Line signature with scan animation
* Materialize/dematerialize window transitions
* Proportional scaling across all resolutions (720p to 4K)

### Multi-Framework

HZ-CarControl **automatically detects** your server's framework via HZ-Bridge.

| System            | Supported Options                        |
| ----------------- | ---------------------------------------- |
| **Framework**     | QBCore, QBX, ESX, Standalone             |
| **Vehicle Keys**  | qbx\_vehiclekeys, qb-vehiclekeys, native |
| **Notifications** | QBCore, ESX, chat, native                |

### Multi-Language

14 languages included out of the box:

| Language   | Code |
| ---------- | ---- |
| English    | `en` |
| Français   | `fr` |
| Español    | `es` |
| Deutsch    | `de` |
| Português  | `pt` |
| Italiano   | `it` |
| Nederlands | `nl` |
| Polski     | `pl` |
| Türkçe     | `tr` |
| Русский    | `ru` |
| 中文         | `zh` |
| 日本語        | `ja` |
| 한국어        | `ko` |
| العربية    | `ar` |

### Performance

| Metric        | Value   |
| ------------- | ------- |
| Client (idle) | 0.00 ms |
| Client (peak) | 0.02 ms |
| Server        | 0.00 ms |

### Requirements

* FiveM Server (recommended build: latest)
* [HZ-Bridge](https://hz-script.gitbook.io/hz-script-docs/free-tools/hz-bridge) (free — required)
* [oxmysql](https://github.com/overextended/oxmysql) (optional, for neon color persistence)

***

{% hint style="info" %}
**Need help?** Join our [Discord](https://discord.gg/D2jMNswvBM) and open a ticket in the #support channel.
{% endhint %}

## Quick Navigation

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Step-by-step guide to install HZ-CarControl on your server</td><td><a href="hz-carcontrol/installation">installation</a></td></tr><tr><td><strong>Configuration</strong></td><td>Customize features, keybinds, sounds, and permissions</td><td><a href="hz-carcontrol/configuration">configuration</a></td></tr><tr><td><strong>Exports &#x26; Events</strong></td><td>Integrate the vehicle control system into your scripts</td><td><a href="hz-carcontrol/exports">exports</a></td></tr><tr><td><strong>FAQ</strong></td><td>Answers to frequently asked questions</td><td><a href="hz-carcontrol/faq">faq</a></td></tr></tbody></table>