> 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/it/hud/changelog.md).

# Changelog

## 1.1.0 (2026-11-15)

Car control riscritto e correzioni. Aggiornamento consigliato a tutti.

### Car control

* Il pannello mostra sempre lo stato reale del veicolo (porte, finestrini, motore, luci, sedili), anche quando lo cambiano il gioco, altri giocatori o altri script.
* Porte, finestrini e luce interna si vedono per tutti i giocatori, anche per chi entra dopo o arriva vicino dopo (serve OneSync).
* I passeggeri possono aprire e chiudere le porte anche quando guida un altro giocatore.
* Il motore spento resta spento (GTA non lo riaccende da solo).
* Comandi non disponibili disattivati (porte o finestrini mancanti, sedili occupati, azioni solo per il guidatore) e messaggi di errore chiari.
* Il pannello si chiude se cambi veicolo o muori.

### Altre correzioni

* Il cruise control non parte più a motore spento.
* Con la cintura allacciata non vieni più sbalzato dal parabrezza.
* Cruise e limitatore si spengono quando lasci il posto di guida.

### Aggiornamento da 1.0.x

* Sostituisci la cartella `ghiaccio_hud`. Il tuo `config.lua` e il tuo `config_server.lua` restano compatibili.
* Facoltativo: `Config.RateLimit.carSync` in `config_server.lua` (predefinito 12 eventi ogni 3 secondi).

## 1.0.1 (2026-11-14)

Solo documentazione. Nessuna modifica al codice.

### Documentazione

* Conteggio preset corretto (24).
* Riferimenti per gli acquirenti alla documentazione online.
* Commento sul logo in `config.lua`.

## 1.0.0

Prima versione.

### HUD ed editor

* 26 widget (vita, armatura, stamina, ossigeno, fame, sete, stress, contanti, banca, tachimetro, carburante, marcia, bussola, orologio, voce, arma e altri) con un editor drag & drop completo in gioco (`/hud`): sposta, ridimensiona, snap, selezione multipla, undo/redo.
* Menu `/hud` a schede: Sposta elementi, Icone di stato, Veicolo, Minimappa, Stile, Info e testo, Preset, Condividi.
* Preset di stile pronti, forme, colori, font, tema chiaro e palette per daltonici; export/import del layout come codice.
* Le icone di stato e del veicolo sono gruppi che si trascinano come un blocco unico e si richiudono da sole quando manca un'icona.
* Modalità streamer, modalità cinematica, UI in italiano e inglese.

### Strumenti server

* Layout di default del server: gli admin pubblicano il layout attuale (o un codice incollato) per tutti da `/hud` > Condividi > Server; i giocatori lo ricevono in automatico una volta e poi possono personalizzarlo.
* Blocco opzionale (`Config.ServerDefault.locked`) perché solo gli admin possano modificare l'HUD.
* Gruppi admin tramite `Config.AdminGroups` (gruppo ESX, permessi QBCore/Qbox o gruppo ACE) o l'ACE `ghiaccio_hud.admin`.
* Layout salvati per giocatore (KVP) con sincronizzazione database opzionale (oxmysql, `Config.DbSync`).
* Eventi di rete validati con controlli di dimensione e rate limit.

### Integrazioni

* ESX Legacy, QBCore, Qbox e standalone, rilevati in automatico.
* Carburante: ox\_fuel, LegacyFuel, cdn-fuel, fallback nativo. Status: esx\_status, metadata QBCore/Qbox, o qualunque script tramite `exports.ghiaccio_hud:setStatus` / `getStatus`. Voce: pma-voice, SaltyChat. Cintura: script esterni o quella integrata.
* Export client e server per visibilità, editor, stress, status, modalità cinematica, modalità streamer, cintura, widget e layout.

### Veicolo

* Cintura integrata con blocco dell'uscita e sbalzo opzionale dopo un incidente (`Config.Seatbelt.ejection`, `ejectKmh`).
* Cruise control, limitatore di velocità e pannello car control (portiere, finestrini, motore, luci, sedili).
* Effetto incidente grave (tremolio della camera, tinta, audio ovattato, breve blackout senza cintura, camminata barcollante), configurabile in `Config.CrashEffect`.

### Minimappa

* Minimappa rettangolare, quadrata e circolare con visibilità, posizione e dimensione configurabili, bordo colorato e maschere incluse (`stream/ghud_*map.ytd` con fallback runtime automatico).
* Componenti nativi dell'HUD di GTA nascosti (via, zona, nome veicolo, soldi, munizioni, barre vita/armatura) e radar espanso bloccato.

### Prestazioni

* Loop client a frequenze separate (a piedi / veicolo / navigazione / lento), un solo messaggio NUI quantizzato per tick con i soli valori cambiati.
* Orologio in tempo reale con fuso orario e ora legale calcolati dal server (`Config.Timezone`), oppure l'orologio di gioco.


---

# 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/it/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.
