추천
개인 초대 링크, 누가 누구를 초대했는지, 초대 후 바로 나가는 행위를 막는 체류 타이머, 추천 수에 따른 보상 역할.
작동 방식
Discord는 멤버가 어떤 초대를 사용했는지 알려 주지 않으므로, 봇은 모든 초대의 사용 횟수를 기록하고 누군가 가입하면 횟수가 올라간 초대에 공을 돌립니다. /referrals link는 실행한 멤버를 위해 봇이 만든 개인 초대를 생성하므로, Discord의 초대 창을 거치지 않고도 그 멤버의 가입이 그 사람에게 집계됩니다.
각 추천은 알림으로 표시됩니다. 로그 채널에 임베드로 게시되거나, 스태프용 비공개 티켓에 승인 및 거절 버튼과 함께 올라옵니다. 멤버가 보상 기준에 도달하면 역할이 자동으로 부여됩니다.
설정
- /referrals setup enabled:true
- 추적을 켭니다. 옵션: mode(log 또는 ticket), log_channel, ticket_category, staff_role, hold, hold_hours(1-720), min_account_age(0-365일).
- /referrals reward-add count:<n> role:@role
- 멤버가 집계된 추천 n건에 도달하면 역할을 한 번 부여합니다. 여러 단계를 추가할 수 있으며, /referrals reward-remove count:<n>으로 하나를 제거합니다.
- /referrals settings
- 현재 설정과 지금까지 집계된 총 추천 수.
- 추천 페이지(대시보드)
- 커뮤니티 → 추천: 같은 설정을 양식으로 보여 주며, 보상 단계도 함께 표시됩니다.
멤버 명령어
- /referrals link
- 이 서버에서 사용하는 본인의 개인 초대 링크.
- /referrals me
- 데려온 사람 수와 아직 체류 타이머를 기다리는 사람 수.
- /referrals top
- 추천을 가장 많이 한 멤버.
- /referrals user member:@someone
- 스태프 전용: 한 멤버의 총계.
집계되지 않는 경우
- 재가입
- 서버에서 멤버 한 명당 추천은 한 번만 집계됩니다. 나갔다가 다른 링크로 다시 들어와도 다시 집계되지 않습니다.
- 자가 초대 및 봇
- 집계되지 않음.
- 신규 계정
- min_account_age 일수보다 어린 계정은 거부됩니다.
- 초대 후 바로 나가기
- hold가 켜져 있으면 추천은 hold_hours 동안 기다리며, 멤버가 여전히 서버에 있을 때만 집계됩니다.
봇이 초대를 읽으려면 서버 관리 권한이 필요합니다. 권한이 없으면 가입이 추천자에게 연결되지 않지만 다른 기능은 그대로 작동합니다. 커스텀 URL을 통한 가입은 특정 멤버와 연결되지 않습니다.