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

# 경품 이벤트

> 참가 조건, 보너스 응모, 우승자 역할, XP 보상을 포함한 일반 및 드롭 경품 이벤트를 진행합니다. 모든 등급에서 무료.

<Info>
  **모든 등급에서 무료입니다.** 경품 이벤트에는 프리미엄 제한이 없으며 아래 한도는 모두에게 동일하게 적용됩니다.
</Info>

## 6개의 탭

<CardGroup cols={3}>
  <Card title="개요" icon="chart-line">
    참여 통계와 최근 당첨자.
  </Card>

  <Card title="모든 경품 이벤트" icon="list">
    모든 이벤트, 상태별 필터링 가능.
  </Card>

  <Card title="블랙리스트" icon="ban">
    참여가 금지된 멤버들.
  </Card>

  <Card title="로그" icon="scroll">
    경품 이벤트 이벤트가 기록되는 곳.
  </Card>

  <Card title="템플릿" icon="palette">
    재사용 가능한 임베드 디자인.
  </Card>

  <Card title="설정" icon="sliders">
    서버 전체 기본값.
  </Card>
</CardGroup>

## 두 가지 유형

|       | 일반     | 드롭        |
| ----- | ------ | --------- |
| 종료 조건 | 타이머 만료 | 응모 목표 도달  |
| 당첨자   | 무작위 추첨 | 먼저 응모한 사람 |

<Warning>
  **응모가 채워지지 않은 드롭은 설정한 응모 목표와 상관없이 24시간 뒤 만료됩니다.** 서버가 하루 안에 현실적으로 도달할 수 있는 수치로 목표를 설정하세요.
</Warning>

## 만들기

<Steps>
  <Step title="일반">
    상품과 채널.
  </Step>

  <Step title="설정">
    일반 경품 이벤트의 경우 당첨자 수(1\~20)와 기간, 드롭의 경우 최대 응모 수(최대 10,000). 선택적으로 시작을 몇 시간 지연할 수 있습니다.
  </Step>

  <Step title="메시지">
    템플릿 또는 커스텀 임베드, 그리고 멤버가 **버튼** 또는 **반응**으로 참여할지 여부.
  </Step>

  <Step title="조건">
    참여 자격.
  </Step>

  <Step title="상품">
    당첨자에게 선택적으로 역할이나 XP를 지급합니다.
  </Step>
</Steps>

기간은 `m`, `h`, `d`, `w`, `mo`를 허용합니다. 숫자만 입력하면 시간(hours)으로 해석됩니다. 범위는 **1분부터 30일까지**입니다.

<Note>
  반응 응모를 선택한 경우 이모지를 지정해야 하며, 그렇지 않으면 생성이 거부됩니다.
</Note>

## 조건

| 조건        | 한도                     |
| --------- | ---------------------- |
| 필수 역할     | 10                     |
| 차단 역할     | 10                     |
| 우회 역할     | 5                      |
| 최소 계정 나이  | 1\~365일                |
| 최소 레벨     | 1\~200                 |
| 보너스 응모 규칙 | 10개, 각 1\~10개 추가 응모 부여 |

우회 역할은 다른 모든 조건을 건너뜁니다.

<Note>
  최소 레벨은 [레벨링](/ko/engagement/leveling) 데이터를 사용합니다. 레벨링이 꺼진 서버에서는 아무도 조건을 충족하지 못합니다.
</Note>

<Warning>
  역할이 선택되지 않은 보너스 응모 규칙은 제출 시 조용히 제거됩니다. 저장 후 규칙에 역할이 유지되었는지 확인하세요.
</Warning>

<Tip>
  최소 계정 나이 7일은 가장 효과적인 부계정 방지 조치입니다. 진짜 멤버에게는 아무런 비용이 없고, 일회용 계정이 100번 응모하는 것을 막습니다.
</Tip>

## 상품

발표하는 상품 외에도 당첨자에게 역할(최대 10개)과 XP(최대 100,000, 텍스트 또는 음성)를 지급할 수 있습니다.

