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

# 서버 모더레이션 명령어

> 채널 제어, 메시지 정리, 이모지, 경품, 스타보드, 티켓 명령어.

멤버가 아닌 서버를 대상으로 작동하는 16개 명령어.

## 채널

| 명령어         | 필요한 권한          | Vetox 권한        | 쿨다운 |
| ----------- | --------------- | --------------- | --- |
| `/lock`     | Manage Channels | Manage Channels | 2초  |
| `/unlock`   | Manage Channels | Manage Channels | 2초  |
| `/hide`     | Manage Channels | Manage Channels | 2초  |
| `/show`     | Manage Channels | Manage Channels | 2초  |
| `/slowmode` | Manage Channels | Manage Channels | 2초  |

<AccordionGroup>
  <Accordion title="/lock 및 /unlock" icon="lock">
    `@everyone`에 대한 **Send Messages**를 거부하거나 복원합니다. `channel`은 선택이며 기본은 현재 채널. 텍스트 및 공지 채널에서 작동합니다.
  </Accordion>

  <Accordion title="/hide 및 /show" icon="eye-slash">
    `@everyone`에 대한 **View Channel**을 거부하거나 복원합니다. 텍스트, 공지, 음성, 포럼, 스테이지 채널에서 작동합니다.
  </Accordion>

  <Accordion title="/slowmode" icon="hourglass">
    `duration`은 **필수** — `5s`, `2m`, `1h` 또는 `off`로 해제. `channel`과 `reason`은 선택.
  </Accordion>
</AccordionGroup>

<Tip>
  `/lock`은 말하는 것을 막지만 읽기는 가능합니다. `/hide`는 채널을 전혀 보이지 않게 합니다. 레이드 중이라면 먼저 잠그세요 — 숨기면 오히려 혼란을 초래합니다.
</Tip>

## 정리

<AccordionGroup>
  <Accordion title="/clear — 대량 삭제" icon="broom">
    양쪽 모두 **Manage Messages** 권한이 필요합니다. 쿨다운 10초.

    | 옵션      | 필수  | 비고            |
    | ------- | --- | ------------- |
    | `count` | 아니요 | 1에서 500       |
    | `user`  | 아니요 | 이 멤버의 메시지만 삭제 |

    <Warning>
      Discord는 **14일**을 넘은 메시지의 대량 삭제를 허용하지 않습니다. 더 오래된 메시지는 건너뜁니다.
    </Warning>
  </Accordion>
</AccordionGroup>

## 이모지

<AccordionGroup>
  <Accordion title="/add-emoji — 대량 업로드" icon="face-smile">
    양쪽 모두 **Manage Expressions** 권한이 필요합니다. 쿨다운 30초.

    두 옵션 — `emojis`와 `message_id` — 은 모두 선택이지만, **둘 중 하나는 반드시 제공해야 합니다**. 이모지 목록을 전달하거나 이모지가 포함된 메시지의 ID를 전달하세요.

    <Note>
      업로드는 서버의 이모지 슬롯에 의해 제한되며, 이는 Discord 부스트 레벨에 따라 다릅니다.
    </Note>
  </Accordion>
</AccordionGroup>

## 경품

다섯 개 모두 **Manage Server** 권한이 필요하며, Vetox에는 **Send Messages**와 **Embed Links**가 필요합니다. 쿨다운 5초.

<AccordionGroup>
  <Accordion title="/gstart — 경품 시작" icon="gift">
    | 옵션                | 필수    | 비고                               |
    | ----------------- | ----- | -------------------------------- |
    | `prize`           | **예** | 최대 256자                          |
    | `duration`        | **예** |                                  |
    | `channel`         | 아니요   | 기본은 현재 채널                        |
    | `winners`         | 아니요   | 1–20                             |
    | `description`     | 아니요   | 최대 1,024자                        |
    | `required-role`   | 아니요   |                                  |
    | `min-account-age` | 아니요   | 1–365일                           |
    | `min-level`       | 아니요   | 1–200                            |
    | `excluded-role`   | 아니요   |                                  |
    | `bypass-role`     | 아니요   | 모든 요구 사항을 건너뜀                    |
    | `ping-role`       | 아니요   | **여기에서만 설정 가능 — 대시보드에는 컨트롤이 없음** |
    | `start-time`      | 아니요   | 시작을 지연                           |
  </Accordion>

  <Accordion title="/gdrop — 드롭 경품" icon="bolt">
    가장 먼저 클릭한 사람이 승리합니다. `prize`와 `winners` (1–20)는 **필수**이며, `channel`, `description`, `required-role`, `min-account-age`, `min-level`은 선택입니다.
  </Accordion>

  <Accordion title="/gend, /greroll, /glist" icon="flag-checkered">
    `/gend`는 필수 `giveaway-id`를 받습니다. `/greroll`은 필수 `message-id`와 선택 `count` (1–20)를 받습니다. `/glist`는 옵션이 없습니다.
  </Accordion>
</AccordionGroup>

<Note>
  `ping-role`은 명령어 옵션으로만 존재하는 유일한 경품 설정입니다. 역할을 핑해야 한다면 대시보드가 아닌 `/gstart`로 경품을 시작하세요. [경품](/ko/engagement/giveaways) 참고.
</Note>

## 스타보드

