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

# Integrazioni e adapter

## Framework

`Config.Framework = 'auto'` rileva il framework; forzalo con `'esx'`, `'qbcore'` o `'qbox'`. I passi di installazione per ogni framework sono in [Installazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/multichar/installation.md).

## Adapter vestiti

`Config.Appearance.adapter`:

* `'auto'` (default) prova illenium-appearance, fivem-appearance, rcore\_clothing, qb-clothing, esx\_skin e usa il primo avviato.
* Oppure forzane uno: `'illenium'`, `'fivem_appearance'`, `'rcore'`, `'qb_clothing'`, `'esx_skin'`, `'custom'`, `'none'`.

| Opzione                    | Cosa fa                                                                                                                                                                                                                                                                                               |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `previewMode`              | Come si vede l'aspetto in selezione: `auto`, `ped` (applicato al ped locale), `player` (sul ped del giocatore) o `monogram` (nessun aspetto in selezione). Se lo script non sa vestire un ped diverso dal giocatore (esx\_skin), la risorsa usa il giocatore stesso, nascosto nel suo bucket privato. |
| `forceCreatorOnNew = true` | Dopo l'identity si apre il creatore. Gira nel **bucket privato** del giocatore; il bucket 0 torna solo a creatore chiuso o allo spawn.                                                                                                                                                                |
| `defaultOutfits`           | Senza adapter il personaggio entra con questi abiti (`m` e `f`).                                                                                                                                                                                                                                      |

Con `esx_skin` l'aspetto si applica anche ai ped locali (formato skinchanger applicato con le native): con ESX tutti i personaggi si vedono vestiti insieme in selezione.

**Altro script di aspetto**: `adapter = 'custom'` e compila `adapters/appearance/custom.lua` (2 funzioni, istruzioni nel file). Gli adapter sono in chiaro, non sotto escrow.

## Importare i personaggi

Per portare i personaggi di un altro script, dalla **console del server**:

```
gmc import esx
gmc import qb
gmc import qbox
```

Senza `--apply` è solo una prova (dry run). Con `--apply` importa. `import` si usa solo da console e richiede il permesso `admin`.

Su ESX, `Config.ESX.prefix = 'char'` è identico a `esx_multicharacter`: i personaggi esistenti `char1:<license>` compaiono da soli. Se un personaggio non compare, controllalo con `gmc info <target>` e `gmc backup list <target>`.

## Accredito slot da Tebex

Nessuna API key. Il pacchetto Tebex esegue un comando console; il riferimento della transazione lo rende idempotente (un acquisto = un solo accredito):

```
gmc slots add fivem:{id} 1 --yes tebex:{transaction}
```

* Per un giocatore mai entrato il grant resta in attesa e si applica al primo ingresso.
* Slot a tempo: aggiungi `--days 30`.
* Imposta `Config.Slots.unlockUrl` (`config_server.lua`) sul link del pacchetto: il pulsante "Sblocca" della selezione lo apre.
* Ruoli: regole degli slot via ACE in `Config.Slots.rules` (i ruoli Discord arrivano come ACE da DiscordAcePerms/txAdmin).

## Loadscreen ed editor locale

La risorsa include il suo loadscreen (`loadscreen/`): sfondo gradiente / immagine / slideshow / video locale, logo e nome server, colori e accento (blu ghiaccio di default), musica con volume e muto, consigli che ruotano, link e barra di progresso **reale** (messaggi `loadProgress`, `startInitFunction`... di FiveM).

Si personalizza da **un solo file**, `loadscreen/config.json`, o con l'**editor web locale**: doppio clic su `editor.bat` (Windows) o `./editor.sh`. Offre anteprima dal vivo del loadscreen vero, salvataggio automatico (copia precedente in `config.prev.json`), caricamento di immagini / video / musica in `loadscreen/media/` con controllo del contenuto e dei limiti, e "Ripristina default". L'editor ascolta solo su 127.0.0.1 e scrive solo dentro `loadscreen/`. JSON rotto o campi sbagliati: si usano i default e l'avviso va solo in console. Il riferimento completo di ogni chiave è in `loadscreen/README.md`.

{% hint style="warning" %}
Il manifest dichiara `loadscreen` e `loadscreen_manual_shutdown 'yes'`: il loadscreen lo chiude questa risorsa (a selezione pronta; c'è un watchdog di sicurezza, `Config.Loadscreen.watchdogSec`). FiveM usa **un solo loadscreen** per server: ferma gli altri. `gmc selftest` li segnala. Per tenere un altro loadscreen, togli le 3 righe `loadscreen*` dal `fxmanifest.lua` di questa risorsa.
{% endhint %}

## Weather sync

Mentre la scena è aperta la risorsa mette in pausa il sync del meteo e decide lei ora e meteo; alla chiusura il sync riparte. Funziona con `qb-weathersync`, `cd_easytime` e `Renewed-Weathersync` (righe in `Config.Scenes.weatherPause`). Per altri script aggiungi una riga con evento di pausa e ripresa:

```lua
{ resource = 'qb-weathersync', pause = 'qb-weathersync:client:DisableSync', resume = 'qb-weathersync:client:EnableSync' },
```

Limiti: il `vSync` originale non ha una pausa pulita, quindi il meteo della scena non è garantito (fermalo o passa a Renewed-Weathersync). `cd_easytime` in pausa forza il meteo `EXTRASUNNY`.

## Webhook Discord

Il log di audit va in console e nel database (`ghiaccio_mc_audit`) e, se vuoi, in un webhook Discord. L'URL del webhook si legge **solo** da una convar del server, mai da un file di config (i file di config vengono replicati ai client). Nel `server.cfg`:

```cfg
set ghiaccio_mc:webhook "https://discord.com/api/webhooks/..."
```

Retention del log di audit: `Config.Logging.retentionDays` (180).

## Export

Due export client per integrarsi col pause menu (`SetPauseBlocked`, `AddPauseItem`): vedi [Comandi e permessi](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/multichar/commands-and-permissions.md#export-client). La risorsa **non ha export server**.


---

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