Documentation Complète - Miaouscle Bot

🚀 Démarrage Rapide

Mettez votre bot en place en 3 étapes simples:

Étape 1: Ajouter le Bot

Utilisez ce lien pour ajouter Miaouscle Bot à votre serveur Discord:

Étape 2: Configurer le Bot

La commande /config vous redirigera directement vers notre dashboard web ultra-rapide pour une synchronisation en temps réel.

Étape 3: Tester le Bot

Utilisez la commande /ping pour vérifier que le bot répond

⚙️ Configuration Complète

Le Dashboard vous permet de configurer tous les aspects du bot. Voici ce que vous pouvez faire:

🌍 Onglet Général

Configurez les paramètres généraux de votre serveur:

Langue: Choisissez entre Français, Anglais, Espagnol et Allemand
Rôle Booster XP: Rôle qui reçoit 2x l'XP (pour les boosters du serveur)
Canal XP: Canal où les montées de niveau sont annoncées
Réinitialiser: Réinitialise tous les paramètres aux valeurs par défaut

💡 En haut de la page, un badge indique le tier du serveur (🆓 Free / 💎 Premium / 👑 Premium+). Le Premium s'achète et s'active par serveur — il bénéficie alors à tous les membres et tous les admins de ce serveur.

💬 Onglet Messages

Personnalisez les messages du bot:

Canal Bienvenue: Où envoyer les messages de bienvenue
Message Bienvenue: Message personnalisé pour les nouveaux membres
Canal/Message Au Revoir: Annonce quand un membre quitte
Demande Pseudo: Canal pour les demandes de pseudo

💎 Premium débloque la personnalisation embed (titre, couleur, image/GIF, footer, ping du membre) pour la bienvenue ET le départ.
👑 Premium+ débloque en plus le MP de bienvenue automatique avec message personnalisé.

🛡️ Onglet Sécurité

Modération automatique et protection contre les raids:

AutoMod: Activer/désactiver, action (warn/mute/kick/ban), durée du mute (gratuit)
Détection AutoMod: Spam, majuscules excessives, invitations (gratuit)
💎 Anti-Raid: Détecte les arrivées massives de comptes suspects (Premium)
💎 Anti-Raid - Seuil & Fenêtre: X arrivées en Y secondes déclenchent l'alerte
💎 Anti-Raid - Âge minimum: Comptes plus jeunes que ce nombre de jours sont considérés comme suspects
💎 Anti-Raid - Action: Lockdown du serveur, Kick ou Ban des suspects
💎 Anti-Raid - Canal d'alerte: Canal où les alertes sont envoyées

💎 L'Anti-Raid est une fonctionnalité Premium : la card est verrouillée sur les serveurs Free et le bot ignore la config anti-raid au runtime sans Premium actif.

📍 Onglet Logs

Enregistrement des événements modération:

Canal Logs: Où envoyer les logs
9 Types Configurables: Bannissements, Expulsions, Avertissements, etc.
Confirmation: Confirmez avant chaque action importante
Horodatage: Tous les logs incluent la date/heure

🌐 Dashboard Web

Le Dashboard est votre centre de contrôle pour gérer le bot facilement:

🔐

OAuth2 Sécurisé

Connectez-vous avec votre compte Discord en toute sécurité

⚡

Ultra Rapide

Interface performante avec mises à jour en temps réel

📱

Responsive

Fonctionne parfaitement sur mobile et ordinateur

🎨

Élégant

Design moderne avec gradient Discord

🔧

Complet

Tous les paramètres du bot en un seul endroit

📊

Statistiques

Consultez les statistiques de votre serveur

✨ Fonctionnalités Principales

✅ Configuration per-serveur isolée
✅ Listes déroulantes dynamiques (serveurs, rôles, canaux)
✅ Embeds identiques: Bot + Web
✅ Synchronisation 100% avec les commandes Discord
✅ Page statut en temps réel
✅ Gestion des logs avancée

🎯 Système de Niveaux (XP)

Miaouscle Bot dispose d'un système de niveaux automatique et flexible:

Comment ça marche?

Les membres gagnent de l'XP automatiquement en envoyant des messages
1 message = 15 XP par défaut (configurable)
Les niveaux montent selon la formule de Mee6 (exponentielle)
Une carte de niveau personnalisée est générée à chaque montée
Annonce dans le canal configuré

Formule de Progression

XP nécessaire = 5 × (Niveau³ + 15 × Niveau² + 10 × Niveau)

Exemple

Niveau 1 → 2: ~100 XP
Niveau 5 → 6: ~1,500 XP
Niveau 10 → 11: ~8,500 XP

🛡️ Sécurité (AutoMod & Anti-Raid)

Outils de modération automatique et de protection contre les raids pour maintenir votre serveur propre et sécurisé:

Ce que détecte l'AutoMod

