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

> 用 XP、等级和角色奖励活跃度——独立的文字与语音轨道、倍率、排除和升级消息。

成员因活跃而获得 XP。XP 转为等级，等级解锁角色。

## 四个标签页

<CardGroup cols={2}>
  <Card title="主要设置" icon="sliders">
    XP 速率、排除、倍率、重置。
  </Card>

  <Card title="XP 活动" icon="bolt">
    临时的服务器范围加成。参见 [XP 活动](/zh-CN/engagement/xp-events)。
  </Card>

  <Card title="升级消息" icon="message-square">
    有人升级时宣布什么。
  </Card>

  <Card title="奖励角色" icon="award">
    在某个等级授予的角色。
  </Card>
</CardGroup>

## 三种 XP 来源

| 来源     | 获得方式     | 默认    |
| ------ | -------- | ----- |
| **文字** | 发送消息，带冷却 | 开     |
| **语音** | 在语音频道的时间 | 开     |
| **反应** | 添加反应     | **关** |

每种都有每次授予的最小和最大 XP——实际数值是该范围内的随机值——加上各自的冷却时间。

<Info>
  调整 XP 速率需要 **Basic**。在 Starter 上字段可见但灰化。
</Info>

<Warning>
  **在 Starter 上，文字、语音和反应 XP 的开关看似有效，实则无效。** 它们保存并显示成功消息，而机器人继续使用标准速率：文字和语音开、反应关。

  Starter 上显示的反应 XP 数字也与实际运行的不同。升级到 Basic 才能控制这些。
</Warning>

### 等级曲线

101 个等级。等级 1 需要 70 XP；等级 100 需要 950,000。进阶在顶部有意陡峭，让长期成员的排名有意义。

## 排除

不获取 XP 的角色、文字频道和语音频道。

<Tip>
  排除你的机器人命令频道、垃圾频道和任何 AFK 语音频道。否则成员会靠挂 AFK 刷等级。
</Tip>

## 倍率

<Info>
  需要 **Basic**。
</Info>

给一个角色或一个频道 **0.25× 到 5×** 之间的倍率。

<Warning>
  **同一个角色或频道不能既被排除又有倍率。** 将同一个放入两个列表会导致保存失败并显示服务器原文的错误。请从其中一个列表中移除。
</Warning>

<Note>
  倍率不叠加。当多个适用时——角色、频道和一个活跃的 XP 活动——**取最高的一个生效**。
</Note>

## 语音 XP 细节

若你启用相应限制，语音会话在成员被静音或听觉屏蔽时暂停，并且也可以忽略独自在频道的人。单次会话上限为 8 小时。

<Tip>
  开启 **忽略独自成员**。否则一位成员可以整晚独自挂在频道里，超越整个服务器的等级。
</Tip>

## 奖励角色

在文字等级、语音等级或两者授予角色。

当同时设置两者时，**AND / OR** 切换决定成员是需要同时达到两者还是任一。

每个奖励你还可以：

* **移除较低** ——获得更高等级奖励角色时移除较低的
* **私信消息** ——私下告知成员
* **在榜首显示** ——在排行榜上显示该角色

<Warning>
  **未选择角色的奖励行在你保存时会被悄悄丢弃。** 若某行在保存后消失，那就是原因——保存前请挑选一个角色。
</Warning>

<Warning>
  每个奖励角色都必须位于 Vetox 角色 **之下**。参见 [权限](/zh-CN/permissions)。
</Warning>

## 升级消息

四个独立消息，各有自己的开关、频道和格式：频道升级、语音升级、反应升级和私信。

每个都可以是纯文本或嵌入。

## XP 重置

两种：

**离开时/被封禁时** ——成员离开或被封禁时清空其 XP。

**计划性** ——每日、每周或每月清空整个服务器的 XP。

<Info>
  计划性重置需要 **Max**。
</Info>

<Note>
  重置时间使用你在 [服务器设置](/zh-CN/server-management/setup) 页面设置的时区，而不是 UTC，也不是你的浏览器。若在短月中的某日不存在，每月重置会回退到最后一日。
</Note>

## 公开排行榜

开启即可在公开 URL 上发布只读排行榜，在页面上显示并附有复制按钮。

## 故障排查

<AccordionGroup>
  <Accordion title="没有人在获得 XP">
    请检查升级模块在服务器设置中已开启、该频道未被排除，且成员没有被排除的角色。
  </Accordion>

  <Accordion title="我关闭了文字 XP 但成员仍在升级">
    在 Starter 上，那些开关不生效。请升级到 Basic，或改为排除频道。
  </Accordion>

  <Accordion title="奖励角色没有被授予">
    该角色必须在角色列表中位于 Vetox 之下，Vetox 需要 **管理角色** 权限。还请确认该行确实选择了角色——空白行在保存时会被丢弃。
  </Accordion>

  <Accordion title="保存失败并显示关于角色或频道的错误">
    同一角色或频道同时在排除列表和倍率列表中。请从其中一个中移除。
  </Accordion>

  <Accordion title="某人升级远快于其他人">
    请检查是否有未排除的 AFK 语音频道，并开启忽略独自成员。
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="XP 活动" icon="bolt" href="/zh-CN/engagement/xp-events">
    限时 XP 加成。
  </Card>

  <Card title="战斗通行证" icon="trophy" href="/zh-CN/engagement/battle-pass">
    赛季任务和分级奖励。
  </Card>
</CardGroup>
