레벨
레벨 기능은 서버 활동을 XP로 기록하고, 멤버가 일정 레벨에 도달하면 알림을 보내거나 보상 역할을 주는 기능이에요. 채팅 활동만 보는 단순한 레벨 시스템이 아니라 음성 참여, 초대, 반응, 출석까지 함께 다룰 수 있어요.
XP가 쌓이는 곳
| 소스 | 설명 |
|---|---|
| 메시지 | 일정 길이 이상의 메시지에 XP를 줘요 |
| 음성 | 음성 채널에 일정 시간 이상 머문 멤버에게 XP를 줘요 |
| 초대 | 새 멤버가 초대로 들어오면 XP를 줄 수 있어요 |
| 반응 | 메시지에 받은 고유 반응을 기준으로 XP를 줄 수 있어요 |
| 출석 | 하루 보너스와 연속 출석 보너스를 줄 수 있어요 |
모든 소스를 한 번에 강하게 켜면 XP가 너무 빨리 올라갈 수 있어요. 처음에는 메시지와 음성만 낮은 값으로 시작하고, 서버 분위기를 보고 조정하는 편이 좋아요.
처음 설정하는 순서
- 레벨 모듈을 켜요.
- 메시지 XP 범위와 쿨다운을 정해요.
- 제외할 채널과 역할을 먼저 지정해요.
- 레벨업 알림을 끄기, 채널, DM 중에서 골라요.
- 보상 역할을 레벨별로 연결해요.
- 낮은 레벨에서 테스트하고 역할 순서를 확인해요.
- 리더보드와 멤버 상세에서 XP가 쌓이는지 확인해요.
보상 역할
레벨 보상 역할은 누적 방식과 최고 레벨만 유지하는 방식으로 나눠요. 누적 방식을 켜면 이전 레벨 역할이 계속 남고, 끄면 가장 높은 레벨 역할만 유지하는 식으로 운영할 수 있어요.
역할 보상이 실패하면 대부분 봇 역할 순서 때문이에요. 보상 역할은 봇 역할보다 아래에 있어야 해요.
레벨업 메시지
레벨업 알림은 텍스트, 임베드, 둘 다 중에서 고를 수 있어요. 알림을 채널로 보낼 때는 알림 채널이 필요하고, DM으로 보낼 때는 사용자의 DM 설정 때문에 실패할 수 있어요.
메시지에는 사용자, 레벨, XP, 서버 이름 같은 변수를 넣어 개인화할 수 있어요. 실제 멘션을 켤지 여부는 서버 피로도에 맞춰 정해 주세요.
XP 부스트와 시즌
XP 부스트는 전체, 특정 채널, 특정 역할에 배율을 적용하는 기능이에요. 이벤트 기간에는 채널 부스트를 쓰고, 후원자나 이벤트 참가자에게는 역할 부스트를 줄 수 있어요.
시즌은 특정 기간의 레벨 운영을 나눌 때 사용해요. 시작과 종료 시간이 겹치지 않게 운영 기준을 먼저 정해 주세요.
과장하면 안 되는 것
- 레벨은 멤버의 “가치”를 자동 판단하는 기능이 아니에요. 활동량 보조 지표로 설명해야 해요.
- 음성 XP는 실제 발화량이 아니라 음성 참여 시간 기준이에요.
- DM 알림은 실패할 수 있어요.
- 역할 보상은 Discord 역할 순서 제한을 우회하지 않아요.
캡처 기준
| 캡처 | 보여 줄 내용 |
|---|---|
| 레벨 설정 | 모듈 상태, XP 범위, 쿨다운, 제외 채널·역할 |
| 보상 역할 | 레벨별 역할 매핑과 누적 여부 |
| 레벨업 메시지 | 텍스트·임베드 모드, 알림 채널, 미리보기 |
| 리더보드 | 순위, XP, 레벨, 음성 시간 |
| 멤버 XP 조정 | 추가, 제거, 설정, 초기화와 사유 입력 |