🔁 Spam: Messages répétés rapidement
🔤 Majuscules excessives: Plus de 50% en majuscules
🔗 Invitations: Liens d'invitations non autorisées
📝 Messages trop longs: Flood de texte
🚫 Mentions excessives: @everyone, @here

Actions Possibles

Action	Effet
Supprimer	Message supprimé silencieusement
Avertir	Message supprimé + notification
Mute	Message supprimé + Mute automatique

✅ Conseil: Vous pouvez créer des channels/rôles whitelist pour que l'automod ne les affecte pas.

💎 Premium & 👑 Premium+

Miaouscle propose deux niveaux d'abonnement pour débloquer des fonctionnalités exclusives. Le Premium est lié à un serveur Discord — une fois activé, tous les membres et admins de ce serveur en profitent. Il faut un abonnement par serveur.

💎 Premium

Personnalisation visuelle complète des messages de bienvenue et de départ.

🎨 Titre d'embed personnalisé (Bienvenue & Départ)
🎨 Couleur de l'embed (sélecteur de couleur)
🖼️ Image / GIF de fond dans l'embed
📝 Footer personnalisé
🔔 Ping automatique du membre dans le message
✅ Tout cela aussi pour le message de départ
🛡️ Anti-Raid complet (seuil, fenêtre, âge minimum, action lockdown/kick/ban, canal d'alerte)

👑 Premium+

Tout le Premium, plus des fonctionnalités d'engagement avancées.

✅ Tout le Premium inclus
📨 MP de bienvenue automatique à chaque nouveau membre
📝 Message MP personnalisé avec variables {user}, {username}, {guild}, {count}
🎁 Activation/désactivation indépendante du MP

🔍 Comment savoir si un serveur est Premium ?

Sur le Dashboard, sélectionne un serveur : un badge en haut affiche le tier du serveur (🆓 Free / 💎 Premium / 👑 Premium+).
Le Premium est lié au serveur (pas à un compte utilisateur). Une fois activé, tous les membres et admins du serveur en profitent.
Les sections Premium sont toujours visibles sur le dashboard, mais grisées avec un encart d'invitation si le serveur n'a pas le tier requis.

🛡️ Sécurité du gating Premium

Si tu modifies le HTML du dashboard pour forcer l'édition d'un champ Premium sans avoir le tier requis, le serveur API rejette silencieusement ces clés et n'enregistre rien. Le statut Premium est l'autorité côté serveur, pas le navigateur.

💎 Découvrir les offres Premium

❓ Questions Fréquemment Posées (FAQ)

Comment ajouter le bot à mon serveur? ▼

Cliquez sur le lien d'invitation en haut du dashboard, sélectionnez votre serveur, puis autorisez les permissions. Le bot doit avoir les permissions administrateur pour fonctionner correctement.

Le bot ne répond pas, que faire? ▼

Vérifiez que: 1) Le bot est en ligne, 2) Le bot a les permissions nécessaires, 3) Testez avec /ping, 4) Vérifiez les logs du serveur. Si le problème persiste, utilisez /report pour signaler le bug.

Comment configurer les messages personnalisés? ▼

Allez sur le Dashboard, onglet "Messages", et remplissez les champs. Vous pouvez utiliser des variables comme {user}, {username}, {guild}, {count}. Les modifications s'appliquent immédiatement.

Puis-je réinitialiser la configuration? ▼

Oui! Allez sur l'onglet "Général", puis cliquez sur "Réinitialiser Configuration". Tous les paramètres reviennent aux valeurs par défaut. Cette action est irréversible.

Comment programmer une maintenance? ▼

Allez sur le Dashboard, onglet "Maintenance", sélectionnez l'heure et la durée, puis cliquez sur "Programmer". Le bot lancera automatiquement la maintenance à l'heure prévue et l'arrêtera après la durée configurée.

Le XP ne monte pas, pourquoi? ▼

Vérifiez que: 1) L'automod n'a pas muté l'utilisateur, 2) Le système XP est activé, 3) L'utilisateur écrit des vrais messages (pas de spam). Un message = 1 XP, les bots n'obtiennent pas d'XP.

Quels canaux ont besoin des permissions spéciales? ▼

Le canal de bienvenue, le canal de logs, et le canal XP doivent tous être accessibles au bot. Assurez-vous que le bot a les permissions "Voir le canal" et "Envoyer des messages" dans chaque canal.

Comment contacter le support? ▼

Utilisez la commande /support dans Discord ou visitez notre page support. Vous pouvez aussi signaler un bug avec /report ou proposer une suggestion avec /suggestion.

🆘 Support & Contact

Besoin d'aide? Voici comment nous contacter:

🐛

Signaler un Bug

Utilisez /report dans Discord ou notre serveur support

💡

Proposer une Idée

Utilisez /suggestion pour proposer une amélioration

📞

Support Direct

Rejoindre le serveur Discord

✅ Réponse Rapide: Nous répondons généralement en moins d'une heure! Cliquez ici pour accéder au support

🚀 Bienvenue sur Miaouscle Bot