Documentation

Guide de Kaguya

Configuration et utilisation de chaque fonctionnalit\u00e9 du bot.

Anti-Raid

/setantiraid

Modules disponibles

Kaguya propose 8 modules de protection, chacun ciblant un type d'attaque :

-Anti Join-Flood : Bloque les vagues de nouveaux comptes qui rejoignent en masse.
-Anti Spam : Analyse la pression des messages pour bloquer le spam.
-Anti Liens : Supprime les liens et images envoyés en masse.
-Anti Mentions : Bloque les utilisateurs qui mentionnent trop de personnes.
-Filtre de Comptes : Refuse les comptes trop récents ou suspects à l'arrivée.
-Apps Externes : Détecte les abus via les applications tierces.
-Anti Nuke : Empêche la suppression massive de salons et rôles.
-Protection Webhooks : Détecte et supprime les webhooks malveillants.

Configuration

Utilisez /setantiraid pour accéder au tableau de bord. Vous pouvez :

1.Activer/désactiver chaque module individuellement.
2.Choisir la sanction appliquée (Bannissement, Timeout 10 min, ou Blacklist).
3.Définir le salon de logs où toutes les actions seront reportées.

Vérification

/setverify

Fonctionnement

Quand un utilisateur rejoint le serveur, il reçoit automatiquement un rôle "non vérifié" qui limite ses accès. Il doit se vérifier via une page web sécurisée.

Le système vérifie :

- L'identité Discord via OAuth2.

- L'adresse IP pour détecter les VPN et proxys.

- L'empreinte navigateur pour détecter les comptes multiples.

Configuration

Utilisez /setverify pour configurer :

-Rôle vérifié : attribué après vérification réussie.
-Rôle non vérifié : attribué automatiquement à l'arrivée.
-Salon de vérification : où le lien de vérification est envoyé.
-Salon de bienvenue : où la carte de bienvenue est publiée.
-Blocage VPN/Proxy : refuser les connexions suspectes.
-Vérification fingerprint : détecter les doubles comptes.

Invitations

/setinvites

Tracking des invitations

Kaguya suit chaque invitation utilisée sur votre serveur. Quand un membre rejoint, le bot détecte automatiquement quel lien d'invitation a été utilisé et par qui.

Chaque inviteur accumule des statistiques :

-Régulières : invitations ayant amené un membre.
-Départs : membres invités qui ont quitté.
-Fausses : comptes trop récents (seuil configurable).
-Bonus : invitations ajoutées manuellement.

Formule : Total = Régulières - Départs - Fausses + Bonus

Commandes

-/invites [utilisateur] : Affiche les statistiques d'invitations.
-/leaderboard : Classement des 10 meilleurs inviteurs.
-/setinvites : Activer/désactiver le tracking, configurer le seuil anti-fake et le salon de logs.

Détection anti-fake

Le système détecte automatiquement les comptes créés récemment. Par défaut, un compte de moins de 3 jours est considéré comme suspect. Ce seuil est configurable via /setinvites.

Sauvegardes

/setbackup

Sauvegardes automatiques

Kaguya crée automatiquement une sauvegarde toutes les 6 heures, incluant :

- Tous les rôles (noms, couleurs, permissions, positions).

- Tous les salons (texte, vocal, catégories, permissions).

- La structure hiérarchique complète.

Maximum 14 sauvegardes conservées (environ 3.5 jours d'historique).

Configuration

Utilisez /setbackup pour :

1.Activer/désactiver les sauvegardes automatiques.
2.Créer une sauvegarde immédiatement.
3.Restaurer une sauvegarde précédente (sélection par date).

Bannissement

/ban

Utilisation

La commande /ban permet de bannir un utilisateur avec des options avancées :

-Utilisateur : l'utilisateur à bannir (obligatoire).
-Raison : motif du bannissement (obligatoire).
-Durée : temporaire (1h, 6h, 12h, 1j, 7j, 30j) ou permanent.
-Supprimer les messages : effacer les messages récents (1h, 6h, 12h, 24h).

Un DM est envoyé au banni avec la raison et un lien d'appel.

Système d'appel

Les utilisateurs bannis peuvent soumettre un appel via une page web dédiée. L'appel est envoyé aux modérateurs qui peuvent l'accepter ou le refuser directement depuis Discord.

Le lien d'appel est unique et sécurisé par un token. Un seul appel autorisé par bannissement.

Tickets

/setticket

Fonctionnement

Le système de tickets utilise les fils privés Discord. Quand un utilisateur crée un ticket, un fil privé est créé dans le salon configuré avec un message d'introduction et un bouton de fermeture.

Les avantages des fils :

- Pas de pollution de salons.

- Archivage automatique après fermeture.

- Permissions héritées du salon parent.

Commandes

-/ticket <sujet> : Ouvrir un nouveau ticket avec un sujet.
-/ticket fermer:true : Fermer le ticket depuis le fil.
-/setticket : Configurer le salon, le rôle staff et le salon de logs.

Un seul ticket ouvert par utilisateur. La fermeture archive et verrouille le fil.

Commandes

Utilitaire

-/help : Liste des commandes groupées par catégorie.
-/ping : Vérifie la latence du bot.
-/userinfo [utilisateur] : Informations détaillées d'un utilisateur.
-/stats : Statistiques du bot (serveurs, membres, système).
-/verifyinfo <utilisateur> : Données de vérification d'un utilisateur.

Modération

-/prune <nombre> : Supprimer des messages en masse avec filtres avancés.
-/ban <utilisateur> <raison> : Bannissement avancé avec système d'appel.

Configuration (Administrateur)

-/setantiraid : Modules anti-raid.
-/setverify : Système de vérification.
-/setbackup : Sauvegardes automatiques.
-/setinvites : Tracking d'invitations.
-/setticket : Système de tickets.