Installer et utiliser AntiFast

Avant de commencer

Vous avez besoin :

• d'un compte Discord ;
• d'être propriétaire du serveur à protéger, ou administrateur avec la permission de gérer les rôles ;
• d'une dizaine de minutes.

Connectez-vous sur l'espace client avec votre compte Discord et cliquez sur « Créer mon bot » : votre service est ouvert immédiatement, gratuitement. Un guide en plusieurs étapes s'affiche alors en haut à droite de l'écran et reprend les instructions ci-dessous.

Créer le bot

AntiFast fonctionne avec un bot qui vous appartient. Vous le créez une fois sur le portail développeur de Discord :

1. Ouvrez le portail développeur Discord et cliquez sur New Application. Le nom choisi sera celui du bot.
2. Ouvrez l'onglet Bot.
3. Dans la section Privileged Gateway Intents, activez Server Members Intent et Message Content Intent, puis enregistrez.
4. Cliquez sur Reset Token, confirmez, puis copiez le token affiché.

Installer depuis le panel

La page Installation du panel comporte quatre étapes :

1. Token du bot : collez le token et enregistrez. Le panel vérifie qu'il est valide et que les deux intents sont activés ; un avertissement s'affiche sinon.
2. Inviter le bot : le bouton ouvre la fenêtre d'invitation de Discord avec la permission Administrateur. Choisissez votre serveur.
3. Choisir le serveur : de retour sur le panel, cliquez sur Actualiser, sélectionnez votre serveur et validez. Le bot démarre immédiatement.
4. Dernières vérifications : placez le rôle du bot, puis effectuez les premiers réglages décrits ci-dessous.

Au démarrage, le bot indexe les rôles et les permissions du serveur, crée une première sauvegarde et enregistre ses commandes slash.

Placer le rôle du bot

Sur Discord, un membre ne peut agir que sur les rôles et les membres situés en dessous de son rôle le plus élevé. Le bot obéit à la même règle : s'il est placé sous le rôle d'un modérateur, il ne pourra ni sanctionner ce modérateur, ni restaurer les rôles situés au-dessus de lui.

Dans Paramètres du serveur → Rôles, faites glisser le rôle du bot en première position. Au démarrage, le bot publie un avertissement dans le salon de logs s'il n'est pas au sommet de la hiérarchie.

Premiers réglages

1. Salon de logs : dans Bot et serveur, choisissez le salon où publier les incidents, ou tapez !logs sur Discord pour en créer un, visible de vous seul.
2. Whitelist : dans Accès et whitelist, ajoutez les membres de confiance. Ils ne seront jamais sanctionnés et pourront utiliser les commandes de modération. Gardez cette liste courte.
3. Bots autorisés : ajoutez les bots que vous utilisez déjà (musique, niveaux, rôles-réactions…). Un bot absent de cette liste est banni dès son arrivée, et la personne qui l'a ajouté est sanctionnée.
4. Alertes : indiquez les personnes à prévenir en message privé lors d'un incident grave.
5. Modules : parcourez la page Protection et ajustez les sanctions et les seuils à la taille de votre serveur.

Les sanctions

Chaque module applique l'une des sanctions suivantes à l'auteur de l'action :

Si la sanction échoue, le plus souvent parce que le rôle du bot est trop bas, l'incident l'indique explicitement dans les logs.

Niveaux d'accès

Sur Discord

• Propriétaire : le propriétaire du serveur et le propriétaire du service AntiFast, ainsi que le support AntiFast si vous l'avez autorisé. Accès à toutes les commandes, dont la configuration.
• Whitelist : les membres de la whitelist et les propriétaires. Accès aux commandes de modération.
• Rôles de permission : dans Accès et whitelist, choisissez des rôles pour chaque niveau (1 : assistant, 2 : modérateur, 3 : administrateur, et giveaways). Leurs membres utilisent les commandes de ce niveau et des niveaux inférieurs, sans être dispensés de la protection.
• Tout le monde : aide, invitations, pactes et commandes d'information.