<AccordionGroup>
  <Accordion title="/starboard — 항목 관리" icon="star">
    **Manage Messages** 권한이 필요합니다. 쿨다운 3초. 여섯 개의 서브커맨드가 있으며, 모두 필수 `message` 링크와 선택 `starboard` 이름을 받습니다:

    | 서브커맨드      | 효과                |
    | ---------- | ----------------- |
    | `force`    | 별 개수와 상관없이 메시지 추가 |
    | `unforce`  | 강제 추가 되돌리기        |
    | `freeze`   | 별 개수 업데이트 중단      |
    | `unfreeze` | 업데이트 재개           |
    | `trash`    | 제거하고 재등록 차단       |
    | `untrash`  | 삭제된 항목 복원         |

    <Note>
      `starboard` 옵션은 자동완성되지 **않습니다** — 구성된 이름과 정확히 일치하도록 입력하세요.
    </Note>

    <Tip>
      `untrash`는 여기에는 존재하지만 대시보드 리더보드에서는 접근할 수 없습니다. 이 명령어가 삭제된 항목을 복원할 수 있는 유일한 방법입니다.
    </Tip>
  </Accordion>

  <Accordion title="⭐ Send to Starboard — 컨텍스트 메뉴" icon="star">
    메시지 우클릭 → Apps → **Send to Starboard**. `/starboard`와 동일한 권한이 필요합니다.

    <Note>
      컨텍스트 메뉴 항목이므로 대시보드의 명령어 페이지에 나타나지 않으며 서버별 설정을 거기서 변경할 수 없습니다.
    </Note>
  </Accordion>
</AccordionGroup>

<Note>
  둘 다 [서버 설정](/ko/server-management/setup)의 **스타보드** 모듈이 필요합니다.
</Note>

## 티켓

<AccordionGroup>
  <Accordion title="/ticket — 14개의 서브커맨드" icon="ticket">
    Vetox에 **Manage Channels**와 **Manage Messages** 권한이 필요합니다. 쿨다운 3초.

    | 서브커맨드           | 옵션                                           | 효과            |
    | --------------- | -------------------------------------------- | ------------- |
    | `close`         | `reason` 선택                                  | 티켓 닫기         |
    | `claim`         | —                                            | 티켓 담당         |
    | `unclaim`       | —                                            | 담당 해제         |
    | `reopen`        | —                                            | 닫힌 티켓 재개      |
    | `add`           | `user` 필수                                    | 누군가를 추가       |
    | `remove`        | `user` 필수                                    | 누군가를 제거       |
    | `rename`        | `name` 필수, 최대 100자                           | 채널 이름 변경      |
    | `priority`      | `level` 필수 — none, low, medium, high, urgent | 우선순위 설정       |
    | `transfer`      | `category` 필수                                | 다른 카테고리로 이동   |
    | `closerequest`  | —                                            | 생성자에게 닫기 요청   |
    | `escalate`      | `target` 필수 (자동완성), `reason` 선택              | 다른 패널로 에스컬레이션 |
    | `note`          | `content` 필수                                 | 내부 노트 추가      |
    | `merge`         | `target` 필수                                  | 다른 티켓으로 병합    |
    | `notifications` | —                                            | 본인의 티켓 알림 설정  |

    `notifications`를 제외한 모든 것은 티켓 채널 안에서 실행해야 합니다.
  </Accordion>
</AccordionGroup>

<Warning>
  **`/ticket`은 자체적으로 Discord 권한을 요구하지 않습니다.** 접근은 티켓 패널의 지원 역할에 의해 결정됩니다.

  `close`, `claim`, `add`, `remove`, `reopen`만 버튼별 권한 규칙의 대상입니다. 나머지 아홉 개 — `rename`, `transfer`, `merge`, `note` 포함 — 는 티켓에서 활동할 수 있는 사람 누구나 실행할 수 있습니다. 티켓 접근 권한을 부여할 때 이 점을 유념하세요.
</Warning>

<Warning>
  **서버 설정에서 Tickets를 꺼도 `/ticket`은 비활성화되지 않습니다.** 기존 티켓 채널에서 계속 작동합니다.
</Warning>

<Note>
  대시보드에는 봇이 등록하지 않는 `tag` 서브커맨드가 나열됩니다. 실행할 수 없습니다.
</Note>

## 문제 해결

<AccordionGroup>
  <Accordion title="/clear가 모두 삭제하지 않았어요">
    Discord가 14일 이상 된 메시지의 대량 삭제를 차단합니다.
  </Accordion>

  <Accordion title="/lock으로 사람들이 여전히 말할 수 있어요">
    Send Messages를 명시적으로 허용하는 역할이 `@everyone`의 거부를 오버라이드합니다. 해당 채널의 역할 오버라이트를 확인하세요.
  </Accordion>

  <Accordion title="/starboard가 스타보드를 찾을 수 없다고 해요">
    이름은 정확히 일치해야 하며 자동완성되지 않습니다.
  </Accordion>

  <Accordion title="티켓 서브커맨드가 티켓 안에서 실행해야 한다고 해요">
    `notifications`를 제외한 모든 것은 활성 티켓 채널이 필요합니다.
  </Accordion>

  <Accordion title="/add-emoji가 실패했어요">
    보통 사용 가능한 이모지 슬롯이 없거나 Vetox에 Manage Expressions 권한이 없습니다.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="멤버 모더레이션" icon="gavel" href="/ko/commands/moderation">
    멤버를 대상으로 조치.
  </Card>

  <Card title="티켓" icon="ticket" href="/ko/utility/tickets/overview">
    티켓 시스템 작동 방식.
  </Card>
</CardGroup>