Compter les invitations

Crow Tools retient qui a invité chaque nouveau membre. Vos membres voient combien de personnes ils ont fait venir, se comparent dans un classement, et vous pouvez récompenser les meilleurs recruteurs par des rôles.

Ce que le bot compte

Quand un membre arrive, le bot retrouve l'invitation qu'il a utilisée et la compte à celui qui l'a créée. Pour chaque membre, il tient quatre compteurs :

• join : les personnes qu'il a invitées ;
• leave : celles qui sont reparties depuis ;
• bonus : des invitations ajoutées ou retirées par un administrateur (voir plus bas) ;
• invalide : les arrivées de comptes trop récents, si vous l'avez activé (voir plus bas).

Le total d'un membre, c'est ses join, moins ses leave, plus ses bonus. Les invitations invalides ne comptent pas dans le total.

Certaines arrivées ne sont comptées à personne :

• celles qui passent par le lien personnalisé du serveur (discord.gg/votre-serveur) : ;list vanity les liste à part ;
• celles où le bot ne peut pas savoir quelle invitation a servi, par exemple lors d'une vague d'arrivées en même temps.

Voir les invitations

Ces commandes sont publiques : vos membres les utilisent dans les salons publics.

• ;invite affiche vos invitations (;invite @membre celles d'un autre) : le total et le détail, et combien il en manque pour le prochain rôle d'invitation ;
• ;leaderboard invite affiche le classement des membres du serveur, 10 par page ;
• ;list invite @membre liste les personnes qu'un membre a invitées, avec la date, et s'ils sont toujours là ou quand ils sont partis ;
• ;list join @membre retrace les allers-retours d'un membre sur le serveur, et qui l'a invité à chaque fois ;
• ;list vanity liste les arrivées par le lien personnalisé du serveur, et combien de ces membres sont encore là.

Les invitations invalides

Un compte créé la veille pour faire monter le score d'un ami ? ;fakelimit 7j compte comme invalide toute arrivée d'un compte créé il y a moins de 7 jours. La durée s'écrit en s, m, h ou j (;fakelimit 12h, ;fakelimit 30j) ; ;fakelimit off désactive ce contrôle.

Les allers-retours éclair

Certains membres rejoignent et repartent aussitôt. Avec ;safejoin 30 (owners), le bot attend 30 secondes avant de compter une arrivée : si le membre est reparti entre-temps, rien n'est compté, et ni le message d'arrivée ni celui de départ ne sont envoyés. Le message d'arrivée est donc retardé d'autant.

L'attente va jusqu'à 300 secondes ; ;safejoin 0 la désactive. Le réglage vaut pour tous les serveurs du bot.

Gérer les invitations

Réservé aux administrateurs :

• ;manageinvite add 5 @membre ajoute 5 invitations bonus à un membre, ;manageinvite del 5 @membre en retire ;
• ;manageinvite reset @membre remet ses invitations à zéro ;
• ;manageinvite resetall remet celles de tous les membres à zéro, après confirmation.

Quand un membre quitte le serveur, ses propres invitations sont gardées pour son retour. Avec ;leavereset invite on, il les perd en partant ; ;leavereset invite off revient au réglage par défaut.

;settings invite résume les réglages des invitations et des messages d'arrivée et de départ.

Récompenser avec des rôles

• ;role invite add @Recruteur 10 : le rôle @Recruteur est donné automatiquement à 10 invitations ;
• ;role invite del @Recruteur retire cette récompense ;
• ;role invite list affiche les rôles d'invitation ;
• ;role invite cumul on : les membres gardent tous les rôles gagnés ; avec off, ils ne gardent que le plus haut. Ce réglage vaut aussi pour les rôles des concours ;
• ;role invite sync (owners) remet à jour les rôles de tous les membres, utile après un changement ; cela peut prendre un moment.

Les rôles suivent le total : si des invités repartent, le membre peut perdre un rôle. Le rôle doit être sous le rôle du bot dans la liste des rôles, et sous votre propre rôle le plus haut.

Les concours d'invitations

Pour un concours (« le meilleur recruteur du mois gagne… »), le bot tient un deuxième compteur, les invitations d'event. Il compte exactement comme le premier, mais vous le remettez à zéro au début de chaque concours, sans toucher aux invitations de toujours.

1. ;manageevent resetall remet le compteur des concours à zéro : le concours commence.
2. Vos membres suivent leur score avec ;event (ou ;event @membre) et le classement avec ;leaderboard event.
3. À la fin, le classement donne les gagnants.

Le reste fonctionne comme pour les invitations :

• ;manageevent add, del et reset gèrent les invitations d'event d'un membre ;
• ;role event add @Champion 20, del, list et sync : des rôles donnés selon le score du concours ;
• ;leavereset event on : un membre qui quitte le serveur perd ses invitations d'event.

Si ça ne marche pas

• Personne n'a d'invitations : vérifiez que le bot a la permission Administrateur et que le serveur est dans la whitelist.
• Une arrivée n'est comptée à personne : le membre est venu par le lien personnalisé du serveur (;list vanity), ou le bot n'a pas pu savoir quelle invitation a servi.
• Un rôle d'invitation n'est pas donné : placez le rôle du bot au-dessus de ce rôle, puis lancez ;role invite sync.
• « Vous devez ajouter ce serveur à la whitelist » : faites ;wl add.

Toutes les commandes

Chaque commande de ce guide, avec ses arguments et qui peut l'utiliser : Invitations.