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

# 배틀 패스

> 티어, 퀘스트, 보상, 캐치업, 커뮤니티 목표를 갖춘 시즌 진행 시스템. Basic 등급.

<Info>
  **Basic**이 필요합니다. Starter에서는 페이지가 기능 미리보기로 대체됩니다 — [일일 연속 기록](/ko/engagement/streaks)은 무료로 유지되며 완전히 구성할 수 있습니다.
</Info>

멤버는 퀘스트를 완료하고, 퀘스트는 티어를 채우며, 티어는 보상을 지급합니다. 시즌이 끝나면 새 시즌이 시작됩니다.

<Note>
  배틀 패스는 [서버 설정](/ko/server-management/setup)에서 활성화해야 합니다. 이 페이지는 모듈이 꺼져 있어도 경고를 표시하지 않으므로 — 실행되지 않는 시즌을 통째로 구성할 수도 있습니다.
</Note>

## 시작하기

**Quick Start**는 한 번의 클릭으로 작동하는 시즌을 만듭니다: 기능을 활성화하고, 합리적인 기본값으로 초안 시즌을 생성하며, 스타터 퀘스트 세 개(메시지 20개 보내기, 음성 채널 30분 이용, 반응 25개 추가)와 샘플 티어 보상을 추가합니다.

<Tip>
  전체를 커스터마이징할 계획이더라도 Quick Start를 사용하세요. 작동하는 시즌을 살펴보는 것이 빈 페이지에서 조립하는 것보다 훨씬 빠릅니다.
</Tip>

## 시즌

<Info>
  시즌 수: Basic에서 **1개**, Max에서 **3개**, Black에서 무제한입니다.
</Info>

시즌은 세 가지 상태를 거칩니다:

<Steps>
  <Step title="초안">
    완전히 편집 가능합니다. 여기서 퀘스트와 보상을 만듭니다.
  </Step>

  <Step title="활성">
    **잠금됨.** 멤버들이 진행 중이므로 아무것도 변경할 수 없습니다.
  </Step>

  <Step title="종료됨">
    보관 상태입니다.
  </Step>
</Steps>

<Warning>
  **활성 시즌은 편집할 수 없습니다.** 진행 중인 시즌을 변경하려면 새 초안으로 **복제**한 뒤 편집하고, 이전 시즌을 종료한 다음 새 시즌을 활성화하세요.

  활성화하려면 최소 하나의 티어 보상도 필요합니다.
</Warning>

동시에 활성화될 수 있는 시즌은 하나뿐입니다.

## 퀘스트

메시지, 음성, 반응 등 11가지 퀘스트 유형이 있습니다. 각 퀘스트에는 목표, XP 보상 그리고 선택적 제한(메시지당 최소 단어 수, 특정 채널, 대상 역할, 이용 가능 기간)이 있습니다.

<Warning>
  **Quests 탭은 프리셋 라이브러리만 표시하며, 이미 생성한 퀘스트는 나열하지 않습니다.** 시즌 페이지에서 편집하거나 삭제할 방법도 제공하지 않습니다.

  각 프리셋 카드의 활성화 스위치도 시각적 요소일 뿐 저장되지 않으며, 옆의 진행 바는 항상 0%로 표시됩니다.

  Quick Start로 퀘스트를 구성하고, 그 결과로 만들어진 세트를 해당 시즌 동안 그대로 유지하세요.
</Warning>

## 보상 티어

최대 **50개** 티어. 각 티어는 완료해야 할 퀘스트 수를 의미하며, 텍스트 XP, 음성 XP, 역할을 잠금 해제합니다.

<Note>
  대시보드의 일부 마케팅 문구에 100 티어라고 언급되어 있지만, 실제 최대치는 50개입니다.
</Note>

### 상위 랭크 역할

역시 Rewards 탭에 있습니다: 현재 1위 멤버에게 자동으로 역할을 부여하고, 누군가에게 추월당하면 회수합니다. 30분마다 동기화됩니다.

<Warning>
  Vetox는 Administrator, Manage Server, Manage Roles 권한을 가진 역할을 보상으로 지급하는 것을 거부합니다.
</Warning>

## 설정

**Appearance** — 커스텀 기본/보조 브랜드 색상.

**Notifications** — 티어 해제, 시즌 시작, 시즌 종료 각각에 대한 별도 채널과 두 가지 DM 옵션(완료 임박 알림, 미수령 보상 리마인더).

<Warning>
  Rewards 탭과 Settings 탭에는 각각 별도의 저장 바가 있습니다. **저장하지 않은 변경 사항이 있는 상태에서 탭을 전환하면 변경 사항이 조용히 폐기됩니다.** 전환 전에 저장하세요.
</Warning>

## 어뷰징 방지

카운트되기 전에 진행이 검증됩니다: 멤버별 쿨다운, 채널 다양성 검사, 음소거 해제 및 실제 활동 상태를 요구하는 음성 참여, 서버의 no-XP 역할, 중복 메시지 감지 등이 있습니다.

<Note>
  이러한 보호 조치는 자동으로 실행되며 대시보드에서 구성할 수 없습니다.
</Note>

## 시즌 롤오버

매일 UTC 00:00에 자동으로 처리됩니다. 주간 퀘스트 상한은 월요일에 초기화되며, 스트릭 프리즈는 매월 1일에 지급됩니다.

## 문제 해결

<AccordionGroup>
  <Accordion title="멤버가 진행되지 않아요">
    서버 설정에서 배틀 패스가 켜져 있는지 확인하세요 — 이 페이지는 알려주지 않습니다. 그런 다음 퀘스트의 채널 및 역할 제한과, 어뷰징 방지 규칙(너무 짧은 메시지, 한 채널만 사용, 음성에서 음소거 상태 등)이 정상 활동을 걸러내고 있지 않은지 확인하세요.
  </Accordion>

  <Accordion title="시즌을 편집할 수 없어요">
    활성 상태이기 때문입니다. 복제하고, 복제본을 편집하고, 원본을 종료한 뒤 복제본을 활성화하세요.
  </Accordion>

  <Accordion title="활성화가 거부돼요">
    시즌에는 최소 하나의 보상 티어와 미래의 종료 날짜가 필요합니다.
  </Accordion>

  <Accordion title="만든 퀘스트를 찾을 수 없어요">
    Quests 탭은 프리셋 라이브러리만 표시합니다. 해당 화면에는 생성된 퀘스트 목록이 없습니다.
  </Accordion>

  <Accordion title="설정 변경 사항이 사라졌어요">
    저장 전에 탭을 전환했기 때문입니다. Rewards와 Settings 탭은 저장 바를 공유하지 않습니다.
  </Accordion>

  <Accordion title="티어 보상이 지급되지 않아요">
    역할이 Vetox 아래에 있어야 하며, Administrator, Manage Server, Manage Roles 권한을 가질 수 없습니다.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="일일 연속 기록" icon="flame" href="/ko/engagement/streaks">
    모든 등급에서 무료이며, 별도 페이지에서 구성합니다.
  </Card>

  <Card title="레벨링" icon="chart-line" href="/ko/engagement/leveling">
    배틀 패스 보상이 반영되는 XP.
  </Card>
</CardGroup>