🚀 Introduction

ModGuard Ultimate est un bot de modération complet pour Discord. Il vous offre une protection avancée contre les raids, les scams, et vous permet de gérer votre communauté avec des outils puissants : tickets, giveaways, niveaux, et bien plus encore.

💡 Astuce : Utilisez la commande /help sur votre serveur Discord pour voir toutes les commandes disponibles directement dans le bot.

🔧 Installation

1. Ajouter le bot sur votre serveur

Pour inviter le bot sur votre serveur, cliquez sur le lien d'invitation que vous a fourni votre administrateur. Vous devez avoir la permission "Gérer le serveur" pour ajouter un bot.

2. Configuration initiale

Une fois le bot sur votre serveur, configurez les éléments suivants :

  • Salon de logs : /config log_channel #salon
  • Rôle de modération : Donnez les permissions nécessaires à vos modérateurs
  • Vérification : /verify setup #salon @role (optionnel)
  • Messages de bienvenue : /welcome set #salon "Message" (optionnel)
⚠️ Important : Pour utiliser les commandes de modération, vos modérateurs doivent avoir les permissions Discord appropriées (Ban, Kick, Moderate Members, etc.).

🛡️ Modération

Avertissements (Warns)

/warn add
Ajouter un avertissement à un utilisateur
ModerateMembers
/warn list
Lister les avertissements d'un utilisateur
Public
/warn remove
Supprimer un avertissement spécifique
ModerateMembers
/warn clear
Supprimer tous les avertissements d'un utilisateur
ModerateMembers

Bans

/ban
Bannir définitivement un utilisateur
BanMembers
/tempban
Ban temporaire (1h, 1d, 1w...)
BanMembers
/unban
Débannir un utilisateur par son ID
BanMembers

Mutes

/mute
Mute temporaire (1h, 1d...)
ModerateMembers
/unmute
Démute un utilisateur
ModerateMembers

Expulsions

/kick
Expulser un utilisateur
KickMembers

Messages

