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

# Modelos de servidor

> Layouts de servidor prontos — canais, cargos e permissões — construídos no seu servidor em uma única ação, a partir do catálogo ou de um link de modelo do Discord.

Modelos de servidor são layouts de servidor prontos — canais, categorias, cargos e permissões, desenhados como um conjunto — que o Vetox constrói no seu servidor em uma única ação. Explore-os em [vetox.io/templates](https://vetox.io/templates) ou aplique um pelo Discord com [`/template`](#o-comando-template).

<Info>
  **Gratuito em todos os planos**, incluindo o Starter. Aplicar um modelo é, nos bastidores, uma restauração do [Backup do servidor](/pt/server-management/server-backup), então o mesmo backup de segurança é feito e o mesmo cartão de progresso aparece — só que sem nenhum bloqueio premium.
</Info>

<Note>
  **O catálogo é escrito em inglês.** O valor de um modelo está nos nomes exatos de canais e cargos que ele grava no seu servidor, e esses nomes entram literalmente. Traduzir a página em volta de nomes de canais não traduzidos prometeria um servidor no seu idioma e entregaria um em inglês, então o catálogo é deliberadamente só em inglês. Todas as outras páginas da documentação do Vetox, e o próprio painel, continuam no seu idioma.
</Note>

## O que um modelo contém

| Incluído                      | Observações                                                                                                                                        |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Categorias e canais**       | Todos os tipos — texto, voz, anúncios, palco, fórum — com tópicos, modo lento e as permissões específicas de cada um                               |
| **Cargos**                    | Nome, cor, exibição separada, possibilidade de menção e o conjunto de permissões que cada cargo deve carregar                                      |
| **Configurações do servidor** | Nível de verificação, filtro de conteúdo, padrão de notificações, tempo limite de AFK e qual canal é o de sistema, o de regras e o de atualizações |

<Warning>
  Um modelo é um **layout**. Ele nunca contém mensagens, membros, banimentos, emojis ou figurinhas, e nunca pode levar o conteúdo de outro servidor para o seu.
</Warning>

<Note>
  **Um modelo nunca renomeia o seu servidor.** Ele aplica o layout que projeta e deixa o nome e a descrição do seu servidor exatamente como estão — nos dois modos.
</Note>

## O catálogo

220 modelos em 22 categorias:

|                   |                   |                     |
| ----------------- | ----------------- | ------------------- |
| 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  |                   |                     |

Toda página de modelo mostra a árvore completa de canais e a lista de cargos antes de você aplicar qualquer coisa, além de para quem ele serve, como deve ser conduzido e quais erros ele foi desenhado para evitar. Pesquise, filtre por tamanho e idioma e ordene por popularidade a partir do catálogo.

## Aplicar um modelo pelo site

<Steps>
  <Step title="Abra o modelo e clique em Aplicar">
    Na página dele em [vetox.io/templates](https://vetox.io/templates). Se você não estiver conectado, o Vetox pede para entrar com o Discord primeiro e traz você de volta.
  </Step>

  <Step title="Escolha o servidor">
    Só aparecem os servidores que você pode configurar.
  </Step>

  <Step title="Escolha Mesclar ou Substituir">
    A janela abre na página de Backup do servidor do seu servidor, com o modelo já selecionado. Veja [os dois modos](#os-dois-modos).
  </Step>

  <Step title="Leia o plano">
    O Vetox lê o seu servidor ao vivo e informa exatamente quantos canais e cargos serão **criados**, **reaproveitados** e **excluídos** antes que qualquer coisa aconteça.
  </Step>

  <Step title="Confirme">
    Substituir pede que você digite o nome do servidor antes. O Vetox então faz um backup de segurança e constrói o modelo, com o progresso na própria página.
  </Step>
</Steps>

<Tip>
  Você chega à mesma janela sem passar pelo site: abra **Backup → Backup do servidor** no painel do seu servidor.
</Tip>

## Os dois modos

|                                  | Mesclar *(padrão)*                                                     | Substituir                   |
| -------------------------------- | ---------------------------------------------------------------------- | ---------------------------- |
| Canais e cargos que já existem   | **Reaproveitados** — as configurações do modelo são aplicadas aos seus | Excluídos antes              |
| Todo o resto do servidor         | Mantido                                                                | Excluído                     |
| Configurações do servidor        | Não são tocadas                                                        | Aplicadas a partir do modelo |
| Nome e descrição do seu servidor | Mantidos                                                               | Mantidos                     |
| Confirmação                      | Botão de confirmação                                                   | Digitar o nome do servidor   |
| Permissão de backup necessária   | Criação                                                                | Destrutiva                   |

<Tip>
  **Mesclar é o modo seguro, e é o padrão.** Ele acrescenta o que falta e adota o que já existe, então mesclar o mesmo modelo uma segunda vez não muda nada nem duplica nada.
</Tip>

Mesclar compara por **nome**, ignorando maiúsculas. Um cargo corresponde a um cargo existente não gerenciado com o mesmo nome. Um canal corresponde a outro com o mesmo nome, o mesmo tipo **e** a mesma categoria pai — por isso `#general` em **Text** e `#general` em **Voice Text** continuam sendo dois canais separados. Canais e cargos reaproveitados mantêm a posição que você deu a eles; só os novos são posicionados pelo modelo.

<Warning>
  **Substituir exclui todos os canais e cargos do servidor antes de construir.** Os membros nunca são expulsos, mas todo o resto vai embora, e um modelo não restaura mensagens. O backup de segurança feito antes é o que desfaz isso.
</Warning>

## O backup de segurança

Antes de um modelo ser aplicado, o Vetox faz um instantâneo do seu servidor como ele está agora — canais, cargos, configurações, emojis e figurinhas — e o guarda na aba Backups como um backup do tipo **Segurança**.

<Note>
  Se o backup de segurança falhar, **o modelo nunca é aplicado**. Nada é alterado. Os backups de segurança ficam guardados por 7 dias e não contam para o seu limite de backups. Restaurar um deles devolve o seu servidor ao estado anterior.
</Note>

## O comando `/template`

`/template` é a metade do catálogo que vive no Discord. Dois subcomandos, ambos visíveis só para você.

| Requisito              | Valor                                                           |
| ---------------------- | --------------------------------------------------------------- |
| **Você precisa de**    | Gerenciar Servidor **e**, para aplicar um modelo, Administrador |
| **O Vetox precisa de** | Ver Canal — e mais, para construir o layout                     |
| **Tempo de espera**    | 5s                                                              |
| **Onde**               | Somente em servidores. Indisponível em DMs                      |

<AccordionGroup>
  <Accordion title="/template load — construir o modelo neste servidor" icon="wand-magic-sparkles">
    | Opção      | Obrigatória | Observações                                                                   |
    | ---------- | ----------- | ----------------------------------------------------------------------------- |
    | `template` | **Sim**     | Um nome ou ID do catálogo, ou um link de modelo do Discord. Com autocompletar |
    | `mode`     | Não         | `merge` (padrão) ou `replace`                                                 |

    Nada é aplicado no primeiro toque. O Vetox responde com o plano atrás dos botões **Confirmar** e **Cancelar**, que expiram após **60 segundos**; só ao confirmar ele faz o backup de segurança e começa a construir.
  </Accordion>

  <Accordion title="/template info — o que um modelo contém" icon="circle-info">
    | Opção      | Obrigatória | Observações                                  |
    | ---------- | ----------- | -------------------------------------------- |
    | `template` | **Sim**     | Um nome ou ID do catálogo. Com autocompletar |

    A contagem de canais e cargos, para que ele serve e um link para a página dele. `/template info` cobre apenas o catálogo do Vetox — um link de modelo do Discord não tem página de catálogo para descrever, então use `/template load` nesse caso.
  </Accordion>
</AccordionGroup>

### O que você pode digitar em `template`

Um só campo, quatro coisas que ele aceita:

| Você digita                                | Exemplo                            |
| ------------------------------------------ | ---------------------------------- |
| O **nome** do modelo                       | `Starter Community Hub`            |
| O **ID** dele                              | `community/starter-community-hub`  |
| Só o **slug**                              | `starter-community-hub`            |
| Um link ou código de **modelo do Discord** | `https://discord.new/H5qAZdEEeWdR` |

<Note>
  Um nome que corresponde a dois modelos é recusado em vez de adivinhado — escolha um pelo autocompletar ou use o ID dele. O autocompletar oferece apenas modelos do catálogo; um link do Discord você digita.
</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
```

## Os modelos do próprio Discord

O Discord permite que o dono de um servidor publique o servidor como modelo em **Configurações do Servidor → Modelo do Servidor**, o que gera um link como `https://discord.new/H5qAZdEEeWdR`.

<Tip>
  **O Vetox aplica esses links a um servidor que você já tem** — cole um deles em `/template load` ou na janela **Importar** da página de Backup do servidor. O link do próprio Discord só cria um servidor **novo e vazio**; o Vetox é como você usa esse modelo no servidor que já mantém.
</Tip>

<Note>
  O caminho inverso não funciona: um modelo do catálogo do Vetox não tem link `discord.new`, porque o Discord só gera esses links a partir de um servidor real que ele consiga ler. Para compartilhar um layout que você montou, publique o seu próprio servidor como modelo do Discord e compartilhe esse link, ou exporte o servidor como arquivo de backup.
</Note>

## Permissões

Aplicar um modelo altera o seu servidor, então há duas travas.

| Trava                                        | Regra                                                                                                                                                                                              |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Discord**                                  | Você precisa de **Administrador** para aplicar um modelo por `/template load`. Pelo painel, vale o [Controle de acesso](/pt/server-management/dashboard-permissions) comum para a seção **Backup** |
| **Nível de permissão do Backup do servidor** | Mesclar conta como criação, Substituir conta como ação destrutiva. No nível padrão — *Administradores não podem realizar ações destrutivas* — Substituir é exclusivo do dono                       |

O nível fica na página de Backup do servidor, em **Configurações → Permissões**, e só o dono do servidor pode alterá-lo. Veja [Permissões](/pt/server-management/server-backup).

### O que o Vetox precisa

<Warning>
  Dê **Administrador** ao Vetox antes de aplicar um modelo e garanta que o cargo dele fique **acima** dos cargos que o modelo cria. O Discord não deixa um bot conceder uma permissão que ele mesmo não tem — quando isso acontece, o cargo é criado mesmo assim, sem essas permissões, e o Vetox avisa.
</Warning>

## Os limites de canais e cargos do Discord

<Warning>
  Um servidor comporta no máximo **250 cargos e 500 canais**, e o Discord deixa um bot criar no máximo 250 cargos ou 500 canais em um mesmo servidor **em 48 horas**. Um modelo grande em um servidor que já tem muitos dos dois pode esbarrar em qualquer um desses limites.
</Warning>

O Vetox verifica os limites do servidor antes de você confirmar e avisa se o modelo levaria o servidor além deles — exclua alguns primeiro ou aplique no modo Substituir, para que os antigos saiam. A cota de criação de 48 horas do Discord é separada e não é devolvida ao excluir nada; se um trabalho esbarrar nela, ele para e guarda o lugar, e `/backup status` mostra quando ela é liberada.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Esse modelo não existe">
    O nome, o ID ou o link não corresponderam a nada publicado. Escolha pelo autocompletar ou explore [vetox.io/templates](https://vetox.io/templates). Um link do Discord precisa ser um link de **modelo** (`discord.new/…` ou `discord.com/template/…`), não um convite.
  </Accordion>

  <Accordion title="Criar um backup pelo Discord exige a permissão Administrador">
    Aplicar um modelo faz primeiro um backup de segurança do servidor inteiro, então exige Administrador — só Gerenciar Servidor pode deixar canais escondidos de você que o instantâneo ainda incluiria.
  </Accordion>

  <Accordion title="Apenas quem as permissões de backup do servidor autorizam pode fazer isso">
    O nível de permissão do Backup do servidor deixa esta ação para o dono. Ou o dono aplica o modelo, ou o dono muda o nível em **Configurações → Permissões**.
  </Accordion>

  <Accordion title="Isso levaria o servidor além do limite do Discord">
    O modelo somado ao que você já tem passa de 250 cargos ou 500 canais. Exclua alguns, aplique no modo Substituir ou escolha um modelo menor.
  </Accordion>

  <Accordion title="Já existe outro trabalho de backup em andamento neste servidor">
    Um backup, restauração ou aplicação de modelo por vez, por servidor. Espere o trabalho em andamento terminar ou cancele-o pelo cartão de progresso dele.
  </Accordion>

  <Accordion title="Alguns cargos estão acima do Vetox na lista de cargos">
    Esses cargos foram informados e deixados intactos — o Discord não deixa um bot editar um cargo acima do dele. Mova o cargo do Vetox para cima e aplique de novo.
  </Accordion>

  <Accordion title="O modelo foi aplicado, mas um canal que eu já tinha foi reaproveitado em vez de recriado">
    É o Mesclar funcionando como foi projetado: um canal com o mesmo nome, tipo e categoria pai é adotado em vez de duplicado. Use Substituir se quiser o modelo construído do zero.
  </Accordion>
</AccordionGroup>

## Relacionados

<CardGroup cols={2}>
  <Card title="Backup do servidor" icon="server" href="/pt/server-management/server-backup">
    Instantâneos, restaurações, agendamentos e o backup de segurança que a aplicação de um modelo usa.
  </Card>

  <Card title="Comandos /backup" icon="terminal" href="/pt/commands/backup">
    Importar um arquivo de modelo do Discord e todos os subcomandos de backup.
  </Card>

  <Card title="Controle de acesso" icon="user-lock" href="/pt/server-management/dashboard-permissions">
    Conceda a seção Backup a alguém que não seja o dono.
  </Card>

  <Card title="Permissões" icon="shield-halved" href="/pt/permissions">
    Hierarquia de cargos e o que o Vetox precisa.
  </Card>
</CardGroup>