> ## 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="/uk/commands/server-moderation">
    Канали, очищення, розіграші та тикети.
  </Card>

  <Card title="Інструменти модерації" icon="wrench" href="/uk/moderation/moderation-tools">
    Еквіваленти в панелі.
  </Card>
</CardGroup>