Communauté & gestion
Suivi des invitations
Ganyu attribue chaque arrivée au membre dont le lien d'invitation a servi, tient un compteur par inviteur et récompense les meilleurs avec des rôles. Le suivi est désactivé par défaut et se règle par /invites config ou depuis l'onglet Invitations du Le dashboard web.
Par l'équipe Ganyu Mis à jour le
Activer le suivi
Activez le suivi avec /invites config enabled:True ou l'interrupteur de l'onglet Invitations du dashboard. À l'activation, Ganyu relit tout de suite la liste des liens du serveur : c'est l'état de départ auquel chaque arrivée est comparée.
Ganyu a besoin de la permission Gérer le serveur : sans elle, Discord refuse de lui donner la liste des invitations et les arrivées ne peuvent pas être attribuées. Le dashboard affiche alors un bandeau d'alerte avec un bouton « Revérifier », et /invites show le signale aussi. Les créations et suppressions de liens arrivent par l'intent Discord des invitations, qui n'est pas privilégié : il n'y a rien à activer de votre côté.
Astuce — Après avoir rendu la permission, lancez /invites sync (ou « Revérifier » dans le dashboard) pour relire les liens immédiatement.
Comment une arrivée est attribuée
Discord ne dit jamais quel lien a servi. Ganyu compare le nombre d'utilisations de chaque lien juste avant et juste après l'arrivée : le lien dont le compteur a augmenté désigne l'inviteur. Certaines arrivées ne peuvent pas être créditées :
- Lien personnalisé (vanity) : l'arrivée est enregistrée comme telle, sans inviteur.
- Inconnue : aucun compteur n'a bougé (lien supprimé entre-temps, état de départ perdu).
- Ambiguë : plusieurs liens ont servi au même instant ; plutôt que de deviner, personne n'est crédité.
- Lien à usage unique : Discord le supprime dès qu'il est utilisé ; Ganyu le reconnaît quand il était à une utilisation de sa limite juste avant.
- Bot : un bot ajouté par autorisation n'utilise aucun lien et n'est crédité à personne.
- Permission manquante : l'arrivée a eu lieu alors que Ganyu n'avait pas Gérer le serveur.
Règle de calcul
total = arrivées + bonus − départs − faux comptes. Un membre ne compte qu'une fois par inviteur, même s'il part et revient plusieurs fois par ses liens ; ses retours sont affichés à titre indicatif.
Un compte plus jeune que le seuil « compte récent » (7 jours par défaut, réglable de 1 à 90 jours) au moment de son arrivée est compté comme faux et retire une invitation. Un membre compté qui quitte le serveur devient un départ. S'il revient par le lien d'un autre membre, il est crédité à ce dernier et compte comme départ pour le premier inviteur.
Le total n'a pas de plancher : des bonus retirés ou des faux comptes peuvent le rendre négatif.
Les commandes
show, leaderboard, who et codes sont ouvertes à tous. bonus, reset, sync, config et rewards demandent la permission Gérer le serveur.
/invites show [member] Total d'invitations d'un membre (vous par défaut), avec le détail arrivées, départs, faux comptes, retours et bonus.
/invites leaderboard [period] Classement des inviteurs, depuis toujours ou sur 30 jours, 7 jours ou 24 heures, par pages de 10.
/invites who <member> Qui a invité ce membre, avec quel lien et quand.
/invites codes [member] Liens d'invitation actifs d'un membre et leurs utilisations.
/invites bonus add <member> <amount> [reason] Ajoute des invitations bonus (1 à 10 000) à un membre.
/invites bonus remove <member> <amount> [reason] Retire des invitations bonus à un membre.
/invites reset [member] Efface l'historique d'un membre, ou de tout le serveur sans membre, après un bouton de confirmation. Définitif.
/invites sync Relit les liens du serveur sur Discord et vérifie la permission.
/invites config <enabled> [fake_days] [log_channel] [log_off] Active ou désactive le suivi, règle le seuil des comptes récents (1 à 90 jours) et le salon de log ; log_off retire le salon.
/invites rewards add <role> <invites> Donne un rôle à partir d'un nombre d'invitations (1 à 10 000).
/invites rewards remove <role> Retire un rôle des paliers. Les membres qui l'ont le gardent.
/invites rewards list Liste les paliers configurés, le mode et le plafond de votre offre.
/invites rewards mode <mode> stack cumule tous les paliers atteints, replace ne garde que le plus haut.
Rôles par palier
Un rôle de palier est donné dès que le total d'invitations atteint son seuil, et retiré si le total redescend dessous. Seuls les rôles configurés comme paliers sont touchés : un rôle donné à la main n'est jamais retiré. Le rôle ne peut être ni @everyone, ni un rôle géré par une intégration, ni un rôle placé au-dessus de celui de Ganyu.
| Limite | FREE | PREMIUM | PRO |
|---|---|---|---|
| Paliers de rôles | 3 | 10 | 25 |
Astuce — Les paliers se gèrent aussi dans l'onglet Invitations du dashboard, avec le compteur de paliers utilisés sur le plafond de votre Premium.
Dans le dashboard
L'onglet Invitations regroupe l'activation, le seuil des comptes récents, le salon de log, le mode et l'éditeur de paliers, le classement par période et l'historique des arrivées et départs. L'historique se filtre par membre, inviteur, type, source et période, et s'exporte en CSV (50 000 événements au plus, les plus récents).
Messages d'accueil et salon de log
Les messages de bienvenue et de départ acceptent {inviter} (mention de l'inviteur), {inviterName} (son nom), {inviteCode} (le code du lien) et {inviterInvites} (son total). Quand l'arrivée n'est pas attribuée ou que le suivi est désactivé, un libellé neutre remplace la variable. Voir Rôles automatiques & bienvenue.
Le salon de log, choisi par /invites config log_channel ou dans le dashboard, annonce chaque arrivée et chaque départ avec son inviteur.
Condition d'invitations pour les giveaways
Un modèle de giveaway peut exiger un nombre minimum d'invitations pour participer. Tant que le suivi est désactivé sur le serveur, la participation à un tel giveaway est refusée plutôt qu'acceptée sans contrôle. Voir Giveaways.
Données et confidentialité
Ganyu enregistre les arrivées et départs (membre, inviteur, code du lien, date) et les bonus. Ces données sont supprimées avec le reste des données du serveur 30 jours après le départ du bot. Chaque membre peut exporter ou effacer ses données depuis la page Confidentialité de son compte sur ganyu.fr ; la commande /privacy gère le suivi d'activité.
Questions fréquentes
Pourquoi une arrivée est-elle « inconnue » ?
Aucun compteur de lien n'a bougé entre les deux relevés : le lien a pu être supprimé juste avant, ou le relevé de départ manquait. Lancez /invites sync pour repartir d'un état à jour.
Le lien personnalisé du serveur compte-t-il pour quelqu'un ?
Non. Une arrivée par le lien personnalisé (vanity) est enregistrée comme telle et n'est créditée à aucun membre.
Que se passe-t-il si un membre invité part puis revient ?
Il ne compte qu'une fois pour son inviteur. S'il revient par le lien d'un autre membre, c'est ce dernier qui est crédité et le premier inviteur le compte en départ.
Comment exiger des invitations pour un giveaway ?
Fixez un minimum d'invitations dans un modèle de giveaway du dashboard. Le suivi doit être activé, sinon la participation est refusée.
Combien de rôles de palier puis-je créer ?
3 en FREE, 10 en PREMIUM et 25 en PRO. Voir Premium.
Sources et documentation officielle
Communauté & gestion
Prêt à essayer Ganyu ?
Ajoutez Ganyu à votre serveur Discord gratuitement et mettez ce guide en pratique en moins d'une minute.
Ajouter Ganyu gratuitement