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

# Шаблоны серверов

> Готовые структуры сервера — каналы, роли и права, — которые Vetox выстраивает на вашем сервере за одно действие: из каталога или по ссылке на шаблон Discord.

Шаблоны серверов — это готовые структуры сервера: каналы, категории, роли и права, продуманные как единый набор, — которые Vetox выстраивает на вашем сервере за одно действие. Смотрите их на [vetox.io/templates](https://vetox.io/templates) или примените шаблон прямо из Discord командой [`/template`](#команда-template).

<Info>
  **Бесплатно на любом тарифе**, включая Starter. Под капотом применение шаблона — это восстановление [резервной копии сервера](/ru/server-management/server-backup): создаётся такая же страховочная копия и показывается такая же карточка прогресса, только премиум-ограничения на него не распространяются.
</Info>

<Note>
  **Каталог написан на английском.** Ценность шаблона — в точных названиях каналов и ролей, которые он создаёт на вашем сервере, а они переносятся дословно. Перевод страницы вокруг непереведённых названий каналов обещал бы сервер на вашем языке, а давал бы английский, поэтому каталог намеренно остаётся только на английском. Все остальные страницы документации Vetox и сама панель управления остаются на вашем языке.
</Note>

## Что содержит шаблон

| Входит                 | Примечания                                                                                                                                               |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Категории и каналы** | Все типы — текстовые, голосовые, каналы объявлений, трибуны, форумы — вместе с темами, медленным режимом и переопределениями прав                        |
| **Роли**               | Название, цвет, отдельный показ в списке участников, возможность упоминания и набор прав, который должна нести каждая роль                               |
| **Настройки сервера**  | Уровень проверки, фильтр контента, уведомления по умолчанию, тайм-аут AFK, а также какие каналы назначены системным, каналом правил и каналом обновлений |

<Warning>
  Шаблон — это **структура**. Он никогда не содержит сообщений, участников, банов, эмодзи или стикеров и не может перенести содержимое чужого сервера на ваш.
</Warning>

<Note>
  **Шаблон никогда не переименовывает сервер.** Он выстраивает задуманную структуру и оставляет название и описание вашего сервера ровно такими, какие они есть, — в обоих режимах.
</Note>

## Каталог

220 шаблонов в 22 категориях:

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

На странице каждого шаблона видно полное дерево каналов и список ролей ещё до того, как вы что-то примените, а также для кого он, как его вести и от каких ошибок он защищает. В каталоге есть поиск, фильтры по размеру и языку и сортировка по популярности.

## Применение шаблона с сайта

<Steps>
  <Step title="Откройте шаблон и нажмите «Применить»">
    На его странице на [vetox.io/templates](https://vetox.io/templates). Если вы не вошли в аккаунт, Vetox сначала попросит войти через Discord и вернёт вас обратно.
  </Step>

  <Step title="Выберите сервер">
    Предлагаются только серверы, которые вы можете настраивать.
  </Step>

  <Step title="Выберите режим: объединение или замена">
    Диалог откроется на странице «Резервная копия сервера» вашего сервера с уже выбранным шаблоном. См. [два режима](#два-режима).
  </Step>

  <Step title="Прочитайте план">
    Vetox считывает текущее состояние сервера и ещё до начала работы показывает, сколько именно каналов и ролей будет **создано**, **использовано повторно** и **удалено**.
  </Step>

  <Step title="Подтвердите">
    Для замены сначала потребуется ввести название сервера. После этого Vetox создаёт страховочную копию и выстраивает шаблон, показывая прогресс на странице.
  </Step>
</Steps>

<Tip>
  Тот же диалог доступен и без сайта: откройте **Резервные копии → Резервная копия сервера** в панели управления вашего сервера.
</Tip>

## Два режима

|                                        | Объединение *(по умолчанию)*                                    | Замена                 |
| -------------------------------------- | --------------------------------------------------------------- | ---------------------- |
| Каналы и роли, которые уже есть        | **Используются повторно** — к ним применяются настройки шаблона | Сначала удаляются      |
| Всё остальное на сервере               | Сохраняется                                                     | Удаляется              |
| Настройки сервера                      | Не затрагиваются                                                | Применяются из шаблона |
| Название и описание вашего сервера     | Сохраняются                                                     | Сохраняются            |
| Подтверждение                          | Кнопка подтверждения                                            | Ввод названия сервера  |
| Нужный уровень прав на резервные копии | Создание                                                        | Разрушающее действие   |

<Tip>
  **Объединение — безопасный режим, и он выбран по умолчанию.** Он добавляет недостающее и принимает то, что уже есть, поэтому повторное объединение с тем же шаблоном ничего не меняет и ничего не дублирует.
</Tip>

Объединение сопоставляет по **названию**, без учёта регистра. Роль совпадает с существующей ролью с тем же названием, если та не управляется интеграцией. Канал совпадает с каналом, у которого совпадают название, тип **и** родительская категория, — поэтому `#general` в категории **Text** и `#general` в категории **Voice Text** останутся двумя разными каналами. У повторно используемых каналов и ролей сохраняется заданная вами позиция; шаблон расставляет только новые.

<Warning>
  **Замена удаляет все каналы и роли на сервере, прежде чем начать сборку.** Участников при этом никогда не исключают, но всё остальное исчезает, а сообщения шаблон не восстанавливает. Отменить это можно только страховочной копией, созданной перед началом.
</Warning>

## Страховочная копия

Перед применением шаблона Vetox делает снимок сервера в его нынешнем виде — каналы, роли, настройки, эмодзи и стикеры — и сохраняет его как копию типа **Страховочная** на вкладке «Резервные копии».

<Note>
  Если страховочную копию создать не удалось, **шаблон не применяется**. Ничего не меняется. Страховочные копии хранятся 7 дней и не расходуют ваш лимит резервных копий. Восстановление такой копии возвращает сервер в прежний вид.
</Note>

## Команда `/template`

`/template` — это половина каталога, которая живёт в Discord. Две подкоманды, ответы обеих видны только вам.

| Требование      | Значение                                                          |
| --------------- | ----------------------------------------------------------------- |
| **Вам нужно**   | Управление сервером, **а чтобы применить шаблон** — Администратор |
| **Vetox нужно** | Просмотр каналов — и больше прав, чтобы выстроить структуру       |
| **Задержка**    | 5 сек.                                                            |
| **Где**         | Только на серверах. В личных сообщениях недоступна                |

<AccordionGroup>
  <Accordion title="/template load — выстроить шаблон на этом сервере" icon="wand-magic-sparkles">
    | Параметр   | Обязательный | Примечания                                                                             |
    | ---------- | ------------ | -------------------------------------------------------------------------------------- |
    | `template` | **Да**       | Название или ID шаблона из каталога либо ссылка на шаблон Discord. Есть автодополнение |
    | `mode`     | Нет          | `merge` (по умолчанию) или `replace`                                                   |

    При первом вызове ничего не применяется. Vetox отвечает планом с кнопками **Подтвердить** и **Отмена**, которые перестают действовать через **60 секунд**; страховочная копия создаётся и сборка начинается только после подтверждения.
  </Accordion>

  <Accordion title="/template info — что содержит шаблон" icon="circle-info">
    | Параметр   | Обязательный | Примечания                                               |
    | ---------- | ------------ | -------------------------------------------------------- |
    | `template` | **Да**       | Название или ID шаблона из каталога. Есть автодополнение |

    Количество каналов и ролей, для чего он нужен, и ссылка на его страницу. `/template info` работает только с каталогом Vetox: у ссылки на шаблон Discord нет страницы в каталоге, которую можно было бы описать, поэтому для неё используйте `/template load`.
  </Accordion>
</AccordionGroup>

### Что можно ввести в `template`

Одно поле, четыре варианта ввода:

| Что вы вводите                     | Пример                             |
| ---------------------------------- | ---------------------------------- |
| **Название** шаблона               | `Starter Community Hub`            |
| Его **ID**                         | `community/starter-community-hub`  |
| Только **слаг**                    | `starter-community-hub`            |
| Ссылку или код **шаблона Discord** | `https://discord.new/H5qAZdEEeWdR` |

<Note>
  Если под название подходят два шаблона, Vetox не станет угадывать и откажет — выберите нужный из автодополнения или укажите его ID. Автодополнение предлагает только шаблоны каталога; ссылку Discord нужно ввести вручную.
</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
```

## Собственные шаблоны Discord

Discord позволяет владельцу сервера опубликовать свой сервер как шаблон в разделе **Настройки сервера → Шаблон сервера**; получается ссылка вида `https://discord.new/H5qAZdEEeWdR`.

<Tip>
  **Vetox применяет такие ссылки к серверу, который у вас уже есть**: вставьте ссылку в `/template load` или в диалог **Импорт** на странице «Резервная копия сервера». Сама ссылка Discord всегда создаёт **совершенно новый, пустой** сервер; Vetox — это способ применить её на сервере, который вы уже ведёте.
</Tip>

<Note>
  В обратную сторону это не работает: у шаблона из каталога Vetox нет ссылки `discord.new`, потому что Discord выдаёт их только для реального сервера, который может прочитать. Чтобы поделиться собранной вами структурой, опубликуйте свой сервер как шаблон Discord и отправьте эту ссылку — или выгрузите сервер в файл резервной копии.
</Note>

## Права

Применение шаблона меняет ваш сервер, поэтому оно закрыто двумя проверками.

| Проверка                                    | Правило                                                                                                                                                                                                                  |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Discord**                                 | Чтобы применить шаблон через `/template load`, нужны права **Администратора**. Из панели управления действует обычное [управление доступом](/ru/server-management/dashboard-permissions) для раздела **Резервные копии** |
| **Уровень прав на резервные копии сервера** | Объединение считается созданием, замена — разрушающим действием. При уровне по умолчанию — *администраторы не могут выполнять разрушающие действия* — замена доступна только владельцу                                   |

Уровень задаётся на странице «Резервная копия сервера» в разделе **Настройки → Права**, и менять его может только владелец сервера. См. [Права](/ru/server-management/server-backup).

### Что нужно Vetox

<Warning>
  Выдайте Vetox права **Администратора** до применения шаблона и убедитесь, что его роль стоит **выше** ролей, которые создаёт шаблон. Discord не позволяет боту выдать право, которого нет у него самого: в таком случае роль всё равно создаётся, но без этих прав, и Vetox об этом сообщает.
</Warning>

## Ограничения Discord на каналы и роли

<Warning>
  На сервере может быть не больше **250 ролей и 500 каналов**, а бот может создать не больше 250 ролей или 500 каналов на одном сервере **за 48 часов**. Большой шаблон на сервере, где уже много и того и другого, может упереться в любой из этих пределов.
</Warning>

Vetox проверяет лимиты сервера до подтверждения и предупреждает, если шаблон выведет сервер за них: удалите лишнее или примените шаблон в режиме замены, чтобы старое ушло. 48-часовой лимит Discord на создание — отдельный, и удалением его не вернуть; если сборка упрётся в него, задача останавливается, сохраняя своё место, а `/backup status` покажет, когда лимит снимется.

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Такого шаблона не существует">
    Название, ID или ссылка не совпали ни с чем опубликованным. Выберите вариант из автодополнения или загляните на [vetox.io/templates](https://vetox.io/templates). Ссылка Discord должна вести на **шаблон** (`discord.new/…` или `discord.com/template/…`), а не быть приглашением.
  </Accordion>

  <Accordion title="Для создания резервной копии из Discord нужны права администратора">
    Перед применением шаблона создаётся страховочная копия всего сервера, поэтому нужны права администратора: с одним лишь правом «Управление сервером» на сервере могут остаться скрытые от вас каналы, которые всё равно попадут в снимок.
  </Accordion>

  <Accordion title="Это доступно только тем, кому разрешают права сервера на резервные копии">
    Уровень прав на резервные копии сервера оставляет это действие владельцу. Либо шаблон применяет владелец, либо он меняет уровень в разделе **Настройки → Права**.
  </Accordion>

  <Accordion title="Это выведет сервер за лимит Discord">
    Шаблон вместе с тем, что у вас уже есть, превышает 250 ролей или 500 каналов. Удалите лишнее, примените шаблон в режиме замены или выберите шаблон поменьше.
  </Accordion>

  <Accordion title="На этом сервере уже выполняется другая задача резервного копирования">
    Одновременно на сервере выполняется только одна задача: копирование, восстановление или применение шаблона. Дождитесь текущей задачи или отмените её в карточке прогресса.
  </Accordion>

  <Accordion title="Некоторые роли стоят выше Vetox в списке ролей">
    Такие роли перечислены в отчёте и остались нетронутыми: Discord не позволяет боту изменять роль выше собственной. Поднимите роль Vetox выше и примените шаблон ещё раз.
  </Accordion>

  <Accordion title="Шаблон применился, но уже имевшийся канал был использован повторно, а не создан заново">
    Так и задумано в режиме объединения: канал с тем же названием, типом и родительской категорией перенимается, а не дублируется. Если нужно собрать шаблон с нуля, используйте замену.
  </Accordion>
</AccordionGroup>

## См. также

<CardGroup cols={2}>
  <Card title="Резервная копия сервера" icon="server" href="/ru/server-management/server-backup">
    Снимки, восстановления, расписания и страховочная копия, которую использует применение шаблона.
  </Card>

  <Card title="Команды /backup" icon="terminal" href="/ru/commands/backup">
    Импорт файла шаблона Discord и все подкоманды резервного копирования.
  </Card>

  <Card title="Управление доступом" icon="user-lock" href="/ru/server-management/dashboard-permissions">
    Откройте доступ к разделу «Резервные копии» кому-то, кроме владельца.
  </Card>

  <Card title="Права" icon="shield-halved" href="/ru/permissions">
    Иерархия ролей и то, что нужно Vetox.
  </Card>
</CardGroup>
