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

# Risoluzione problemi e FAQ

{% hint style="info" %}
Inizia ogni indagine con `gmc selftest` dalla console del server: elenca cosa correggere. Livelli: errore, avviso, info, ok.
{% endhint %}

### Schermo nero all'ingresso

Guarda F8 e la console server, poi lancia `gmc selftest`. Cause comuni:

* `oxmysql` non avviato, oppure la risorsa parte prima del framework.
* ESX non vede `esx_multicharacter` (vedi [Installazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/multichar/installation.md#esx-legacy): la risorsa resta passiva).
* `qb-multicharacter`, `qb-spawn` o `esx_multicharacter` ancora attivi.
* È in esecuzione un altro loadscreen (FiveM ne usa uno solo).

Un watchdog (`Config.Scenes.revealTimeoutMs`, 15 s) toglie comunque lo schermo nero; se la scena non carica si vede lo sfondo semplice.

### Il cursore del mouse non risponde al primo ingresso

Corretto nella 1.0.1 e nella 1.0.2 (vedi il [Changelog](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/multichar/changelog.md)). Se lo vedi su una versione precedente, aggiorna.

### Un personaggio non compare

Lancia `gmc info <target>` e `gmc backup list <target>`. Per portare i personaggi di un altro script usa `gmc import esx|qb|qbox` da console (senza `--apply` è solo una prova). Su un server già avviato nessun personaggio esistente viene bloccato dal default; un personaggio bloccato significa che lo staff ha usato `/gmc char lock` o `/gmc slots remove|set`.

### La scena di selezione si vede male (ped mancante, fuori quadro)

Metti `Config.Scenes.debug = true` e in gioco lancia `/gmc camdebug` (chat o F8, nessun permesso). In F8 escono scena, camera (posizione, fov, distanza, verifica) e, per ogni ped, coordinate, `IsEntityOnScreen`, suolo e posa, più il segnaposto e il metodo di evidenziazione. Con `debug` si vedono anche i posti scartati. Manda quelle righe al supporto.

### Il creatore d'aspetto fallisce

Il giocatore non resta mai bloccato: se il salvataggio dell'aspetto non va a buon fine viene ritentato 3 volte, poi si torna alla selezione con un messaggio d'errore e il creatore riparte al rientro. Controlla l'adapter con `gmc selftest`.

### Meteo e ora in selezione

Vedi [Integrazioni](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/multichar/integrations.md#weather-sync). `vSync` non si può mettere in pausa in modo pulito; `cd_easytime` in pausa forza `EXTRASUNNY`.

### Il pause menu non si apre / ESC non fa nulla

Le situazioni sono controllate da `Config.Pause.block`. Con `blockedAction = 'ignore'` ESC non fa nulla mentre è bloccato; con `'native'` si apre il menu GTA. Se il rilevamento fallisce, forza `Config.Pause.interceptMode` a `'controls'`, `'frontend'` o `'native'`. Una pagina nativa (mappa, impostazioni, tasti) che non si apre entro 1 s sparisce dalla UI: gli hash sono in `Config.Pause.native`.

### I giocatori non riescono a tornare alla selezione

Funziona solo `/relog` (o il pulsante del pause menu) e segue le regole di `Config.Pause.changeCharacter`: morto, ammanettato, danni recenti, in veicolo e il cooldown lo bloccano. Il motivo compare nel pause menu. Un secondo `/relog` durante il conto non fa nulla.

### Qbox: avviso "delete door still open"

Segui il passo 3 dell'installazione Qbox: rimuovi i due handler `deleteCharacter` in `qbx_core`. Vedi [Installazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/multichar/installation.md#qbox).

### Slot: un giocatore ha più o meno slot del previsto

Gli slot sono `Config.Slots.default` più regole ACE, `/gmc slots add` e accrediti Tebex, fino a `Config.Slots.max` (massimo 15). Su un server già avviato un account non ha mai meno slot dei suoi personaggi. Controlla con `gmc info <target>`.

### Avviso sul timeout RPC nel selftest

`Config.Rpc.clientTimeoutMs` deve essere almeno `Config.ESX.joinTimeoutMs` + 5000.

## Ancora bloccato?

Manda l'output di `gmc selftest`, il framework e le righe di F8 al [supporto](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/support.md).


---

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