Modérer ton serveur avec les commandes HurixBot

HurixBot regroupe toutes les commandes de modération dont ton équipe a besoin : sanctions, historique, nettoyage de salons et gestion des rôles. Ce guide détaille chaque commande, ses options et la permission Discord nécessaire pour l'utiliser. ⚖️

1. Les règles communes

Les permissions : chaque commande n'apparaît qu'aux membres qui ont la permission Discord indiquée. Tu peux ajuster qui y a accès dans Paramètres du serveur → Intégrations → HurixBot.

La hiérarchie : un modérateur ne peut pas sanctionner quelqu'un dont le rôle le plus haut est égal ou supérieur au sien, ni se sanctionner lui-même. Personne ne peut sanctionner le propriétaire du serveur, et le propriétaire peut sanctionner tout le monde. Le rôle de HurixBot doit aussi être placé au-dessus des membres à sanctionner.

Les durées s'écrivent avec un nombre suivi d'une unité : 30s, 10m, 2h, 7d (secondes, minutes, heures, jours). Une seule unité à la fois : 1h30m n'est pas accepté, écris 90m.

Le membre est prévenu : pour un ban, un kick, un mute, un unmute ou un avertissement, HurixBot lui envoie un message privé avec le serveur, la raison et la durée. Si ses MP sont fermés, la sanction s'applique quand même.

2. Bannir

• /ban <user> [time] [reason] [delete_message] : bannit un membre du serveur. Sans time, le ban est définitif. Avec time, il est levé automatiquement à l'échéance. delete_message efface ses messages des 0 à 7 derniers jours. Bannir des membres.
• /editban <user_id> <time> <reason> : change la durée d'un ban en cours. La nouvelle durée part de maintenant, et un ban définitif devient temporaire. Bannir des membres.
• /unban <user_id> [reason] : lève un ban. Bannir des membres.

3. Expulser et rendre muet

• /kick <user> [reason] : expulse un membre, qui peut revenir avec une invitation. Expulser des membres.
• /mute <user> <time> [reason] : exclut temporairement un membre (il ne peut plus écrire, parler ni réagir). Durée maximale : 28 jours. Exclure temporairement des membres.
• /editmute <user> <time> <reason> : change la durée d'un mute en cours, à partir de maintenant. Exclure temporairement des membres.
• /unmute <user> [reason] : lève le mute. Exclure temporairement des membres.

4. Avertir et suivre l'historique

• /warn <user> <reason> : ajoute un avertissement. La raison est obligatoire, et la réponse indique combien d'avertissements le membre a déjà reçus. Exclure temporairement des membres.
• /history view <user> [type] : affiche l'historique des sanctions d'un membre, 10 par page. type filtre sur Warn, Mute, Kick ou Ban. Chaque entrée indique la date, le modérateur, la raison, la durée et un ID. Exclure temporairement des membres.
• /delwarn <user> <id> : supprime un avertissement précis, grâce à l'ID affiché par /history view. Exclure temporairement des membres.
• /history clear <user> : vide tout l'historique d'un membre. Tu as 30 secondes pour confirmer avec le bouton. Exclure temporairement des membres.

5. Nettoyer et verrouiller les salons

• /clear <amount> : supprime les 1 à 100 derniers messages du salon. Les messages de plus de 14 jours sont aussi effacés, un par un, donc plus lentement. Gérer les messages.
• /lock [channel] [time] : verrouille un salon (le salon actuel par défaut). Dans un salon textuel, d'annonces ou un forum, @everyone ne peut plus écrire ; dans un vocal ou une scène, il ne peut plus se connecter. Avec time, le salon se déverrouille tout seul. Gérer les rôles.
• /unlock [channel] : déverrouille le salon. Gérer les rôles.
• /nuke [channel] : recrée le salon à l'identique (mêmes réglages, même position) et supprime l'ancien avec tous ses messages. Administrateur.

6. Gérer les rôles

• /addrole <user> <role> [time] : donne un rôle. Avec time, il est retiré automatiquement à l'échéance. Gérer les rôles.
• /removerole <user> <role> [time] : retire un rôle. Avec time, il est rendu automatiquement à l'échéance. Gérer les rôles.
• /rolelist <user> : affiche tous les rôles d'un membre. Gérer les rôles.
• /massrole <role> [include_bots] : donne un rôle à tous les membres du serveur, bots exclus par défaut. Un récapitulatif indique les ajouts, échecs et membres qui l'avaient déjà. Un seul /massrole à la fois par serveur. Administrateur.

Tu ne peux pas attribuer @everyone, un rôle géré par une intégration (bot, booster…), ni un rôle placé au même niveau ou au-dessus du tien.

7. Où retrouver les sanctions

• Dans Discord, avec /history view.
• Dans le dashboard, page Membres : la liste des membres qui ont un historique de sanctions, et leur fiche détaillée. Le bouton Vider l'historique y fait la même chose que /history clear.
• Dans le salon Logs modération, si le module Logs est configuré : bans, débannissements, expulsions et exclusions temporaires y sont publiés, qu'ils viennent de HurixBot ou de Discord directement. Les avertissements, eux, restent dans l'historique.

Les sanctions automatiques de l'AutoMod (avertissement, mute, kick, ban) s'ajoutent au même historique, au nom de « Automod ».

Erreurs fréquentes

• « Format de durée invalide » : utilise 10s, 5m, 2h ou 7d, sans espace ni unité combinée.
• « La durée maximale est de 28 jours » : c'est la limite de Discord pour un mute. Pour plus long, utilise un ban temporaire.
• La commande refuse le membre : il est au-dessus de toi ou de HurixBot dans la liste des rôles. Monte le rôle du bot dans Paramètres du serveur → Rôles.
• Les expulsions et exclusions temporaires n'apparaissent pas dans les logs : donne à HurixBot la permission Voir les logs du serveur.

Pour automatiser une partie de ce travail, découvre le tutoriel AutoMod. Pour tracer chaque action, lis le tutoriel Logs.