Parrainages

Liens d'invitation personnels, qui a invité qui, un délai de présence qui bloque les invitations suivies d'un départ, et des rôles de récompense à partir d'un certain nombre de parrainages.

Fonctionnement

Discord n'indique pas quelle invitation a utilisé un membre : le bot conserve donc le nombre d'utilisations de chaque invitation et, lorsqu'un membre arrive, attribue le parrainage à l'invitation dont le compteur a augmenté. /referrals link crée pour le membre qui l'exécute une invitation personnelle générée par le bot, afin que ses arrivées lui soient attribuées sans passer par la fenêtre d'invitation de Discord.

Chaque parrainage est annoncé : un embed dans un salon de journal, ou un ticket privé pour le staff avec les boutons Approuver et Refuser. Dès qu'un membre atteint un seuil de récompense, il reçoit automatiquement le rôle.

Configuration

/referrals setup enabled:true: Active le suivi. Options : mode (log ou ticket), log_channel, ticket_category, staff_role, hold, hold_hours (1-720), min_account_age (0-365 jours).
/referrals reward-add count:<n> role:@role: Attribue un rôle dès qu'une personne atteint n parrainages comptés. Ajoutez-en plusieurs pour des paliers ; /referrals reward-remove count:<n> en retire un.
/referrals settings: La configuration actuelle et le total comptabilisé jusqu'ici.
Page Parrainages (tableau de bord): Communauté → Parrainages : les mêmes paramètres dans un formulaire, ainsi que les paliers de récompense.

Commandes pour les membres

/referrals link: Votre lien d'invitation personnel pour ce serveur.
/referrals me: Le nombre de personnes que vous avez amenées, et le nombre d'entre elles encore en attente du délai de présence.
/referrals top: Les membres avec le plus de parrainages.
/referrals user member:@someone: Réservé au staff : les totaux pour un seul membre.

Ce qui ne compte pas

Retours: Un seul parrainage par membre et par serveur, une fois pour toutes. Quitter puis revenir par un autre lien ne compte pas à nouveau.
Auto-invitations et bots: Jamais comptabilisé.
Comptes récents: Les comptes plus jeunes que min_account_age jours sont refusés.
Inviter puis quitter: Avec hold activé, un parrainage attend hold_hours et ne compte que si le membre est toujours présent sur le serveur.

Le bot a besoin de la permission Gérer le serveur pour lire les invitations. Sans elle, les arrivées ne sont pas attribuées, mais rien d'autre ne casse. Les arrivées via une URL personnalisée ne sont pas liées à un membre.