Vérifier les nouveaux membres avec le Captcha

Le module Captcha demande à chaque nouvel arrivant de recopier un code affiché dans une image avant d'accéder à ton serveur. Les bots et les comptes automatiques restent bloqués à l'entrée, et tes salons restent propres. 🛡️

Le principe est simple : le membre arrive, il ne voit qu'un salon de vérification, il résout le captcha et reçoit alors ses rôles d'accès.

1. Préparer tes rôles et tes salons

Le Captcha ne crée pas de rôle « vérifié » : quand un membre réussit, HurixBot lui donne les rôles automatiques du module Welcome & Goodbye. C'est donc là que tout commence.

1. Crée un rôle, par exemple Membre.
2. Dans Modules → Welcome & Goodbye, ajoute ce rôle dans les rôles automatiques et active le module.
3. Règle les permissions de tes salons : ils doivent être visibles uniquement par le rôle Membre, pas par @everyone.
4. Crée un salon #vérification visible par @everyone. Tu peux le masquer au rôle Membre pour que les membres vérifiés ne le voient plus.

2. Activer le module et choisir le salon

Ouvre Modules → Captcha sur le dashboard et active le module avec l'interrupteur en haut.

Dans Salon du captcha, choisis ton salon #vérification. C'est là que le bot publie le captcha de chaque arrivant, en le mentionnant. Sans salon, aucun captcha ne peut être envoyé.

3. Choisir le niveau de sécurité

Quatre niveaux sont proposés. Les majuscules et minuscules comptent toujours, et les caractères qui se confondent (I, l, O, 0, 1) ne sont jamais utilisés.

• Permissif : code de 5 caractères. Le membre choisit le bon code parmi 5 propositions dans un menu déroulant. Après chaque erreur, un nouveau code est généré.
• Standard : code de 5 caractères (lettres et chiffres). Le membre clique sur Vérifier et recopie le code dans une petite fenêtre.
• Agressif : code de 6 caractères, avec des symboles.
• Maximum : code de 8 caractères avec symboles, le niveau le plus contraignant.

Changer de niveau ajuste aussi le cooldown conseillé (3 s, 3 s, 5 s ou 10 s), sauf si tu as déjà mis ta propre valeur.

4. Régler les tentatives et les délais

Dans Tentatives et délais :

• Échecs avant exclusion : entre 1 et 10 (3 par défaut).
• Expulser après trop d'échecs : activé par défaut. Si tu le désactives, le membre n'est jamais expulsé et peut continuer à essayer.
• Cooldown entre deux tentatives : entre 1 et 60 secondes. Le bot refuse toute réponse envoyée trop vite.
• Durée de vie d'un captcha : entre 60 et 3600 secondes (300 par défaut). Passé ce délai, le code est refusé et un nouveau captcha est publié automatiquement quand le membre clique.

Le compteur d'échecs est conservé même si le captcha expire ou si le membre quitte le serveur puis revient : impossible de « repartir de zéro » en trichant.

5. Personnaliser les messages

La section Messages personnalisables contient les 5 réponses envoyées au membre (visibles par lui seul). Chaque message fait 1500 caractères au maximum, et les variables utilisables sont affichées sous chaque champ.

• Réussite : {user}, {server}
• Échec : {remaining} (essais restants), {fails}, {maxFails}, {cooldown}, {seconds}
• Cooldown actif : {cooldown}, {seconds}
• Captcha expiré : aucune variable
• Exclusion : {user}, {server}, {fails}, {maxFails}

{cooldown} affiche un délai relatif (« dans 3 secondes »), {seconds} le nombre de secondes du cooldown.

N'oublie pas de cliquer sur Enregistrer en bas de la page.

6. Ce que voit le nouveau membre

À son arrivée, le membre est mentionné dans le salon de vérification avec un message 🔒 Vérification requise : l'image du code, son niveau, les essais restants et l'heure d'expiration.

1. Il clique sur Vérifier (ou ouvre le menu déroulant au niveau Permissif).
2. Il saisit le code exact, en respectant les majuscules.
3. Bonne réponse : le message du captcha est supprimé, il reçoit ses rôles et voit enfin le serveur. 🎉

Chaque captcha est personnel : un autre membre qui clique dessus reçoit « Ce captcha n'est pas pour toi. »

Permissions nécessaires au bot

• Gérer les rôles, avec le rôle de HurixBot placé au-dessus des rôles automatiques à donner.
• Expulser des membres, si l'expulsion après trop d'échecs est activée.
• Voir le salon de vérification, y envoyer des messages et des fichiers (l'image du code).

Erreurs fréquentes

• Le membre réussit mais ne voit rien : aucun rôle automatique dans Welcome & Goodbye, ou rôle de HurixBot placé trop bas.
• Aucun captcha n'apparaît : salon non choisi, supprimé, ou le bot ne peut pas y écrire.
• Le membre n'est pas expulsé : le bot n'a pas la permission d'expulser. Dans ce cas, il reçoit un nouveau captcha.
• Les nouveaux voient tout le serveur : @everyone a encore accès à tes salons. Retire-lui la permission de les voir.

Pour aller plus loin, complète le Captcha avec le Mode Raid (tutoriel « Protéger ton serveur des raids »).