/clear
Supprimer X messages (optionnellement d'un utilisateur)
ManageMessages

Sanctions

/sanctions
Lister les sanctions actives d'un utilisateur
ModerateMembers
/modlog
Voir l'historique des actions d'un utilisateur
ModerateMembers

Quarantaine

/quarantine add
Mettre un utilisateur en quarantaine (isolement)
ModerateMembers
/quarantine remove
Retirer un utilisateur de la quarantaine
ModerateMembers
/quarantine list
Lister tous les utilisateurs en quarantaine
ModerateMembers

⚔️ Anti-Raid

L'anti-raid protège votre serveur contre les arrivées massives de membres (joins massifs). Il détecte automatiquement les raids et applique l'action configurée.

/antiraid set
Configurer le seuil, la fenêtre et l'action
Administrator
/antiraid enable
Activer la protection anti-raid
Administrator
/antiraid disable
Désactiver la protection anti-raid
Administrator
/antiraid status
Voir la configuration et les logs
Administrator

🤖 Auto-Mod

L'auto-modération filtre automatiquement les messages indésirables selon vos règles.

/automod spam
Définir le seuil de spam (messages/10s)
ManageGuild
/automod mentions
Nombre max de mentions par message
ManageGuild
/automod caps
Pourcentage max de majuscules autorisé
ManageGuild
/automod invites
Activer/désactiver le filtre d'invitations
ManageGuild
/automod liens
Activer/désactiver le filtre de liens
ManageGuild

🚫 Anti-Scam

Détecte automatiquement les liens frauduleux et les tentatives de phishing.

/scam add
Ajouter un domaine scam à la liste noire
ManageGuild
/scam remove
Retirer un domaine de la liste
ManageGuild
/scam list
Voir tous les domaines blacklistés
ManageGuild
/scam logs
Voir l'historique des scams détectés
ManageGuild
✅ Protection automatique : Les liens de type "discord-nitro.ru", "steam-gift.ru", et autres domaines frauduleux sont automatiquement détectés et bloqués.

🎁 Giveaways

/giveaway start
Démarrer un giveaway (prix, gagnants, durée, rôle requis optionnel)
ManageGuild
/giveaway end
Terminer un giveaway prématurément
ManageGuild
/giveaway reroll
Re-tirer les gagnants d'un giveaway terminé
ManageGuild
📌 Note : Les participants cliquent sur un bouton 🎉 pour participer.

🎂 Anniversaires

/birthday set
Enregistrer votre anniversaire (JJ/MM)
Public
/birthday remove
Supprimer votre anniversaire
Public
/birthday list
Voir les anniversaires du mois
Public
/birthday check
Déclencher manuellement les anniversaires du jour
ManageGuild
🎉 Automatique : Les anniversaires sont automatiquement annoncés à 9h et les membres reçoivent un bonus de 100 XP !

🔐 Vérification 1-Click

Système de vérification simple : les nouveaux membres cliquent sur un bouton pour obtenir automatiquement un rôle.

/verify setup
Configurer le salon et le rôle de vérification
ManageGuild
/verify enable
Activer le système
ManageGuild
/verify disable
Désactiver le système
ManageGuild
/verify status
Voir la configuration actuelle
ManageGuild

👋 Messages de bienvenue

Personnalisez les messages envoyés aux nouveaux membres.

Variables disponibles :

  • {user} - Mention de l'utilisateur
  • {username} - Nom d'utilisateur
  • {tag} - Tag complet (User#1234)
  • {server} - Nom du serveur
  • {count} - Nombre de membres
  • {avatar} - URL de l'avatar
/welcome set
Configurer le message (salon, message, couleur, image, DM)
ManageGuild
/welcome test
Tester la configuration
ManageGuild
/welcome disable
Désactiver les messages
ManageGuild
/welcome status
Voir la configuration
ManageGuild

📊 Niveaux & XP

Les membres gagnent de l'XP en envoyant des messages (15-25 XP par message, cooldown de 60 secondes). Le niveau augmente tous les 100 XP.

/rank
Voir votre niveau ou celui d'un autre membre
Public
/leaderboard
Classement des 10 meilleurs membres
Public

👤 Profils utilisateurs

/profile
Voir le profil complet d'un utilisateur
Public
/stats
Statistiques détaillées d'un utilisateur
Public
/note
Ajouter une note privée sur un utilisateur
ModerateMembers
/notes
Voir les notes d'un utilisateur
ModerateMembers
/badge
Attribuer un badge personnalisé
ModerateMembers
/trust
Modifier le score de confiance (0-100)
ModerateMembers

🎫 Tickets

Système de tickets pour le support. Les membres peuvent ouvrir des tickets dans différentes catégories.

/ticket setup
Créer le panneau de sélection des tickets
ManageGuild
/ticket close
Fermer le ticket actuel (génère un transcript)
Participants
/ticket add
Ajouter un membre au ticket
Staff
/ticket remove
Retirer un membre du ticket
Staff
/ticket transcript
Voir le transcript HTML d'un ticket
Staff
📄 Transcripts : Les tickets fermés génèrent un joli fichier HTML avec tout l'historique des messages.

📝 Signalements

Système de signalements communautaire. Les membres peuvent signaler d'autres membres, et les modérateurs votent pour décider de l'action à prendre.

/report create
Signaler un utilisateur
Public
/report list
Voir les signalements en attente
ModerateMembers
/report view
Voir les détails d'un signalement
ModerateMembers
/report resolve
Résoudre un signalement (warn/mute/ban/reject)
ModerateMembers
⚖️ Vote : Après 3 votes, une action automatique (quarantaine) est appliquée.

📜 Whitelist

Les utilisateurs whitelistés sont protégés contre l'auto-modération (filtres de mots, etc.).

/whitelist add
Ajouter un utilisateur à la whitelist
Administrator
/whitelist remove
Retirer un utilisateur de la whitelist
Administrator
/whitelist list
Voir tous les utilisateurs whitelistés
Administrator

🚫 Blacklist de mots

Les mots blacklistés sont automatiquement supprimés des messages.

/blacklist add
Ajouter un mot à la blacklist
ManageGuild
/blacklist remove
Retirer un mot de la blacklist
ManageGuild
/blacklist list
Voir tous les mots blacklistés
ManageGuild

📋 Preuves

Générez des preuves à partir d'un message, avec le contexte avant et après.

/evidence create
Créer une preuve à partir d'un ID de message
ModerateMembers
/evidence list
Voir les preuves récemment générées
ModerateMembers
📎 Format : Les preuves sont disponibles en téléchargement (fichier texte) et visualisables directement dans le navigateur.

🌐 Panel web

En plus des commandes Discord, vous avez accès à un panel web complet pour gérer votre bot.

Fonctionnalités du panel

  • 📊 Dashboard avec statistiques en temps réel
  • ⚠️ Gestion des avertissements
  • 🔨 Gestion des bans
  • 🔇 Gestion des mutes
  • 🎫 Visualisation des tickets
  • 🎁 Gestion des giveaways
  • 🎂 Gestion des anniversaires
  • 👤 Consultation des profils
  • 📜 Gestion de la whitelist/blacklist
  • 📄 Visualisation des logs
  • ⚙️ Configuration générale
🔗 Accès : http://TON_IP:PORT (le port vous a été communiqué)

❓ FAQ

Comment obtenir de l'aide ?

Utilisez la commande /help sur votre serveur Discord ou consultez cette documentation.

Pourquoi certaines commandes ne fonctionnent pas ?

Vérifiez que vous avez les permissions nécessaires (indiquées entre parenthèses dans /help).

Comment configurer les logs ?

Utilisez /config log_channel #salon pour définir le salon où les actions seront loggées.

Le bot ne répond pas aux commandes ?

Vérifiez que le bot est en ligne. Si le problème persiste, contactez votre administrateur.

Comment signaler un bug ?

Contactez le support via le système de tickets ou parlez-en à votre administrateur.