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

# Команды модерации участников

> Баны, кики, муты, таймауты, предупреждения, штрафные очки и управление ролями — 24 команды для действий над участниками.

Двадцать три команды, действующие на участника. Каждая требует право Discord.

<Warning>
  **Роль Vetox должна быть выше самой высокой роли цели**, иначе Discord отказывает в действии независимо от прав. Это самая распространённая причина «команда ничего не сделала».
</Warning>

## Баны и кики

| Команда      | Вам нужно         | Vetox нужно  | Кулдаун |
| ------------ | ----------------- | ------------ | ------- |
| `/ban`       | Ban Members       | Ban Members  | 10 с    |
| `/unban`     | Ban Members       | Ban Members  | 5 с     |
| `/unban-all` | **Administrator** | Ban Members  | 20 с    |
| `/kick`      | Kick Members      | Kick Members | 10 с    |

<AccordionGroup>
  <Accordion title="Опции /ban" icon="hammer">
    | Опция             | Обязательно | Примечания                                               |
    | ----------------- | ----------- | -------------------------------------------------------- |
    | `user`            | **Да**      |                                                          |
    | `duration`        | Нет         | `7d`, `2h30m`, `permanent`. **По умолчанию — permanent** |
    | `reason`          | Нет         |                                                          |
    | `delete_messages` | Нет         | 0, 1, 3 или 7 дней истории сообщений                     |

    Указание длительности превращает бан во временный, снимаемый автоматически.
  </Accordion>

  <Accordion title="/unban" icon="unlock">
    `user` обязателен и принимает упоминание, выбор из списка или сырое ID — полезно, так как забаненного участника нельзя упомянуть обычным способом. `reason` необязателен.
  </Accordion>

  <Accordion title="/unban-all" icon="triangle-exclamation">
    Без опций. **Разбанивает всех забаненных пользователей сервера.** Только для Administrator, кулдаун 20 с, без подтверждения и без отмены.
  </Accordion>
</AccordionGroup>

## Таймауты и муты

Три разных механизма — не путайте их.

| Команда                        | Механизм                   | Вам нужно        | Vetox нужно      |
| ------------------------------ | -------------------------- | ---------------- | ---------------- |
| `/timeout`, `/untimeout`       | Встроенный таймаут Discord | Moderate Members | Moderate Members |
| `/mute-text`, `/unmute-text`   | **Роль** мута              | Moderate Members | **Manage Roles** |
| `/mute-voice`, `/unmute-voice` | Голосовой мут сервера      | Mute Members     | Mute Members     |

Все принимают `user` (обязательно), плюс необязательные `duration` и `reason`. Кулдауны 5–10 с.

<Note>
  **`/mute-text` применяет роль**, поэтому нужен Manage Roles и правильные переопределения этой роли в каналах. `/timeout` использует встроенный таймаут Discord и не требует роли вовсе.
</Note>

<AccordionGroup>
  <Accordion title="/mute-check — кто в муте" icon="magnifying-glass">
    Требуется **Manage Messages**. `user` необязателен — не указывайте, чтобы получить список всех замьюченных по тексту. Кулдаун 5 с.
  </Accordion>
</AccordionGroup>

## Голос

| Команда  | Вам нужно    | Vetox нужно  | Примечания                           |
| -------- | ------------ | ------------ | ------------------------------------ |
| `/vkick` | Move Members | Move Members | Отключает от голосового канала       |
| `/move`  | Move Members | Move Members | Перемещает между голосовыми каналами |

<Warning>
  **`/move` без `user` перемещает вас.** Все опции необязательные, и пропуск цели по умолчанию берёт того, кто выполняет команду. Всегда указывайте `user`.
</Warning>

`/move` принимает `user`, `to-user` (переместить в тот канал, где находится этот пользователь) и `to-channel`.

## Предупреждения и штрафные очки

| Команда         | Вам нужно       | Кулдаун |
| --------------- | --------------- | ------- |
| `/warn-add`     | Manage Messages | 5 с     |
| `/warn-remove`  | Manage Messages | 5 с     |
| `/warnings`     | Manage Messages | 5 с     |
| `/points`       | Manage Server   | 5 с     |
| `/points-reset` | Manage Server   | 5 с     |

