> 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/multichar/commands-and-permissions.md).

# Comandi e permessi

## Comandi del giocatore

I nomi si impostano in `Config.Relog` e `Config.Select`. Imposta un comando a `''` per disattivarlo.

| Comando         | Tasto di default             | Cosa fa                                                                                                        |
| --------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `/relog`        | nessuno (`Config.Relog.key`) | Torna alla selezione personaggio, con un conto alla rovescia gestito dal server. Nome: `Config.Relog.command`. |
| `/personaggi`   | nessuno                      | Avvia anch'esso il relog. Nome: `Config.Select.command`.                                                       |
| `/gmc camdebug` | nessuno                      | Diagnostica della camera in F8. Solo in gioco, nessun permesso.                                                |

Il tasto opzionale del relog usa `RegisterKeyMapping`: è vuoto di default e ogni giocatore lo cambia in **Impostazioni > Tasti > FiveM**. Nel pause menu il pulsante **Relog** ha la scorciatoia `R`.

## Relog

Il giocatore torna alla selezione personaggio salvando lo stato. Il comando, il tasto opzionale e il pulsante **Relog** del pause menu **inviano solo la richiesta**: la decide il server.

Flusso, senza nessuna conferma da ripetere: il server valida, il ped si **congela** (`FreezeEntityPosition`, controlli bloccati, invincibile) e compare un piccolo conto alla rovescia di `Config.Relog.countdownSec` secondi (5). A zero parte il relog, con dissolvenza in uscita, attesa della scena e dissolvenza in entrata (`Config.Transition`, mai un nero di colpo né prolungato). Il pulsante del pause, `/relog` e il tasto fanno la stessa cosa; un secondo `/relog` durante il conto non fa nulla.

* **Stessi blocchi** di `Config.Pause.changeCharacter`: morto, ammanettato, danni recenti, in veicolo, `allowedAce`. Il motivo compare nel pause menu sotto il pulsante.
* **Il tempo è del server.** Il client congela il ped e mostra il conto, ma non può accorciarlo né completarlo. Il server ricontrolla ogni 250 ms e, a fine tempo, ripete tutte le regole (ACE, cooldown, veicolo) prima del logout.
* **Annullo**: se nel frattempo il giocatore muore o viene ammanettato (o preme Esc/Backspace) il conto si ferma, il ped si sblocca e compare il motivo. Se il server rifiuta la richiesta (cooldown, ACE...) lo sblocco è immediato.
* **Cooldown**: `Config.Relog.cooldownSec`, oppure (vuoto) `Config.Pause.changeCharacter.cooldownSec`. Un logout fallito non attiva il cooldown.
* **Salvataggio** su ESX, QBCore e Qbox: salva, logout del framework, poi selezione; se il logout non conferma il giocatore resta in gioco. Una richiesta alla volta per giocatore, limite di frequenza, audit `char.relog`.

## Comandi staff `/gmc`

Il nome è `Config.Staff.command`. Funzionano da chat, console server, txAdmin e Tebex. `<target>` = ID server, `license:..`, `license2:..`, `fivem:..`, `discord:..`, `steam:..` oppure la chiave del personaggio. Online o offline.

| Comando                                                     | ACE (prefisso `ghiaccio_multichar.`)                  |
| ----------------------------------------------------------- | ----------------------------------------------------- |
| `info <target>`, `log <target> [n]`, `backup list <target>` | `staff.view`                                          |
| `slots add\|remove\|set <target> <n> [--days D] [motivo]`   | `staff.slots`                                         |
| `char lock\|unlock <target> <pg> [motivo]`                  | `staff.chars`                                         |
| `char delete <target> <pg> [motivo]`                        | `staff.delete` (codice di conferma, backup 14 giorni) |
| `char wipe <target> <pg> [--keep-appearance] [motivo]`      | `staff.wipe` (codice di conferma, backup 14 giorni)   |
| `backup restore <id>`                                       | `staff.restore` (codice di conferma)                  |
| `scene` (elenco delle scene caricate e di quelle in uso)    | `scene`                                               |
| `camdebug` (diagnostica della camera in F8, solo in gioco)  | nessuno                                               |
| `selftest`, `reload`, `import esx\|qb\|qbox [--apply]`      | `admin` (`import` solo da console)                    |

Le azioni distruttive stampano un riepilogo e un codice da confermare con `/gmc confirm <codice>` entro 60 s (`Config.Staff.confirmTimeoutSec`); da console `--yes` salta la conferma. **I giocatori non possono eliminare i propri personaggi.**

* `gmc selftest`: controlla framework, oxmysql, migrazioni, config non valida (compreso il timeout RPC), risorse in conflitto, ESX provide, Qbox (le 2 righe di config e le 2 porte di delete), adapter vestiti e scene. Livelli: errore, avviso, info, ok.
* `gmc reload`: ricarica le scene da `data/scenes.json`.
* `gmc import`: vedi [Integrazioni](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/multichar/integrations.md#importare-i-personaggi).

## Permessi (ACE)

```cfg
add_ace group.admin ghiaccio_multichar.admin allow            # tutto
add_ace group.mod ghiaccio_multichar.staff.view allow
add_ace group.mod ghiaccio_multichar.staff.slots allow
add_ace group.mod ghiaccio_multichar.staff.chars allow
add_ace group.scenografo ghiaccio_multichar.scene allow       # solo /gmc scene
add_principal identifier.license:XXXXXXXX group.admin
```

Nodi: `admin` (tutto), `staff.view`, `staff.slots`, `staff.chars`, `staff.delete`, `staff.wipe`, `staff.restore`, `scene`. Il prefisso è `Config.Staff.acePrefix`. Per chi non usa ACE: `Config.Staff.groups` (gruppi del framework): `admin` = tutto, `mod` = `Config.Staff.modNodes`.

Altri usi di ACE: regole degli slot (`Config.Slots.rules`), filtri dei punti di spawn (`ace` in `Config.Spawn.locations`) e `allowedAce` del relog (`Config.Pause.changeCharacter.allowedAce`).

## Export client

Altre risorse possono integrarsi col pause menu:

```lua
-- Blocca il pause menu mentre la tua risorsa ha un menu aperto
exports.ghiaccio_multichar:SetPauseBlocked(true)
-- ...e rilascialo
exports.ghiaccio_multichar:SetPauseBlocked(false)

-- Aggiungi una voce al pause menu.
-- id <= 32 caratteri (il prefisso "link:" è riservato), label <= 40, event <= 80.
-- Ritorna true se va a buon fine, false se gli argomenti non sono validi.
exports.ghiaccio_multichar:AddPauseItem({
    id = 'my_menu',
    label = 'Il mio menu',
    event = 'my_resource:openMenu', -- evento client locale, lanciato con l'id della voce al click
})
```

Una risorsa che si ferma rilascia i suoi blocchi e rimuove le sue voci dal pause automaticamente.

## Export ed eventi server

La risorsa **non ha export server**. I suoi eventi di rete (RPC client-server con nonce, eventi di stato e notifica) sono un protocollo interno e non un'API supportata.


---

# 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/multichar/commands-and-permissions.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.
