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

# Самоприсваиваемые роли

> Разрешите участникам выдавать себе роли через панели с реакциями, выпадающими списками или кнопками — с пятью режимами присвоения. Бесплатно на любом тарифе.

Участники выбирают себе роли — местоимения, настройки уведомлений, игровые интересы — с панели, которую вы конструируете.

<Info>
  **Бесплатно на любом тарифе**, без ограничений.
</Info>

## Сначала нужен эмбед-сообщение

<Warning>
  Self-Roles цепляется к существующему [Embed Message](/ru/utility/embed-messages), который **уже отправлен в канал**. Он не создаёт собственное сообщение.

  Если эмбедов нет, страница создания сообщит об этом и даст ссылку собрать его. Если эмбеды есть, но ни один не **отправлен**, селектор сообщения будет пустым, даже несмотря на существующие эмбеды — сначала отправьте один.
</Warning>

## Типы панелей

<CardGroup cols={3}>
  <Card title="Emoji" icon="face-smile">
    Участники ставят реакцию. До **20** ролей.
  </Card>

  <Card title="Button" icon="square">
    Кликабельные кнопки в четырёх цветах. До **25** ролей.
  </Card>

  <Card title="Dropdown" icon="list">
    Выпадающий список с плейсхолдером. До **25** ролей.
  </Card>
</CardGroup>

## Поведение

Для эмодзи- и кнопочных панелей вы выбираете основное поведение:

| Режим         | Эффект                                         |
| ------------- | ---------------------------------------------- |
| **Toggle**    | Выбор выдаёт роль, повторный — снимает         |
| **Give Only** | Только добавляет — участник не может снять сам |
| **Take Only** | Только снимает                                 |

Затем — опционально — один из двух режимов эксклюзивности:

| Режим             | Эффект                                                               |
| ----------------- | -------------------------------------------------------------------- |
| **Auto-Replace**  | Взятие роли снимает все прочие роли с этой панели                    |
| **Strict Single** | Отклоняет выбор, если у участника уже есть другая роль с этой панели |

<Warning>
  **Auto-Replace и Strict Single заменяют ваш основной выбор, а не добавляются к нему.** Выбор любого из них отбрасывает настройку Toggle / Give Only / Take Only.

  При повторном открытии панели в будущем в поле основного поведения будет отображаться **Toggle**, независимо от того, что вы выбрали изначально. Это артефакт отображения — реально хранится и применяется режим эксклюзивности.
</Warning>

<Note>
  У панелей-дропдаунов нет селектора поведения. Они всегда работают как toggle и всегда одиночный выбор.
</Note>

<Tip>
  **Auto-Replace** подходит для взаимоисключающих выборов вроде региона или уровня навыка — участник может передумать и всегда остаётся с ровно одним.
</Tip>

## Уведомления

Участникам можно писать DM при получении или потере роли, с отдельными сообщениями для каждого. Используйте `[Role]` для подстановки имени роли.

## Что показывает таблица списка

<Warning>
  Три колонки в списке панелей ненадёжны:

  * **Behavior** всегда показывает «Standard» вне зависимости от выбранного режима
  * **Created** всегда показывает сегодняшнюю дату для любой панели
  * **Type** показывает непереведённое английское слово

  Доверять можно только колонкам **Name** и **Reactions**. Откройте панель, чтобы увидеть её реальные настройки.
</Warning>

## Настройки, недоступные через панель

Два хранящихся параметра не имеют элементов управления в панели и остаются со значениями по умолчанию:

* **Лимит участников на роль** — базовый лимит на количество носителей каждой роли всегда без ограничений
* **Мультивыбор в dropdown** — dropdown-панели всегда одиночный выбор

<Note>
  Имя панели берётся из эмбед-сообщения, к которому она привязана. Переименование эмбеда переименует панель при следующем сохранении.
</Note>

## Изменение панели

<Warning>
  Смена типа панели пересобирает её Discord-сообщение — старые реакции или кнопки убираются перед появлением новых. Участники ненадолго видят панель без элементов управления.

  Если исходное Discord-сообщение было удалено, обновление молча падает, а панель остаётся в списке. Удалите её и пересоберите на новом сообщении.
</Warning>

<Warning>
  Каждая роль на панели должна быть **ниже** роли Vetox, иначе её нельзя присвоить. См. [Разрешения](/ru/permissions).
</Warning>

<Card title="Auto-Roles" icon="user-plus" horizontal href="/ru/engagement/auto-roles">
  Роли, выдаваемые автоматически, а не выбираемые.
</Card>