> ## 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 문제의 대다수를 해결하는 체크리스트.

순서대로 진행하세요. 처음 세 가지가 대부분의 신고를 해결합니다.

## 첫 세 가지 체크

<Steps>
  <Step title="모듈이 켜져 있나요?">
    대부분의 기능은 **기본적으로 꺼져 있습니다**. 기능 자체 페이지를 구성해도 [서버 설정](/ko/server-management/setup)에서 스위치를 켜기 전까지는 아무 일도 일어나지 않습니다.

    이것이 "설정했는데 아무 일도 안 일어나요"의 가장 흔한 원인입니다.
  </Step>

  <Step title="Vetox 역할이 충분히 높나요?">
    역할이나 멤버가 관련된 모든 것에 대해 **Vetox 역할은 대상의 최상위 역할보다 위에 있어야 합니다**. 서버 설정 → 역할에서 위로 드래그하세요.

    Discord는 권한과 무관하게 이러한 작업을 거부하며, Vetox의 여러 부분은 이럴 때 **조용히** 실패합니다 — 특히 티켓은 오류를 전혀 표시하지 않습니다.
  </Step>

  <Step title="Vetox에 채널 권한이 있나요?">
    서버 전체 역할이 아니라, 특정 채널에서 봇의 *유효* 권한을 확인하세요. **Embed Links**가 가장 자주 누락됩니다.
  </Step>
</Steps>

## 증상별

<AccordionGroup>
  <Accordion title="자동 모더레이션이 아무것도 필터링하지 않아요" icon="filter">
    1. 8개 규칙 모두 **비활성화** 상태로 제공됩니다 — 원하는 것을 켜세요
    2. **관리자는 절대 필터링되지 않습니다.** 일반 계정으로 테스트하세요
    3. 메시지당 첫 번째로 일치하는 규칙만 발동합니다
    4. 규칙 자체의 비활성 채널과 역할을 확인하세요
    5. 자동화된 조치가 하나라도 존재하면 규칙 수준의 타임아웃은 어디서나 억제됩니다
  </Accordion>

  <Accordion title="알림이 오지 않아요" icon="bell">
    1. **서버 설정**의 플랫폼 토글 — 기본으로 꺼져 있으며 알림 페이지에는 상태가 표시되지 않습니다
    2. 활성 **Basic** 이상 프리미엄
    3. 대상 채널의 **Embed Links**
    4. Twitch 및 Kick에서, 이미 라이브인 스트리머를 추가해도 다음 스트림 전까지는 공지하지 않습니다
    5. 프리미엄이 만료된 동안 게시된 것은 본 것으로 표시되며 재생되지 않습니다
  </Accordion>

  <Accordion title="역할이 할당되지 않아요" icon="user-tag">
    1. 역할은 Vetox 역할 **아래**에 있어야 합니다
    2. Vetox에 **Manage Roles** 권한이 필요합니다
    3. Vetox는 Administrator, Manage Server 또는 Manage Roles를 가진 역할을 보상으로 부여하는 것을 거부합니다 — 이는 재정의할 수 없습니다
    4. 역할이 선택되지 않은 보상 역할 행은 저장 시 조용히 제거됩니다
  </Accordion>

  <Accordion title="스태프가 티켓에서 보거나 행동할 수 없어요" icon="ticket">
    거의 항상 **역할 계층** 문제입니다. Vetox 역할을 모든 지원 역할보다 위로 이동하세요.

    티켓 권한 실패는 오류도, 로그 항목도, 스태프가 조치할 수 없다는 것 외에는 눈에 띄는 증상도 만들지 않습니다.
  </Accordion>

  <Accordion title="임베드 필드가 계속 사라져요" icon="rectangle-list">
    제목이나 값이 빈 값으로 해석되었고, 빈 필드는 제거됩니다. 거의 항상 오탈자 변수이거나 해당 기능에서 존재하지 않는 변수입니다 — [변수](/ko/help/variables) 확인.
  </Accordion>

  <Accordion title="설정이 저장됐는데 적용되지 않아요" icon="floppy-disk">
    구성은 일반적으로 몇 초 안에 봇에 도달합니다. 알림이 누락되면 봇은 캐시가 만료될 때까지 이전 값을 유지합니다 — **최대 약 10분**.

    10분 기다린 후 다시 저장하세요.
  </Accordion>

  <Accordion title="멤버가 XP를 얻지 못해요" icon="chart-line">
    1. 서버 설정에서 레벨링이 켜져 있는지
    2. 채널이 제외되지 않았고, 멤버가 제외된 역할을 가지고 있지 않은지
    3. **Starter**에서는 텍스트/음성/반응 켜기·끄기 스위치가 적용되지 않습니다 — 봇은 상관없이 표준 속도를 사용합니다
  </Accordion>

  <Accordion title="환영 메시지가 게시되지 않아요" icon="hand-wave">
    1. 서버 설정에서 Welcomer 켜짐, 채널 설정, 메시지 스위치 켜짐
    2. 이미지용 **Attach Files**
    3. `[Server]`가 그대로 보이면 `[ServerName]`으로 변경
    4. 임베드가 계속 되돌아가면 저장 시 메시지 유형이 **Embed**로 설정되어야 합니다
  </Accordion>

  <Accordion title="지원서를 제출할 수 없어요" icon="clipboard-list">
    5개보다 많은 질문이 있는 다이얼로그 폼에서 뒤쪽 질문이 필수인 경우, **절대** 제출할 수 없습니다 — Discord는 필드 5개만 보여주지만 6번째도 여전히 검증됩니다.

    개인 메시지 플로우로 전환하거나 6번째 이후 질문을 선택으로 만드세요.
  </Accordion>

  <Accordion title="명령어가 나타나지 않아요" icon="terminal">
    1. 모든 명령어는 **서버 전용** — DM에서는 작동하지 않습니다
    2. [명령어](/ko/server-management/command-management) 페이지에서 비활성화되었거나 제한되었을 수 있습니다
    3. Discord 클라이언트를 재시작하여 명령어 목록을 새로고침하세요
  </Accordion>

  <Accordion title="AI 기능이 작동을 멈췄어요" icon="sparkles">
    [AI 사용량](/ko/moderation/ai-usage)에서 토큰 잔액을 확인하세요.

    자동 모더레이션은 3,000 토큰 아래에서 중단되고, 서버 제어는 30,000 아래에서 거절합니다. 자동 모더레이션은 fail-closed입니다 — 예산을 확인할 수 없으면 스캔하지 않습니다.
  </Accordion>

  <Accordion title="AI 서버 제어가 완전히 저를 무시해요" icon="wand-magic-sparkles">
    침묵은 모든 접근 실패에 대한 정상 응답입니다. 순서대로:

    1. 봇을 **직접** 멘션하세요 — 역할 핑이나 답장 핑은 트리거가 아닙니다
    2. 서버 설정에서 AI 서버 제어 켜짐
    3. 채널이 범위 안에 있음
    4. 관리자이거나, \_Allowlist bypasses Administrator\_가 켜진 상태로 허용 목록에 있음 — 허용 목록 자체만으로는 아무것도 하지 않습니다
    5. 속도 제한에 걸리지 않음
  </Accordion>

  <Accordion title="구매가 적용되지 않았어요" icon="credit-card">
    보통 1초 안에 적용됩니다. 15분 정도 기다린 후 지원팀에 문의하세요 — **다시 구매하지 마세요**.
  </Accordion>

  <Accordion title="다운그레이드 후 데이터가 사라졌어요" icon="triangle-exclamation">
    9개 카테고리는 비활성화가 아닌 영구 삭제입니다 — 가장 중요한 것은 **새 한도를 초과하는 지원서 질문**입니다. [기능 제한](/ko/premium/feature-limits) 참고.
  </Accordion>

  <Accordion title="예약된 일이 잘못된 시간에 발생해요" icon="clock">
    서버 설정에서 **서버 시간대**를 확인하세요 — 연속 출석, 리셋, 예약 조치를 결정합니다.

    리마인더는 예외입니다: 생성된 브라우저의 시간대를 캡처하며 이를 조절할 컨트롤이 없습니다.
  </Accordion>
