> ## 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개의 명령어.

멤버를 대상으로 작동하는 23개 명령어. 모두 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`. **기본은 영구** |
    | `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>
  **`user` 없이 `/move`를 실행하면 본인이 이동합니다.** 모든 옵션이 선택이며, 대상 생략 시 명령어를 실행한 본인으로 기본값이 설정됩니다. 항상 `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="/ko/commands/server-moderation">
    채널, 정리, 경품 및 티켓.
  </Card>

  <Card title="모더레이션 도구" icon="wrench" href="/ko/moderation/moderation-tools">
    대시보드에서의 동등 기능.
  </Card>
</CardGroup>