> 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/troubleshooting.md).

# Risoluzione problemi e FAQ

{% hint style="info" %}
Primo passo per qualunque problema di HOT/patch: lancia `/wepeditor_selftest` da admin e leggi il report nella **console del server**.
{% endhint %}

### L'editor non parte: "ox\_lib non è avviato: ghiaccio\_weaponeditor non parte."

`ox_lib` è obbligatorio. Aggiungi `ensure ox_lib` **prima** di `ensure ghiaccio_weaponeditor`.

### Ho cambiato il caricatore (o un altro campo HOT) ma non succede nulla

I valori HOT valgono **al prossimo ingresso (riconnessione) o riavvio del server**, non subito. Controlla anche:

1. Nel `server.cfg` c'è `add_filesystem_permission ghiaccio_weaponeditor write ghiaccio_weaponeditor_patch` (il selftest S6 stampa la riga se manca).
2. `ensure ghiaccio_weaponeditor_patch` viene **dopo** ogni altra risorsa di armi.
3. Fai il controllo S7: imposta Pistol `ClipSize` 50, salva, riconnettiti, poi `/wepeditor_selftest check`.

### Devo attivare `Config.HotReload`?

No. È sperimentale e non funziona su build 3258: dopo il riavvio della patch a runtime, `ClipSize` dell'arma e dell'accessorio restano ai valori precedenti finché il giocatore non si riconnette.

### Il mouse resta bloccato dopo aver chiuso l'editor

Usa `/weaponeditor_close` (uscita di emergenza).

### "Non sei autorizzato a usare questo comando." / "Non hai il permesso per questa azione."

Controlla le righe `add_ace` e i livelli cumulativi (`admin` > `hot` > `edit` > `use`). I job possono dare al massimo `edit`. Vedi [Comandi e permessi](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/weapons-editor/commands-and-permissions.md).

### "La UI non si è caricata (web/dist mancante?)."

La cartella della risorsa è incompleta o rinominata. Riscaricala da [portal.cfx.re](https://portal.cfx.re) > Granted Assets e mantieni il nome `ghiaccio_weaponeditor`.

### Mancano le armi del mio pack

Lancia `/gwe_rescan`. Se il pack usa glob e `io.popen` non è disponibile (selftest S5), elenca i suoi file in `Config.ExtraMetaFiles`. Per un'arma senza alcun meta usa `Config.ExtraWeapons` (solo campi LIVE).

### "Questa arma non ha un blocco meta: sono modificabili solo i campi LIVE"

L'arma non è stata trovata in nessun file meta (per esempio viene da `Config.ExtraWeapons`). Sono modificabili solo i campi LIVE.

### Le modifiche al danno non hanno effetto su coltelli o esplosivi

`Danno per colpo` non funziona per armi melee ed esplosive: usa il **Moltiplicatore danno**.

### "Valore fuori dai limiti" / "Valori incoerenti tra loro."

Il server valida ogni valore. L'inizio della caduta del danno deve essere minore o uguale alla fine; la distanza minima dell'headshot deve essere minore o uguale alla massima.

### "Troppe richieste: riprova tra un secondo."

È stato raggiunto il rate limit per giocatore (`Config.RateLimit`, default burst 12, 4 al secondo). Attendi un momento.

### "Un altro salvataggio è in corso" / "Modifica in conflitto con un salvataggio più recente."

Qualcun altro ha salvato nello stesso momento. Attendi e riprova; se serve ricarica l'arma.

### Un avviso dice che `Config.Webhook` è deprecato

Sposta l'URL in `ServerConfig.Webhook` dentro `config_server.lua` (o nel convar `gwe_webhook`) e svuota `Config.Webhook`: `config.lua` è leggibile da ogni giocatore.

### I giocatori possono barare sui valori LIVE?

Un cheater può sempre cambiare in locale i propri moltiplicatori LIVE. L'editor non è un anticheat.

### Quanto pesa sulle prestazioni?

A riposo **0.00 ms**: nessun thread permanente, solo handler di state bag, eventi e callback NUI.


---

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