</AccordionGroup>

## 고장난 것처럼 보이지만 아닌 것들

<Note>
  | 동작                                   | 이유                          |
  | ------------------------------------ | --------------------------- |
  | 관리자가 자동 모더레이션을 우회                    | 설계에 의해서이며 인터페이스에는 표시되지 않음   |
  | 메시지당 자동 모더레이션 규칙이 하나만 발동             | 설계에 의해 — 첫 번째 일치가 승리        |
  | 스트림 중간에 추가된 스트리머가 아무 것도 만들지 않음       | 라이브 추적은 전환 시점에 발동됨          |
  | Vito 랭크가 잔액보다 늦음                     | 리더보드는 12시간마다 재계산됩니다         |
  | 발동 후에도 일회성 리마인더가 목록에 남음              | 완료 표시된 채로 기록으로 보존됨          |
  | 첫 로드 시 서버 설정 카드 일곱 개가 "Enabled"로 깜빡임 | 표시상의 문제; Disabled 상태가 사실입니다 |
  | 사용자 없이 `/move`가 본인을 이동               | 옵션이 호출자로 기본값이 됨             |
</Note>

## 여전히 막혔다면

<CardGroup cols={2}>
  <Card title="지원 서버" icon="discord" href="https://discord.gg/vetox">
    Vetox Discord에서 문의하세요.
  </Card>

  <Card title="도움이 필요해요" icon="life-ring" href="/ko/server-management/support-sessions">
    담당자가 사용자의 대시보드를 실시간으로 보게 하세요.
  </Card>
</CardGroup>