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

# 等级命令

> 等级卡片、服务器排行榜和管理员经验值调整。

五个命令。两个面向所有人；三个需要 **管理服务器** 权限。

## 面向所有人

<AccordionGroup>
  <Accordion title="/rank — 您的等级卡" icon="id-card">
    | 选项      | 必需 | 说明               |
    | ------- | -- | ---------------- |
    | `user`  | 否  | 默认是您             |
    | `theme` | 否  | `dark` 或 `light` |

    冷却 10 秒。Vetox 需要 **附加文件** 权限。

    显示文字和语音进度，并应用该成员已装备的 [背景与进度条颜色](/zh-CN/members/rank-customization)。
  </Accordion>

  <Accordion title="/top — 服务器排行榜" icon="ranking-star">
    | 选项         | 必需 | 说明                                  |
    | ---------- | -- | ----------------------------------- |
    | `duration` | 否  | `global`（默认）、`day`、`week` 或 `month` |
    | `role`     | 否  | 将排行榜限制为拥有某角色的成员                     |

    冷却 15 秒。发送后也可通过按钮切换时段。
  </Accordion>
</AccordionGroup>

<Note>
  `/top` 显示的是 **本服务器** 内获得的经验值。它与网站上的全局 [排行榜](/zh-CN/members/leaderboards) 不同 —— 一个成员可以在服务器榜首但完全不出现在全球榜上。
</Note>

<Warning>
  **没有 `/level` 命令。** `/rank` 是唯一的等级卡命令。
</Warning>

## 管理

三个都需要 **管理服务器** 权限。每个冷却 5 秒。

<AccordionGroup>
  <Accordion title="/setxp — 调整经验值" icon="pen">
    | 选项     | 必需    | 说明                                     |
    | ------ | ----- | -------------------------------------- |
    | `user` | **是** |                                        |
    | `type` | **是** | `text` 或 `voice`                       |
    | `xp`   | **是** | 接受 `500`、`+500`、`500+`、`-500` 或 `500-` |
  </Accordion>

  <Accordion title="/setlevel — 调整等级" icon="arrow-up-1-9">
    结构相同，将 `xp` 换成 `level`，同样支持相对语法。
  </Accordion>

  <Accordion title="/reset — 清除经验值" icon="rotate-left">
    | 选项     | 必需    | 说明                 |
    | ------ | ----- | ------------------ |
    | `type` | **是** | `text` 或 `voice`   |
    | `user` | 否     | **省略将重置服务器中的每位成员** |
  </Accordion>
</AccordionGroup>

<Tip>
  `/setxp` 和 `/setlevel` 支持相对值 —— 您可以在成员当前总数上加减，而不是覆盖它。`+500` 加；`500` 设置。
</Tip>

<Warning>
  **不带 `user` 的 `/reset` 会重置该经验值类型下服务器中的所有成员。此操作无法撤销。** 没有确认提示。
</Warning>

## 疑难解答

<AccordionGroup>
  <Accordion title="/rank 没有发布图片">
    Vetox 在该频道缺少 **附加文件** 权限。
  </Accordion>

  <Accordion title="/top 为空">
    还没有人获得经验值，或在 [服务器设置](/zh-CN/server-management/setup) 中等级功能被关闭。
  </Accordion>

  <Accordion title="我调整了经验值但等级没有变化">
    等级由总经验值推导。较小的调整可能未跨越阈值 —— 高等级的曲线较陡。
  </Accordion>

  <Accordion title="我运行了 /reset 结果全丢了">
    省略 `user` 会重置整个服务器。无法撤销，也没有备份。
  </Accordion>
</AccordionGroup>

<Card title="等级" icon="chart-line" horizontal href="/zh-CN/engagement/leveling">
  经验值的获取方式、倍率、角色奖励和升级消息。
</Card>