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

## 六个标签页

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

## 两种类型

|      | 标准    | Drop   |
| ---- | ----- | ------ |
| 结束条件 | 计时器归零 | 达到参与目标 |
| 获奖者  | 随机抽取  | 最先参与者  |

<Warning>
  **一个 Drop 若从未填满，无论你设定的参与目标是多少，都会在 24 小时后过期**。请将目标设为你服务器一天内实际能达到的规模。
</Warning>

## 创建

<Steps>
  <Step title="通用">
    奖品和频道。
  </Step>

  <Step title="配置">
    标准抽奖的获奖人数（1–20）和时长，或 Drop 的最大参与数（最多 10,000）。可选延迟开始若干小时。
  </Step>

  <Step title="消息">
    模板或自定义嵌入，以及成员通过 **按钮** 还是 **反应** 参与。
  </Step>

  <Step title="要求">
    谁可以参与。
  </Step>

  <Step title="奖品">
    可选地授予获奖者角色或 XP。
  </Step>
</Steps>

时长接受 `m`、`h`、`d`、`w` 和 `mo`。纯数字表示小时。范围是 **1 分钟到 30 天**。

<Note>
  若你选择反应参与，你必须挑选一个表情，否则创建会被拒绝。
</Note>

## 要求

| 要求     | 上限                 |
| ------ | ------------------ |
| 所需角色   | 10                 |
| 被封角色   | 10                 |
| 绕过角色   | 5                  |
| 最低账户年龄 | 1–365 天            |
| 最低等级   | 1–200              |
| 加成条目规则 | 10，每条授予 1–10 个额外条目 |

绕过角色跳过其他所有要求。

<Note>
  最低等级使用你的 [升级系统](/zh-CN/engagement/leveling) 数据。在关闭升级系统的服务器上，没有人能满足它。
</Note>

<Warning>
  未选择角色的加成条目规则在提交时会被悄悄丢弃。请在保存后检查规则是否保留了其角色。
</Warning>

<Tip>
  最低账户年龄 7 天是最有效的反小号措施。它对真实成员毫无代价，能阻止一次性账户参与一百次。
</Tip>

## 奖品

除了你宣布的奖品外，获奖者还可以获得角色（最多 10 个）和 XP（最多 100,000，文字或语音）。

获奖者自动收到私信。关闭私信的成员会被跳过，但不会让抽奖失败。

## 获奖者如何抽取

* **标准，带加成条目** ——加权随机，因此额外条目确实提高几率
* **标准，不带** ——密码学随机洗牌
* **Drop** ——按顺序取最先参与者

黑名单成员在抽取的那一刻过滤，而不仅仅在参与时。

## 管理运行中的抽奖

打开抽奖以获取 **重新举办**、**重掷获奖者**、**结束抽奖** 和 **删除抽奖**。

<Note>
  重掷从相同条目中抽取新获奖者。原始获奖者保留已获得的任何角色或 XP。
</Note>

## 黑名单

最多 500 位成员，可选原因。添加、移除和全部清除立即生效。

## 模板

最多 10 个可重用设计，每个都有活跃嵌入、结束嵌入和参与按钮样式。其中一个可标记为活跃并成为新抽奖的默认。

模板变量：`{prize}`、`{winners}`、`{host}`、`{endsAt}`、`{id}`、`{description}`、`{requiredRole}`、`{minAccountAge}`、`{entryCount}`。

## 设置

两个服务器范围的默认值：默认最低账户年龄，以及是否私信通知获奖者。

<Note>
  这是唯一使用保存栏的标签页。其他所有内容——创建、结束、重掷、加入黑名单、模板——都立即应用。
</Note>

## 上限

|         |      |
| ------- | ---- |
| 活跃抽奖    | 100  |
| 每次抽奖获奖者 | 20   |
| 时长      | 30 天 |
| 模板      | 10   |
| 黑名单     | 500  |

## 提及角色

<Note>
  抽奖详情页上显示的提及角色只能通过 `/gstart` 命令设置——创建表单中没有它的控件。
</Note>

## 故障排查

<AccordionGroup>
  <Accordion title="成员无法参与">
    请检查要求——账户年龄和等级挡住的人比预期多。Vetox 还需要能看到并在该频道发帖，若选择反应参与还需能添加反应。
  </Accordion>

  <Accordion title="抽奖已结束但未宣布获奖者">
    没有合格的参与者，或到抽取时每位参与者都已被列入黑名单。解决后请重掷。
  </Accordion>

  <Accordion title="Drop 提前结束但无人获胜">
    若未达到参与目标，Drop 在 24 小时后过期。请降低目标。
  </Accordion>

  <Accordion title="获奖者没有获得角色">
    该角色必须位于 Vetox **之下**，Vetox 需要 **管理角色** 权限。
  </Accordion>

  <Accordion title="我无法创建另一次抽奖">
    你已达到 100 个活跃。请结束或删除一些。
  </Accordion>
</AccordionGroup>

<Card title="战斗通行证" icon="trophy" horizontal href="/zh-CN/engagement/battle-pass">
  持续的奖励而非一次性的奖品。
</Card>