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

# Installazione

## Requisiti

* Un server FiveM con **ox\_lib** avviato.
* Opzionale: **oxmysql**, solo se imposti `Config.Storage = 'oxmysql'`.
* Framework opzionale: ESX (`es_extended`), QBCore (`qb-core`) o Qbox (`qbx_core`). Senza framework l'editor funziona in standalone.

## 1. Download

Lo script è distribuito tramite **Cfx.re Asset Escrow**. Dopo l'acquisto accedi a [portal.cfx.re](https://portal.cfx.re) con l'account Cfx.re usato per l'acquisto e apri **Granted Assets**. Da lì scarica `ghiaccio_weaponeditor`.

{% hint style="info" %}
Le risorse in escrow funzionano solo sui server la cui license key appartiene all'account Cfx.re che ha fatto l'acquisto.
{% endhint %}

## 2. Copia le risorse

1. Copia `ghiaccio_weaponeditor` in `resources/`. **Non rinominare la cartella**: NUI e percorso della patch dipendono dal nome.
2. Copia **`ghiaccio_weaponeditor_patch`** (la cartella accanto nel download) in `resources/` come risorsa a sé: contiene i `.meta` che l'editor genera.

{% hint style="warning" %}
Non modificare a mano i `.meta` di `ghiaccio_weaponeditor_patch`: il loro contenuto è scritto dall'editor. I nomi dei file sono fissi, quindi basta un semplice `restart` (senza `refresh`).
{% endhint %}

## 3. server.cfg

```cfg
ensure ox_lib
# ensure oxmysql                        # solo con Config.Storage = 'oxmysql'
# ... il framework (es_extended / qb-core / qbx_core) e tutte le altre risorse (anche quelle di armi)
ensure ghiaccio_weaponeditor
ensure ghiaccio_weaponeditor_patch      # DOPO ogni altra risorsa con WEAPONINFO, cosi' la patch vince

# OBBLIGATORIO: l'editor scrive la patch (senza, i valori HOT/RESTART non arrivano ai giocatori)
add_filesystem_permission ghiaccio_weaponeditor write ghiaccio_weaponeditor_patch

# permessi (livelli cumulativi: admin > hot > edit > use)
add_ace group.admin ghiaccio_weaponeditor.admin allow   # tutto: preset globali, rollback, rescan
add_ace group.admin ghiaccio_weaponeditor.hot allow     # campi HOT, munizioni, accessori
add_ace group.mod   ghiaccio_weaponeditor.edit allow    # campi LIVE
add_ace group.mod   ghiaccio_weaponeditor.use allow     # sola lettura e anteprima

# esempio per un singolo giocatore:  add_ace identifier.license:TUA_LICENSE ghiaccio_weaponeditor.admin allow

# webhook Discord opzionale per l'audit (oppure ServerConfig.Webhook in config_server.lua; mai in config.lua)
# set gwe_webhook "https://discord.com/api/webhooks/..."
```

### Ordine degli ensure

| Ordine | Risorsa                                                            | Perché                                                                   |
| ------ | ------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| 1      | `ox_lib`                                                           | Dipendenza obbligatoria.                                                 |
| 2      | `oxmysql`                                                          | Solo con `Config.Storage = 'oxmysql'`.                                   |
| 3      | Il framework e tutte le altre risorse, **comprese quelle di armi** | Le risorse di armi avviate vengono scansionate come dati di riferimento. |
| 4      | `ghiaccio_weaponeditor`                                            | L'editor.                                                                |
| 5      | `ghiaccio_weaponeditor_patch`                                      | **Dopo** ogni altra risorsa con WEAPONINFO, così i suoi valori vincono.  |

{% hint style="danger" %}
La riga `add_filesystem_permission` è **obbligatoria**: senza, i valori HOT/RESTART non arrivano ai giocatori. `/wepeditor_selftest` (test S6) stampa la riga esatta se il permesso manca.
{% endhint %}

## 4. Rilevamento del framework

Con `Config.Framework = 'auto'` (default) il framework viene rilevato in quest'ordine: **`qbx_core` > `qb-core` > `es_extended`**, altrimenti standalone. Il framework viene risolto a ogni chiamata, quindi il rilevamento funziona anche se il framework parte dopo l'editor. Imposta `Config.Framework` a `'esx'`, `'qbcore'`, `'qbox'` o `'standalone'` per forzarlo.

I permessi ACE funzionano sempre. Gruppi e job del framework sono extra opzionali (vedi [Comandi e permessi](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/weapons-editor/commands-and-permissions.md)):

{% tabs %}
{% tab title="ESX" %}
I gruppi del framework si leggono con `xPlayer.getGroup()`.

```lua
Config.Permissions.groups = { admin = 'admin' }
```

{% endtab %}

{% tab title="QBCore" %}
I gruppi del framework si controllano con `HasPermission` di QBCore.

```lua
Config.Permissions.groups = { god = 'admin', admin = 'admin' }
```

{% endtab %}

{% tab title="Qbox" %}
I gruppi si controllano come gruppi ACE `group.<nome>`.

```lua
Config.Permissions.groups = { admin = 'admin' }
```

{% endtab %}

{% tab title="Standalone" %}
I gruppi si controllano come gruppi ACE `group.<nome>`. La configurazione più semplice è usare solo le righe `add_ace` nel `server.cfg`.
{% endtab %}
{% endtabs %}

## 5. Configura (opzionale)

Modifica `config.lua` (lingua `Config.Locale`, comando, tasto, gruppi/job del framework, storage) e `config_server.lua` (webhook). Vedi [Configurazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/weapons-editor/configuration.md).

## 6. Verifica

1. Riavvia il server e apri l'editor in gioco con `/weaponeditor`.
2. Lancia `/wepeditor_selftest` da admin e leggi il report PASS/FAIL/INFO nella **console del server**. Vedi [Comandi e permessi](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/weapons-editor/commands-and-permissions.md).

## Escrow: cosa puoi modificare

`client/`, `server/` e `shared/` sono cifrati (Cfx.re Asset Escrow). Restano modificabili: `config.lua`, `config_server.lua`, `locales/`, `bridge/`, `data/`.


---

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