> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelli di server

> Layout di server già pronti — canali, ruoli e permessi — costruiti nel tuo server con una sola azione, dal catalogo o da un link a un modello di Discord.

I modelli di server sono layout già pronti — canali, categorie, ruoli e permessi, progettati come un insieme — che Vetox costruisce nel tuo server con una sola azione. Sfogliali su [vetox.io/templates](https://vetox.io/templates) oppure applicane uno da Discord con [`/template`](#il-comando-template).

<Info>
  **Gratuito con ogni piano**, Starter incluso. Applicare un modello è, dietro le quinte, un ripristino di [Server Backup](/it/server-management/server-backup): crea la stessa copia di sicurezza e mostra la stessa scheda di avanzamento, ma senza alcun blocco premium.
</Info>

<Note>
  **Il catalogo è scritto in inglese.** Il valore di un modello sta nei nomi esatti di canali e ruoli che scrive nel tuo server, e quelli vengono inseriti alla lettera. Tradurre la pagina attorno a nomi di canali non tradotti prometterebbe un server nella tua lingua per poi consegnarne uno in inglese: per questo il catalogo è volutamente solo in inglese. Tutte le altre pagine della documentazione Vetox, e la dashboard stessa, restano nella tua lingua.
</Note>

## Cosa contiene un modello

| Incluso                     | Note                                                                                                                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Categorie e canali**      | Ogni tipo — testuale, vocale, annunci, stage, forum — con argomento, modalità lenta e le rispettive sovrascritture dei permessi                         |
| **Ruoli**                   | Nome, colore, visualizzazione separata, menzionabilità e l'insieme di permessi che ogni ruolo deve avere                                                |
| **Impostazioni del server** | Livello di verifica, filtro dei contenuti, notifiche predefinite, timeout AFK e quali canali sono quello di sistema, delle regole e degli aggiornamenti |

<Warning>
  Un modello è un **layout**. Non contiene mai messaggi, membri, ban, emoji o adesivi, e non può in alcun modo portare nel tuo server i contenuti di un altro.
</Warning>

<Note>
  **Un modello non rinomina mai il tuo server.** Applica il layout che ha progettato e lascia il nome e la descrizione del tuo server esattamente come sono, in entrambe le modalità.
</Note>

## Il catalogo

220 modelli distribuiti su 22 categorie:

|                   |                   |                     |
| ----------------- | ----------------- | ------------------- |
| Gaming            | Esports           | Clans & Guilds      |
| Community         | Friends & Private | Support & Help Desk |
| Developers        | Education         | Study Groups        |
| Content Creators  | YouTube           | Streaming           |
| Anime & Manga     | Roleplay          | Music               |
| Art & Design      | Business          | Startups            |
| Local Communities | Web3 & Crypto     | Events              |
| Social & Hobbies  |                   |                     |

La pagina di ogni modello mostra l'intero albero dei canali e l'elenco dei ruoli prima che tu applichi qualsiasi cosa, oltre a per chi è pensato, come va gestito e quali errori è progettato per evitare. Dall'hub del catalogo puoi cercare, filtrare per dimensione e lingua e ordinare per popolarità.

## Applicare un modello dal sito

<Steps>
  <Step title="Apri il modello e premi Applica">
    Dalla sua pagina su [vetox.io/templates](https://vetox.io/templates). Se non hai effettuato l'accesso, Vetox ti chiede prima di accedere con Discord e poi ti riporta qui.
  </Step>

  <Step title="Scegli il server">
    Vengono proposti solo i server che puoi configurare.
  </Step>

  <Step title="Scegli Unisci o Sostituisci">
    La finestra si apre sulla pagina Server Backup del tuo server con il modello già selezionato. Vedi [le due modalità](#le-due-modalità).
  </Step>

  <Step title="Leggi il piano">
    Vetox legge il tuo server così com'è e ti dice esattamente quanti canali e ruoli verranno **creati**, **riutilizzati** ed **eliminati** prima che accada qualsiasi cosa.
  </Step>

  <Step title="Conferma">
    Sostituisci ti chiede prima di digitare il nome del server. Vetox crea quindi un backup di sicurezza e costruisce il modello, mostrando l'avanzamento sulla pagina.
  </Step>
</Steps>

<Tip>
  Puoi raggiungere la stessa finestra senza passare dal sito: apri **Backup → Server Backup** nella dashboard del tuo server.
</Tip>

## Le due modalità

|                                   | Unisci *(predefinita)*                                                   | Sostituisci                 |
| --------------------------------- | ------------------------------------------------------------------------ | --------------------------- |
| Canali e ruoli già esistenti      | **Riutilizzati** — le impostazioni del modello vengono applicate ai tuoi | Eliminati prima             |
| Tutto il resto nel server         | Mantenuto                                                                | Eliminato                   |
| Impostazioni del server           | Non toccate                                                              | Applicate dal modello       |
| Nome e descrizione del tuo server | Mantenuti                                                                | Mantenuti                   |
| Conferma                          | Pulsante Conferma                                                        | Digitare il nome del server |
| Permesso di backup necessario     | Creazione                                                                | Distruttiva                 |

<Tip>
  **Unisci è la modalità sicura ed è quella predefinita.** Aggiunge ciò che manca e adotta ciò che c'è già, quindi applicare una seconda volta lo stesso modello non cambia nulla e non duplica nulla.
</Tip>

Unisci confronta per **nome**, ignorando maiuscole e minuscole. Un ruolo corrisponde a un ruolo esistente con lo stesso nome che non sia gestito da un'integrazione. Un canale corrisponde a uno con lo stesso nome, lo stesso tipo **e** la stessa categoria superiore: così `#general` sotto **Text** e `#general` sotto **Voice Text** restano due canali distinti. I canali e i ruoli riutilizzati mantengono la posizione che hai dato loro; solo quelli nuovi vengono posizionati dal modello.

<Warning>
  **Sostituisci elimina ogni canale e ogni ruolo del server prima di costruire.** I membri non vengono mai espulsi, ma tutto il resto sparisce, e un modello non ripristina i messaggi. È il backup di sicurezza creato prima a permetterti di tornare indietro.
</Warning>

## Il backup di sicurezza

Prima di applicare un modello, Vetox fotografa il tuo server com'è in quel momento — canali, ruoli, impostazioni, emoji e adesivi — e lo salva come backup di tipo **Sicurezza** nella scheda Backup.

<Note>
  Se la copia di sicurezza non riesce, **il modello non viene mai applicato**. Non cambia nulla. Le copie di sicurezza vengono conservate per 7 giorni e non rientrano nel tuo limite di backup. Ripristinarne una riporta il server esattamente com'era.
</Note>

## Il comando `/template`

`/template` è la metà Discord del catalogo. Due sottocomandi, entrambi effimeri.

| Requisito           | Valore                                                     |
| ------------------- | ---------------------------------------------------------- |
| **Ti serve**        | Gestisci server, **e** Amministratore per applicarne uno   |
| **A Vetox serve**   | Visualizza canale — e altro ancora per costruire il layout |
| **Tempo di attesa** | 5s                                                         |
| **Dove**            | Solo nei server. Non disponibile nei DM                    |

<AccordionGroup>
  <Accordion title="/template load — costruire il modello in questo server" icon="wand-magic-sparkles">
    | Opzione    | Obbligatoria | Note                                                                                               |
    | ---------- | ------------ | -------------------------------------------------------------------------------------------------- |
    | `template` | **Sì**       | Un nome o un ID del catalogo, oppure un link a un modello di Discord. Con completamento automatico |
    | `mode`     | No           | `merge` (predefinita) o `replace`                                                                  |

    Alla prima pressione non viene applicato nulla. Vetox risponde con il piano, accompagnato dai pulsanti **Conferma** e **Annulla** che scadono dopo **60 secondi**; solo con Conferma crea il backup di sicurezza e inizia a costruire.
  </Accordion>

  <Accordion title="/template info — cosa contiene un modello" icon="circle-info">
    | Opzione    | Obbligatoria | Note                                                       |
    | ---------- | ------------ | ---------------------------------------------------------- |
    | `template` | **Sì**       | Un nome o un ID del catalogo. Con completamento automatico |

    Il numero di canali e ruoli, a cosa serve e un link alla sua pagina. `/template info` riguarda solo il catalogo Vetox: un link a un modello di Discord non ha una pagina di catalogo da descrivere, quindi per quelli usa `/template load`.
  </Accordion>
</AccordionGroup>

### Cosa puoi scrivere in `template`

Un solo campo, quattro cose che accetta:

| Cosa scrivi                                   | Esempio                            |
| --------------------------------------------- | ---------------------------------- |
| Il **nome** del modello                       | `Starter Community Hub`            |
| Il suo **ID**                                 | `community/starter-community-hub`  |
| Solo lo **slug**                              | `starter-community-hub`            |
| Un link o un codice di **modello di Discord** | `https://discord.new/H5qAZdEEeWdR` |

<Note>
  Un nome che corrisponde a due modelli viene rifiutato anziché indovinato: scegline uno dal completamento automatico oppure usa il suo ID. Il completamento automatico propone solo i modelli del catalogo; un link di Discord va digitato.
</Note>

```text theme={null}
/template info template:community/starter-community-hub
/template load template:Starter Community Hub
/template load template:https://discord.com/template/H5qAZdEEeWdR
/template load template:gaming/multi-game-hangout mode:replace
```

## I modelli di Discord

Discord consente al proprietario di un server di pubblicare il proprio server come modello da **Impostazioni server → Modello del server**, ottenendo un link come `https://discord.new/H5qAZdEEeWdR`.

<Tip>
  **Vetox applica quei link a un server che hai già** — incollane uno in `/template load` oppure nella finestra **Importa** della pagina Server Backup. Il link di Discord, da solo, crea sempre e solo un server **nuovo e vuoto**; Vetox è il modo per usarlo sul server che stai già gestendo.
</Tip>

<Note>
  Non funziona nel senso opposto: un modello del catalogo Vetox non ha un link `discord.new`, perché Discord li genera solo a partire da un server reale che può leggere. Per condividere un layout che hai creato, pubblica il tuo server come modello di Discord e condividi quel link, oppure esporta il server come file di backup.
</Note>

## Permessi

Applicare un modello modifica il tuo server, perciò l'operazione è protetta da due controlli.

| Controllo                                | Regola                                                                                                                                                                                                |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Discord**                              | Per applicare un modello con `/template load` ti serve **Amministratore**. Dalla dashboard vale il normale [Controllo accessi](/it/server-management/dashboard-permissions) per la sezione **Backup** |
| **Livello di permessi di Server Backup** | Unisci conta come creazione, Sostituisci come azione distruttiva. Con il livello predefinito — *Gli amministratori non possono eseguire azioni distruttive* — Sostituisci resta solo al proprietario  |

Il livello si trova sulla pagina Server Backup in **Impostazioni → Permessi** e solo il proprietario del server può cambiarlo. Vedi [Permessi](/it/server-management/server-backup).

### Cosa serve a Vetox

<Warning>
  Dai a Vetox il permesso **Amministratore** prima di applicare un modello e assicurati che il suo ruolo si trovi **sopra** i ruoli creati dal modello. Discord non permette a un bot di concedere un permesso che non possiede: quando succede il ruolo viene comunque creato, senza quei permessi, e Vetox te lo segnala.
</Warning>

## I limiti di canali e ruoli di Discord

<Warning>
  Un server può contenere al massimo **250 ruoli e 500 canali**, e Discord consente a un bot di creare al massimo 250 ruoli o 500 canali su uno stesso server **nell'arco di 48 ore**. Un modello grande, su un server che ne ha già molti, può raggiungere l'uno o l'altro limite.
</Warning>

Vetox controlla i limiti del server prima che tu confermi e ti avvisa se il modello lo porterebbe oltre: eliminane prima qualcuno oppure applica in modalità Sostituisci, così quelli vecchi spariscono. Il margine di creazione di 48 ore di Discord è un'altra cosa e non si recupera eliminando nulla; se una costruzione lo raggiunge, l'operazione si ferma mantenendo il punto in cui è arrivata, e `/backup status` mostra quando il limite decade.

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Quel modello non esiste">
    Il nome, l'ID o il link non corrisponde a nulla di pubblicato. Scegli dal completamento automatico oppure sfoglia [vetox.io/templates](https://vetox.io/templates). Un link di Discord deve essere un link a un **modello** (`discord.new/…` o `discord.com/template/…`), non a un invito.
  </Accordion>

  <Accordion title="Per creare un backup da Discord serve il permesso Amministratore">
    Applicare un modello crea prima un backup di sicurezza dell'intero server, quindi richiede Amministratore: con il solo Gestisci server potrebbero restarti nascosti dei canali che l'istantanea includerebbe comunque.
  </Accordion>

  <Accordion title="Solo chi è autorizzato dai permessi di backup del server può farlo">
    Il livello di permessi di Server Backup del server riserva questa azione al proprietario. O è il proprietario ad applicare il modello, oppure è lui a cambiare il livello in **Impostazioni → Permessi**.
  </Accordion>

  <Accordion title="Questa operazione supererebbe il limite di Discord">
    Il modello, sommato a ciò che hai già, supera i 250 ruoli o i 500 canali. Eliminane qualcuno, applica in modalità Sostituisci oppure scegli un modello più piccolo.
  </Accordion>

  <Accordion title="Un'altra operazione di backup è già in corso su questo server">
    Un solo backup, ripristino o applicazione di un modello alla volta per server. Aspetta che l'operazione in corso finisca oppure annullala dalla sua scheda di avanzamento.
  </Accordion>

  <Accordion title="Alcuni ruoli si trovano sopra Vetox nell'elenco dei ruoli">
    Quei ruoli sono stati segnalati e lasciati intatti: Discord non permette a un bot di modificare un ruolo più in alto del proprio. Sposta più in alto il ruolo di Vetox e applica di nuovo.
  </Accordion>

  <Accordion title="Il modello è stato applicato, ma un canale che avevo già è stato riutilizzato invece di essere ricreato">
    È Unisci che funziona come previsto: un canale con lo stesso nome, tipo e categoria superiore viene adottato invece che duplicato. Usa Sostituisci se vuoi che il modello venga costruito da zero.
  </Accordion>
</AccordionGroup>

## Correlati

<CardGroup cols={2}>
  <Card title="Server Backup" icon="server" href="/it/server-management/server-backup">
    Istantanee, ripristini, pianificazioni e la copia di sicurezza usata quando applichi un modello.
  </Card>

  <Card title="Comandi /backup" icon="terminal" href="/it/commands/backup">
    Importare un file di modello di Discord e tutti i sottocomandi di backup.
  </Card>

  <Card title="Controllo accessi" icon="user-lock" href="/it/server-management/dashboard-permissions">
    Concedere la sezione Backup a qualcuno che non sia il proprietario.
  </Card>

  <Card title="Permessi" icon="shield-halved" href="/it/permissions">
    Gerarchia dei ruoli e cosa serve a Vetox.
  </Card>
</CardGroup>