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

다섯 개의 명령어. 두 개는 누구나 사용할 수 있고, 세 개는 **Manage Server** 권한이 필요합니다.

## 누구나 사용 가능

<AccordionGroup>
  <Accordion title="/rank — 랭크 카드" icon="id-card">
    | 옵션      | 필수  | 비고                |
    | ------- | --- | ----------------- |
    | `user`  | 아니요 | 기본은 본인            |
    | `theme` | 아니요 | `dark` 또는 `light` |

    쿨다운 10초. Vetox에 **Attach Files** 권한이 필요합니다.

    멤버가 장착한 [배경 및 바 색상](/ko/members/rank-customization)이 적용된 텍스트 및 음성 진행도를 보여줍니다.
  </Accordion>

  <Accordion title="/top — 서버 리더보드" icon="ranking-star">
    | 옵션         | 필수  | 비고                                       |
    | ---------- | --- | ---------------------------------------- |
    | `duration` | 아니요 | `global` (기본값), `day`, `week` 또는 `month` |
    | `role`     | 아니요 | 리더보드를 특정 역할 보유자로 제한                      |

    쿨다운 15초. 게시 후 버튼으로도 기간을 전환할 수 있습니다.
  </Accordion>
</AccordionGroup>

<Note>
  `/top`은 **이 서버**에서 획득한 XP를 표시합니다. 웹사이트의 글로벌 [리더보드](/ko/members/leaderboards)와는 다릅니다 — 멤버가 서버 리더보드에서 1위더라도 글로벌에서는 전혀 안 보일 수 있습니다.
</Note>

<Warning>
  **`/level` 명령어는 없습니다.** `/rank`가 유일한 랭크 카드 명령어입니다.
</Warning>

## 관리

세 명령어 모두 **Manage Server** 권한이 필요합니다. 각각 쿨다운 5초.

<AccordionGroup>
  <Accordion title="/setxp — XP 조정" 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 — XP 초기화" icon="rotate-left">
    | 옵션     | 필수    | 비고                         |
    | ------ | ----- | -------------------------- |
    | `type` | **예** | `text` 또는 `voice`          |
    | `user` | 아니요   | **생략 시 서버의 모든 멤버가 초기화됩니다** |
  </Accordion>
</AccordionGroup>

<Tip>
  `/setxp`와 `/setlevel`은 상대 값을 지원합니다 — 멤버의 현재 총합을 덮어쓰는 대신 더하거나 뺄 수 있습니다. `+500`은 더하고, `500`은 설정합니다.
</Tip>

<Warning>
  **`user` 없이 `/reset`을 실행하면 해당 XP 타입에 대해 서버의 모든 멤버가 초기화됩니다. 되돌릴 수 없습니다.** 확인 프롬프트도 없습니다.
</Warning>

## 문제 해결

<AccordionGroup>
  <Accordion title="/rank가 이미지를 게시하지 않아요">
    해당 채널에서 Vetox에 **Attach Files** 권한이 없습니다.
  </Accordion>

  <Accordion title="/top이 비어 있어요">
    아직 아무도 XP를 획득하지 않았거나 [서버 설정](/ko/server-management/setup)에서 레벨링이 꺼져 있습니다.
  </Accordion>

  <Accordion title="XP를 조정했는데 레벨이 바뀌지 않았어요">
    레벨은 총 XP에서 파생됩니다. 작은 조정은 임계값을 넘지 못할 수 있습니다 — 고레벨에서 곡선이 가파릅니다.
  </Accordion>

  <Accordion title="/reset을 실행해서 모두 잃었어요">
    `user`를 생략하면 서버 전체가 초기화됩니다. 실행 취소도 없고 백업도 없습니다.
  </Accordion>
</AccordionGroup>

<Card title="레벨링" icon="chart-line" horizontal href="/ko/engagement/leveling">
  XP 획득 방법, 배율, 역할 보상 및 레벨업 메시지.
</Card>