당첨자는 자동으로 DM을 받습니다. DM이 닫혀 있는 멤버는 이벤트를 실패시키지 않고 건너뜁니다.

## 당첨자 추첨 방식

* **보너스 응모가 있는 일반** — 가중 무작위 추첨으로, 추가 응모가 실제로 확률을 높입니다
* **보너스 응모가 없는 일반** — 암호학적 무작위 셔플
* **드롭** — 응모 순서대로 먼저 참여한 사람

블랙리스트에 오른 멤버는 응모 시점이 아니라 추첨 순간에도 걸러집니다.

## 진행 중인 이벤트 관리

이벤트를 열어 **Re-Host**, **Reroll Winners**, **End Giveaway**, **Delete Giveaway**를 사용할 수 있습니다.

<Note>
  Reroll은 같은 응모자 중에서 새로운 당첨자를 뽑습니다. 원래 당첨자에게 이미 지급된 역할이나 XP는 유지됩니다.
</Note>

## 블랙리스트

선택적 사유와 함께 최대 500명. 추가, 제거, 전체 삭제는 즉시 적용됩니다.

## 템플릿

최대 10개의 재사용 디자인이 있으며, 각각 활성 임베드, 종료 임베드, 응모 버튼 스타일을 갖춥니다. 하나를 활성으로 지정하면 새 이벤트의 기본값이 됩니다.

템플릿 변수: `{prize}`, `{winners}`, `{host}`, `{endsAt}`, `{id}`, `{description}`, `{requiredRole}`, `{minAccountAge}`, `{entryCount}`.

## 설정

서버 전체 기본값 두 가지: 기본 최소 계정 나이, 당첨자 DM 여부.

<Note>
  저장 바를 사용하는 유일한 탭입니다. 생성, 종료, 재추첨, 블랙리스트, 템플릿 등 다른 모든 작업은 즉시 적용됩니다.
</Note>

## 한도

|          |     |
| -------- | --- |
| 활성 이벤트   | 100 |
| 이벤트당 당첨자 | 20  |
| 기간       | 30일 |
| 템플릿      | 10  |
| 블랙리스트    | 500 |

## 핑 역할

<Note>
  이벤트 상세 페이지에 표시되는 핑 역할은 `/gstart` 명령어로만 설정할 수 있습니다 — 생성 폼에는 해당 컨트롤이 없습니다.
</Note>

## 문제 해결

<AccordionGroup>
  <Accordion title="멤버가 응모할 수 없어요">
    조건을 확인하세요 — 계정 나이와 레벨이 예상보다 많은 사람을 걸러냅니다. 또한 Vetox가 채널을 보고 게시할 수 있어야 하며, 반응 응모를 선택했다면 반응을 추가할 수 있어야 합니다.
  </Accordion>

  <Accordion title="이벤트가 종료됐는데 당첨자가 발표되지 않아요">
    자격 있는 응모자가 없었거나, 추첨 시점에 모든 응모자가 블랙리스트에 있었을 수 있습니다. 문제 해결 후 재추첨하세요.
  </Accordion>

  <Accordion title="드롭이 아무도 당첨되지 않고 조기 종료됐어요">
    드롭은 응모 목표에 도달하지 못하면 24시간 뒤 만료됩니다. 목표를 낮추세요.
  </Accordion>

  <Accordion title="당첨자가 역할을 받지 못했어요">
    역할은 Vetox **아래**에 있어야 하며 Vetox에 **Manage Roles** 권한이 필요합니다.
  </Accordion>

  <Accordion title="이벤트를 하나 더 만들 수 없어요">
    활성 100개 한도에 도달했습니다. 일부를 종료하거나 삭제하세요.
  </Accordion>
</AccordionGroup>

<Card title="배틀 패스" icon="trophy" horizontal href="/ko/engagement/battle-pass">
  일회성 상품 대신 지속적인 보상.
</Card>