> 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/weapons-editor/usage-guide.md).

# Guida all'uso

Apri l'editor con `/weaponeditor` (o con il tasto di `Config.Keybind`). Chiudilo con **Esc**; se il mouse resta bloccato usa `/weaponeditor_close`.

## LIVE, HOT e RESTART

Ogni campo appartiene a una classe. La classe indica **quando** una modifica arriva ai giocatori.

| Classe      | Campi                                                                                                                                                            | Come                                                   | Quando vale                                                    |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | -------------------------------------------------------------- |
| **LIVE**    | Danno (o moltiplicatore), dispersione, rinculo (camera), raggio esplosione, 4 moltiplicatori globali giocatore                                                   | native + `GlobalState['gwe:live']`                     | Subito, per tutti; chi entra dopo lo trova già applicato.      |
| **HOT**     | Tutti gli altri tag numerici di `CWeaponInfo` (caricatore, cadenza, gittata, caduta del danno, headshot, ricarica, HUD, ...), munizioni (`CAmmoInfo`), accessori | patch `weapons_gwe.meta` / `weaponcomponents_gwe.meta` | **Al prossimo ingresso (riconnessione) o riavvio del server.** |
| **RESTART** | Stato di ogni campo HOT (la patch è caricata dal client all'ingresso)                                                                                            | File nella patch (o in `generated/`)                   | Al prossimo ingresso (riconnessione) o riavvio del server.     |

{% hint style="info" %}
Con `Config.HotReload = false` (default, consigliato) i campi HOT sono etichettati "Attivo al prossimo ingresso o riavvio" e il salvataggio indica che il valore vale al prossimo ingresso (riconnessione) o riavvio del server.
{% endhint %}

## Modificare un'arma

1. Scegli un'arma dalla lista a sinistra. Usa la ricerca (**Ctrl+K**: arma, hash o risorsa) e i filtri (fonte, stato, categoria). **↑ ↓** scorrono la lista. Con la stella aggiungi un'arma ai **Preferiti**.
2. Cambia i valori nei gruppi di campi: Danno, Headshot, Caduta del danno, Precisione, Rinculo, Cadenza e caricatore, Ricarica, Gittata, Impatto e proiettile, Esplosione, Statistiche HUD, Munizioni. Ogni campo ha un tooltip con il significato e il tag meta.
3. Le modifiche sono una **bozza**. **Ctrl+Z / Ctrl+Y** annullano e ripetono. Per ogni campo puoi ripristinare il valore salvato o **Riporta a vanilla**; puoi annullare la bozza dell'arma o tutte le bozze.
4. Opzionale: attiva **Anteprima locale** per applicare i campi LIVE solo al tuo client mentre modifichi, prima di pubblicare.
5. Premi **Applica**: i campi LIVE si applicano subito a tutti i giocatori, il resto viene salvato (i valori HOT arrivano ai giocatori al prossimo ingresso o riavvio).

{% hint style="warning" %}
**Le munizioni sono un blocco condiviso**: cambiare le munizioni massime cambia tutte le armi con lo stesso tipo di munizione.
{% endhint %}

{% hint style="info" %}
Un'arma senza blocco meta (per esempio aggiunta con `Config.ExtraWeapons`) mostra "Nessun blocco meta: solo campi LIVE". Le armi che non esistono sulla tua game build sono indicate come "Non disponibile su questa gamebuild".
{% endhint %}

### Danno di armi melee ed esplosive

`Danno per colpo` non funziona per armi melee ed esplosive. Usa il **Moltiplicatore danno** (`DamageMult`, 1.0 = invariato): è l'unico modo per regolarle.

## Grafici: danno per distanza, colpi per uccidere, TTK

L'editor mostra danno per distanza, **colpi per uccidere** (corpo e testa) e **tempo per uccidere**, usando `Config.KillHealth` (default 120) come riferimento. Modello: vita + armatura = HP da rimuovere; danno per colpo = Damage x caduta per distanza x pallini (`BulletsInBatch`) x moltiplicatore headshot (entro `MaxHeadShotDistancePlayer`).

**Imposta danno** sceglie un numero di colpi N e imposta `Damage` per uccidere esattamente in N colpi (non N-1). Se il danno necessario supera il massimo del campo viene limitato.

## Accessori (Componenti)

La scheda **Componenti** modifica gli accessori dell'arma: capienza dei caricatori estesi, modificatore di precisione (mirini, impugnature), modificatore di danno (silenziatori), modificatori di distanza e danno della caduta (canne, compensatori), rinculo del mirino e variazioni delle statistiche HUD. I campi degli accessori sono HOT e marcati come sperimentali.

## Globali giocatore

La scheda **Globali** contiene 4 moltiplicatori LIVE per ogni giocatore:

| Campo                  | Effetto                                                          |
| ---------------------- | ---------------------------------------------------------------- |
| Danno armi (globale)   | Moltiplicatore del danno di tutte le armi da fuoco (minimo 0.1). |
| Difesa armi (globale)  | Moltiplicatore del danno da arma da fuoco subito.                |
| Danno melee (globale)  | Moltiplicatore del danno corpo a corpo.                          |
| Difesa melee (globale) | Moltiplicatore del danno corpo a corpo subito.                   |

## Confronto

La scheda **Confronto** mostra da 2 a 4 armi affiancate: danno per distanza, colpi per uccidere, tempo per uccidere, DPS, statistiche HUD e una tabella.

## Modifiche

La scheda **Modifiche** elenca le armi già cambiate rispetto al vanilla e mostra le differenze bozza / salvato / vanilla.

## Preset

* Preset di fabbrica: **Realistico**, **Arcade**, **RP lento**. Non si possono modificare. Nei preset di fabbrica i numeri sono moltiplicatori applicati al valore base di ogni arma.
* **Salva come preset** memorizza i valori attuali con un nome. Gli admin possono spuntare **Preset globale (admin)**.
* Applica un preset a un'arma, a una categoria (**Applica alla categoria**) o a tutto. L'anteprima indica quanti campi su quante armi cambia.
* Il preset viene applicato **subito dal server** (non alla bozza).
* Limiti: `Config.Limits.maxPresets` (100 in totale) e `maxPresetsPerAuthor` (20 per autore; gli admin non hanno tetto).

## Cronologia

La scheda **Cronologia** elenca le versioni salvate. **Rollback** ripristina una versione dopo una conferma (admin). Vengono conservate `Config.HistoryMax` (default 500) istantanee.

## Import / Export

* **Esporta JSON**: solo la bozza o tutti i valori salvati; opzionalmente include i campi LIVE. Copia negli appunti o scarica.
* **Esporta .meta**: scarica i valori come file meta.
* **Importa**: incolla il JSON o scegli un file, premi **Verifica**, poi **Importa**. Le armi importate finiscono nella **bozza**: controlla e premi Applica. Dimensione massima: `Config.Limits.maxImportBytes` (256 KB).

## Impostazioni

Nell'editor puoi cambiare la lingua e la scala della UI.

## Scorciatoie da tastiera

| Tasti           | Azione                                                    |
| --------------- | --------------------------------------------------------- |
| Ctrl+Z / Ctrl+Y | Annulla / ripeti                                          |
| Ctrl+K          | Cerca                                                     |
| ↑ ↓             | Scorri le armi                                            |
| Esc             | Chiudi (chiede conferma se ci sono modifiche non salvate) |


---

# 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/weapons-editor/usage-guide.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.
