> For the complete documentation index, see [llms.txt](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/hud/changelog.md).

# Changelog

## 1.1.0 (2026-11-15)

Car control rewritten, plus fixes. Recommended update for everyone.

### Car control

* The panel always shows the real vehicle state (doors, windows, engine, lights, seats), even when the game, other players or other scripts change it.
* Doors, windows and the interior light are visible to every player, including players who join or drive into range later (requires OneSync).
* Passengers can open and close doors even when another player is driving.
* A switched-off engine stays off (GTA no longer restarts it on its own).
* Unavailable controls are disabled (missing or broken doors and windows, taken seats, driver-only actions) with clear error messages.
* The panel closes when you change vehicle or die.

### Other fixes

* Cruise control no longer starts with the engine off.
* With the seatbelt fastened you are no longer thrown through the windscreen.
* Cruise and speed limiter switch off when you leave the driver seat.

### Updating from 1.0.x

* Replace the `ghiaccio_hud` folder. Your `config.lua` and `config_server.lua` stay compatible.
* Optional: `Config.RateLimit.carSync` in `config_server.lua` (default 12 events every 3 seconds).

## 1.0.1 (2026-11-14)

Documentation only. No code changes.

### Documentation

* Preset count corrected to 24.
* Buyer references to the online documentation added.
* Logo comment added in `config.lua`.

## 1.0.0

Initial release.

### HUD and editor

* 26 widgets (health, armor, stamina, oxygen, hunger, thirst, stress, cash, bank, speedometer, fuel, gear, compass, clock, voice, weapon, and more) with a full in-game drag & drop editor (`/hud`): move, resize, snap, multi-select, undo/redo.
* Tabbed `/hud` menu: Move elements, Status icons, Vehicle, Minimap, Style, Info and text, Presets, Share.
* Ready-made style presets, shapes, colors, fonts, light theme and color-blind palettes; export/import of a layout as a code.
* Status and vehicle icons are groups that drag as one block and collapse automatically when an icon is missing.
* Streamer mode, cinematic mode, English and Italian UI.

### Server tools

* Server default layout: admins publish the current layout (or a pasted code) for everyone from `/hud` > Share > Server; players receive it automatically once and can then customize it.
* Optional lock (`Config.ServerDefault.locked`) so only admins can edit the HUD.
* Admin groups via `Config.AdminGroups` (ESX group, QBCore/Qbox permissions or ACE group) or the `ghiaccio_hud.admin` ACE.
* Layouts stored per player (KVP) with optional database sync (oxmysql, `Config.DbSync`).
* Validated network events with size checks and rate limiting.

### Integrations

* ESX Legacy, QBCore, Qbox and standalone, auto-detected.
* Fuel: ox\_fuel, LegacyFuel, cdn-fuel, native fallback. Status: esx\_status, QBCore/Qbox metadata, or any script through `exports.ghiaccio_hud:setStatus` / `getStatus`. Voice: pma-voice, SaltyChat. Seatbelt: external scripts or the built-in one.
* Client and server exports for visibility, editor, stress, status, cinematic mode, streamer mode, seatbelt, widgets and layouts.

### Vehicle

* Built-in seatbelt with exit lock and optional ejection after a crash (`Config.Seatbelt.ejection`, `ejectKmh`).
* Cruise control, speed limiter and car control panel (doors, windows, engine, lights, seats).
* Severe crash effect (camera shake, tint, muffled audio, brief blackout without a seatbelt, staggering walk), configurable in `Config.CrashEffect`.

### Minimap

* Rectangular, square and circular minimap with configurable visibility, position and size, a colored border, and included masks (`stream/ghud_*map.ytd` with an automatic runtime fallback).
* Native GTA HUD components hidden (street, zone, vehicle name, money, ammo, health/armor bars) and the expanded radar locked.

### Performance

* Client loops at separate rates (on foot / vehicle / navigation / slow), one quantized NUI message per tick containing only changed values.
* Real-time clock with time zone and daylight saving computed server-side (`Config.Timezone`), or the in-game clock.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/hud/changelog.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
