推荐
个人邀请链接、谁邀请了谁、可阻止“邀请后立即离开”的停留计时器,以及达到一定推荐数量时发放的奖励身份组。
工作原理
Discord 不会说明成员使用的是哪个邀请链接,因此机器人会记录每个邀请链接的使用次数,当有人加入时,将功劳记在使用次数增加的那个邀请链接上。 /referrals link 会为运行命令的成员创建一个由机器人生成的个人邀请链接,使其加入记录归于自己名下,而无需使用 Discord 的邀请对话框。
每次推荐都会发出通知:在日志频道中发送嵌入消息,或为工作人员创建一个带有“Approve”和“Reject”按钮的私密工单。成员达到奖励门槛后,会自动获得相应身份组。
设置
- /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 小时,且只有该成员仍在服务器中时才会计入。
机器人需要“管理服务器”权限才能读取邀请链接。没有该权限时,加入记录无法归因,但其他功能不会受影响。通过专属网址加入的成员无法与具体成员关联。