Dans le panel

• Lecteur : consultation uniquement.
• Gestionnaire : réglages, sauvegardes, messages, console et démarrage du bot.
• Propriétaire : tout ce qui précède, plus la gestion de l'équipe, du token et du serveur protégé.

Sauvegardes

Une sauvegarde est créée au démarrage du bot puis à la fréquence choisie dans Bot et serveur (toutes les heures par défaut). Vous pouvez aussi en créer une à tout moment depuis la page Sauvegardes ou avec !backup create.

Lors d'une restauration, vous choisissez la portée (rôles et salons, rôles seuls ou salons seuls) et la réattribution des rôles aux membres. Le bot :

1. recrée les rôles manquants et réaligne les rôles existants (retrouvés par identifiant ou par nom) ;
2. recrée les catégories puis les salons manquants, et réapplique les permissions ;
3. supprime les éléments absents de la sauvegarde, uniquement si l'option de nettoyage est cochée ;
4. rend leurs rôles aux membres.

Sur un serveur important, la restauration peut prendre plusieurs minutes en raison des limites de requêtes imposées par Discord.

Messages et tickets

La page Messages du panel permet de composer un message, de le prévisualiser puis de le faire publier par le bot dans un salon. Deux formats sont disponibles :

• Embed classique : un texte, jusqu'à dix embeds et cinq boutons-liens.
• Components V2 : une mise en page par blocs (textes, sections avec vignette, galeries, séparateurs, boutons), éventuellement regroupés dans un cadre coloré.

Les messages publiés restent modifiables depuis l'historique, dans leur format d'origine. Les mentions ne notifient personne, sauf si vous activez l'option correspondante.

Les tickets se configurent dans la page Tickets : titre et texte du panneau, catégories, rôles de l'équipe, message d'accueil et salon des transcripts. Publiez ensuite le panneau depuis le panel ou avec !ticket.

La page Rôles-réactions publie un message (texte, embed ou Components V2, ou un modèle de la page Messages) ou reprend un message existant grâce à son lien, puis y ajoute des réactions : chaque emoji donne le rôle choisi au membre qui réagit. Trois modes : classique (retirer sa réaction retire le rôle), unique (un seul rôle de la liste à la fois) et permanent (le rôle reste). Sur Discord, !rolereact create #salon embed Titre | Description publie le message, puis !rolereact add <lien du message> 🎮 @Rôle ajoute une réaction (ou répondez au message avec !rolereact add 🎮 @Rôle). Les rôles à permissions sensibles ne peuvent pas être distribués ainsi.

Référence des commandes

Le préfixe par défaut est ! et se modifie dans le panel. Chaque commande existe aussi en commande slash. Dans les exemples, <…> désigne un argument obligatoire et […] un argument facultatif.

Modération

Gestion du serveur

Antiraid

Permissions

Configuration du serveur

Contrôle du bot

Suivi des invitations

Communauté

Utilitaire

Dépannage

Le bot apparaît hors ligne

Vérifiez dans Installation que le token est valide et qu'un serveur est sélectionné, puis consultez la Console. Un bot au-delà du nombre de bots de votre formule (par exemple à la fin du VIP) est également mis en pause : voyez la page Formule & VIP.

« Échec de la sanction (rôle du bot trop bas) »

Le rôle du bot est placé sous celui de l'auteur. Remontez-le en première position.

Les commandes slash n'apparaissent pas

Dans la Console, utilisez « Resynchroniser les commandes slash », puis redémarrez Discord.

Le bot ne lit pas les messages

L'intent Message Content n'est pas activé sur le portail développeur. Activez-le puis redémarrez le bot.

Un modérateur a été sanctionné par erreur

Ajoutez-le à la whitelist, ou à la liste de gestion des salons si seuls les salons sont concernés. Débannissez-le avec !unban.

Pour toute autre question, contactez le support sur notre serveur Discord.