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

# 명령어 관리

> Vetox 명령어를 역할별, 채널별로 활성화, 비활성화, 제한하고 조정 사유 프리셋을 설정합니다.

**Commands** 페이지는 모든 Vetox 명령어를 나열하며 각각을 개별적으로 제어할 수 있게 해줍니다.

## 목록

5개 탭, 각각 실시간 카운트 표시: **All**, **General**, **Moderation**, **Info**, **Leveling**. 각 카드에는 명령어 이름, 설명, 카테고리, 켜기/끄기 스위치, **Manage** 링크가 있습니다.

검색창은 모든 탭에 걸쳐 필터링됩니다.

<Note>
  목록에서 명령어를 토글하면 **저장할 때까지 로컬로 유지**됩니다. 원래 상태로 다시 토글하면 변경이 완전히 지워집니다 — 저장 바가 스스로 사라집니다.
</Note>

## 명령어별 설정

아무 명령어의 **Manage**를 여세요.

| 설정                    | 기본값 | 효과                               |
| --------------------- | --- | -------------------------------- |
| **Enabled**           | 켜짐  | 명령어를 완전히 끄기                      |
| **Command Aliases**   | 없음  | 명령어의 대체 이름                       |
| **Enabled Roles**     | 없음  | Discord 권한이 없어도 사용할 수 있는 역할      |
| **Disabled Roles**    | 없음  | 사용이 차단되는 역할                      |
| **Enabled Channels**  | 없음  | 특정 채널로 제한                        |
| **Disabled Channels** | 없음  | 특정 채널에서 차단                       |
| **명령어 호출 자동 삭제**      | 꺼짐  | 멤버의 명령어 메시지 제거                   |
| **메시지 삭제 시 자동 삭제**    | 꺼짐  | 멤버가 자신의 메시지를 삭제할 때 Vetox의 답변도 제거 |
| **봇 답변을 5초 후 자동 삭제**  | 꺼짐  | 응답을 자동으로 정리                      |

<Note>
  **유용한 것은 Enabled Roles입니다.** 기본 Discord 권한이 없는 역할에 접근을 부여합니다 — 서버 전체에 Manage Messages 권한을 주지 않고 Trial Moderator 역할이 `/warn-add`를 사용할 수 있게 합니다.
</Note>

## 하위 명령어

하위 명령어가 있는 명령어 — `/ticket`과 `/starboard` — 는 개별 하위 명령어 수준에서 구성할 수 있습니다. 예를 들어 모든 지원 스태프에게 `/ticket close`를 허용하면서 `/ticket merge`는 시니어로 제한할 수 있습니다.

<Warning>
  **하위 명령어는 더 적은 옵션을 지원합니다.** Aliases, 호출 자동 삭제, 메시지 삭제 시 자동 삭제는 모두 사용할 수 없으며 그렇게 표시된 안내와 함께 비활성화되어 나타납니다.

  하위 명령어는 다음을 설정할 수 있습니다: enabled, 역할 제한, 채널 제한, 답변 자동 삭제. 나머지는 모두 부모 명령어에서 구성됩니다.
</Warning>

<Note>
  [대시보드 워처](/ko/server-management/dashboard-watcher)는 하위 명령어 변경을 **부모** 명령어 이름 아래에 기록합니다. `/ticket`에 대한 감사 항목이 실제로는 그 하위 명령어의 변경일 수 있습니다.
</Note>

## 사유 프리셋

다섯 조정 명령어가 사유 프리셋을 지원합니다: **`/ban`**, **`/mute-text`**, **`/mute-voice`**, **`/warn-add`**, **`/timeout`**.

조정자가 이 중 하나를 사유 입력 **없이** 실행하면 Vetox는 필드를 비워두는 대신 정의된 사유 메뉴를 표시합니다.

이 중 네 개 — `/ban`, `/mute-text`, `/mute-voice`, `/timeout` — 는 각 프리셋에 **기간**을 함께 실을 수도 있어서 "스팸 — 24시간"을 선택하면 둘 다 한 번에 적용됩니다.

<Tip>
  사유 프리셋은 조정 로그를 훨씬 유용하게 만듭니다. 자유 입력 사유는 조정자마다 달라 나중에 검색하기 어렵지만, 고정 목록은 일관성을 유지하며 필터링을 가능하게 합니다.
</Tip>

<Note>
  사유 목록은 재정렬을 지원하지 않으며 — 새 항목은 뒤에 추가됩니다. 중간 항목을 삭제하면 아래 행이 다시 렌더링되므로 저장 전에 재확인하세요.
</Note>

## 일반 패턴

<AccordionGroup>
  <Accordion title="재미있는 명령어를 진지한 채널에서 제외">
    `/roll`, `/translate` 등의 **Disabled Channels**에 공지와 지원 채널을 추가하세요.
  </Accordion>

  <Accordion title="트라이얼 조정자에게 제한된 권한 부여">
    Trial Moderator 역할을 `/warn-add`와 `/timeout`에만 **Enabled Roles**에 추가하세요. Discord 권한 없이 해당 명령어만 얻습니다.
  </Accordion>

  <Accordion title="봇 스팸을 한 채널로 제한">
    `/rank`, `/top`, `/profile`의 **Enabled Channels**를 하나의 봇 채널로 설정하세요.
  </Accordion>

  <Accordion title="명령어를 완전히 끄기">
    **Enabled**를 끄세요. 관리자를 포함한 모두에게 작동을 중지합니다.
  </Accordion>
</AccordionGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="변경 사항이 적용되지 않았어요">
    목록 페이지는 저장 바를 사용하기 전까지 토글을 로컬로 유지합니다. 저장했는지 확인하세요.
  </Accordion>

  <Accordion title="조정자가 여전히 명령어를 사용할 수 없어요">
    Enabled Roles는 명령어를 부여하지만, Vetox는 여전히 조치를 수행하기 위해 자체 Discord 권한이 필요하며 역할 계층도 여전히 적용됩니다. [권한](/ko/permissions)을 참고하세요.
  </Accordion>

  <Accordion title="하위 명령어에 별칭이 없어요">
    정상 — 별칭은 부모 명령어에서만 구성됩니다.
  </Accordion>

  <Accordion title="사유 프리셋이 제공되지 않아요">
    5개 명령어만 지원합니다. 조정자는 또한 사유를 입력하지 않고 명령어를 실행해야 합니다.
  </Accordion>
</AccordionGroup>

## 관련

<CardGroup cols={2}>
  <Card title="명령어 참조" icon="list" href="/ko/commands/overview">
    각 명령어, 옵션, 필요한 권한.
  </Card>

  <Card title="권한" icon="user-lock" href="/ko/permissions">
    Vetox가 누가 명령어를 실행할 수 있는지 결정하는 방법.
  </Card>
</CardGroup>