<AccordionGroup>
  <Accordion title="/warn-add" icon="triangle-exclamation">
    `user` обязателен, `reason` необязателен.

    <Warning>
      **Причина ограничена 250 символами, но Discord позволяет ввести больше.** Более длинная причина принимается полем ввода, а затем отклоняется при отправке. Держите её в пределах 250.
    </Warning>
  </Accordion>

  <Accordion title="/warn-remove" icon="eraser">
    `user` обязателен. `warning-code` необязателен — **если не указан, удаляет все предупреждения** этого участника.
  </Accordion>

  <Accordion title="/warnings" icon="list">
    `user` необязателен — не указывайте, чтобы получить список всех участников с предупреждениями. С разбивкой на страницы и элементами удаления.
  </Accordion>

  <Accordion title="/points и /points-reset" icon="hashtag">
    `/points` принимает `user` и `amount`, где amount поддерживает `+5`, `-5` или `5`. `/points-reset` принимает необязательный `user` — **если не указан, сбрасывает всем**.
  </Accordion>
</AccordionGroup>

## Роли

| Команда          | Вам нужно         | Vetox нужно      | Кулдаун |
| ---------------- | ----------------- | ---------------- | ------- |
| `/role`          | Manage Roles      | Manage Roles     | 3 с     |
| `/temprole`      | Manage Roles      | Manage Roles     | 5 с     |
| `/rar`           | Manage Roles      | Manage Roles     | 10 с    |
| `/role-multiple` | **Administrator** | Manage Roles     | 30 с    |
| `/setnick`       | Manage Nicknames  | Manage Nicknames | 5 с     |
| `/inrole`        | Manage Server     | —                | 10 с    |

<AccordionGroup>
  <Accordion title="/role — переключить роль" icon="user-tag">
    `member` и `role` обязательны. Добавляет роль, если её нет, снимает, если есть.
  </Accordion>

  <Accordion title="/temprole — роль на время" icon="clock">
    `member`, `role` и `duration` обязательны. Роль снимается автоматически по истечении.
  </Accordion>

  <Accordion title="/rar — снять все роли" icon="user-minus">
    `user` обязателен. Снимает все роли, которые Vetox способен снять.
  </Accordion>

  <Accordion title="/role-multiple — массовое изменение ролей" icon="users">
    Только для Administrator, кулдаун 30 с.

    | Опция           | Обязательно | Примечания                                                                 |
    | --------------- | ----------- | -------------------------------------------------------------------------- |
    | `type`          | **Да**      | `give` или `remove`                                                        |
    | `role`          | **Да**      |                                                                            |
    | `pick_type`     | **Да**      | `all`, `bots`, `humans` или `role`                                         |
    | `required_role` | Нет         | **Используется только при `pick_type` = `role`** — иначе тихо игнорируется |

    <Warning>
      Это затрагивает всех подходящих участников сразу и не может быть массово отменено.
    </Warning>
  </Accordion>

  <Accordion title="/setnick" icon="pen">
    `user` обязателен, `nickname` необязателен — не указывайте, чтобы сбросить. **Vetox никогда не может переименовать владельца сервера**; это ограничение Discord.
  </Accordion>

  <Accordion title="/inrole" icon="list">
    `role` обязателен. Перечисляет всех, у кого она есть.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Vetox говорит, что не может воздействовать на этого участника">
    Иерархия ролей — переместите роль Vetox выше их роли. К владельцам сервера действия применить нельзя.
  </Accordion>

  <Accordion title="/mute-text ничего видимого не делает">
    Она применяет роль. Если у этой роли нет переопределений в каналах, запрещающих Send Messages, участник фактически не замьючен.
  </Accordion>

  <Accordion title="Я запустил /move и переместил себя">
    `user` не был указан, что по умолчанию берёт вас.
  </Accordion>

  <Accordion title="Моя причина предупреждения была отклонена">
    Больше 250 символов. Поле ввода не мешает вводить больше.
  </Accordion>

  <Accordion title="/warn-remove удалил все предупреждения">
    `warning-code` не был указан, что очищает их все.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Модерация сервера" icon="shield-halved" href="/ru/commands/server-moderation">
    Каналы, очистка, розыгрыши и тикеты.
  </Card>

  <Card title="Инструменты модерации" icon="wrench" href="/ru/moderation/moderation-tools">
    Аналоги в панели управления.
  </Card>
</CardGroup>